Kit.Db/docs/structure-diagram.md

Kit.Db — Структура проекта (ASCII)

Kit.Db/
│
├── rules/                          # Правила для LLM по движкам
│   ├── common/                     #   Общие правила для всех СУБД
│   │   └── ...
│   ├── pg/                         #   Правила PostgreSQL
│   │   └── db-project-rule.md
│   └── sqlite/                     #   Правила SQLite
│       └── db-project-rule.md
│
├── skills/                         # LLM промпты (описания таблиц, функций)
│   └── ...
│
└── projects/                       # Проекты БД
    │
    ├── pg/                         # ── PostgreSQL проекты ──
    │   │
    │   └── kit_auth_pg/            # Проект: БД авторизации
    │       │
    │       ├── readme.md           # Описание БД
    │       │
    │       ├── settings/           # Настройки подключения
    │       │   └── connection.json
    │       │
    │       ├── auth/               # Модуль: авторизация
    │       │   ├── tables/         #   DDL таблиц
    │       │   │   ├── user.psql
    │       │   │   ├── cabinet.psql
    │       │   │   └── user_cabinet.psql
    │       │   │
    │       │   ├── functions/      #   SQL функции
    │       │   │   ├── user_select_by_ids/
    │       │   │   │   └── user_select_by_ids.psql
    │       │   │   └── user_create/
    │       │   │       └── user_create.psql
    │       │   │
    │       │   ├── scripts/        #   Произвольные скрипты
    │       │   │   └── seed_roles.sql
    │       │   │
    │       │   ├── init/           #   Инициализация
    │       │   │   └── create_schema.psql
    │       │   │
    │       │   ├── deploy/         #   Миграции
    │       │   │   ├── 2026-07-08_user-select-by-ids.sql
    │       │   │   └── 2026-07-09-user-seed-merge.sql
    │       │   │
    │       │   ├── auth.psql       #   Точка входа модуля
    │       │   └── auth.post-deploy.psql
    │       │
    │       └── _docs/              # Документация проекта
    │           ├── diagrams/
    │           ├── openapi.yaml
    │           └── architecture.md
    │
    └── sl3/                        # ── SQLite проекты ──
        │
        └── kit_example_sl3/        # Проект: пример
            │
            ├── readme.md
            ├── settings/
            │   └── connection.json
            │
            ├── main/               # Модуль: основной
            │   ├── tables/
            │   ├── scripts/
            │   ├── init/
            │   ├── deploy/
            │   └── main.sql
            │
            └── _docs/
                ├── diagrams/
                ├── openapi.yaml
                └── architecture.md

---

Связи между уровнями

rules/ ──────────► LLM использует при формировании проектов
  common/              │
  pg/                  │
  sqlite/              ▼
                   projects/
                     pg/ ─── PostgreSQL проекты
                     sl3/ ── SQLite проекты

skills/ ─────────► LLM использует при генерации описаний

projects/{engine}/{project}/
  readme.md ──────────► Описание БД
  settings/ ──────────► Подключение
  {module}/ ──────────► SQL исходники
    tables/ ──────────► DDL таблиц
    functions/ ───────► SQL функции (только PG)
    scripts/ ─────────► Произвольные SQL
    init/ ────────────► Инициализация
    deploy/ ──────────► Миграции
  _docs/ ─────────────► Документация