Kit.Db/docs/structure-diagram.md

103 lines
4.5 KiB
Markdown

# 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/ ─────────────► Документация