63 lines
4.1 KiB
Markdown
63 lines
4.1 KiB
Markdown
|
# Knowledge Base Index
|
|||
|
|
|
|||
|
|
Полный индекс базы знаний проекта Pinecore. Все файлы в этой директории коммитятся в репозиторий.
|
|||
|
|
|
|||
|
|
## Быстрая навигация
|
|||
|
|
|
|||
|
|
| Что нужно | Файл |
|
|||
|
|
|-----------|------|
|
|||
|
|
| Я только что открыл проект | [`architecture/overview.md`](architecture/overview.md) |
|
|||
|
|
| Как поднять worker / запустить? | [`development/commands.md`](development/commands.md) |
|
|||
|
|
| Какой паттерн использовать? | [`development/patterns.md`](development/patterns.md) |
|
|||
|
|
| Commit/branch/namespace conventions | [`development/conventions.md`](development/conventions.md) |
|
|||
|
|
| Как отладить локально | [`development/testing.md`](development/testing.md) |
|
|||
|
|
| Ядро, Config, Environment, ContainerFactory | [`architecture/bootstrap.md`](architecture/bootstrap.md) |
|
|||
|
|
| HTTP: Request, Response, Router, Middleware | [`architecture/http.md`](architecture/http.md) |
|
|||
|
|
| Worker и WorkerRunner | [`architecture/worker.md`](architecture/worker.md) |
|
|||
|
|
| Auth (JWT, AuthMiddleware) | [`architecture/auth.md`](architecture/auth.md) |
|
|||
|
|
| Логирование | [`architecture/logging.md`](architecture/logging.md) |
|
|||
|
|
| ORM (MongoDB) | [`architecture/orm.md`](architecture/orm.md) |
|
|||
|
|
| Console-команды | [`architecture/console.md`](architecture/console.md) |
|
|||
|
|
| Почему архитектура именно такая | [`decisions/README.md`](decisions/README.md) |
|
|||
|
|
| Контекст текущей задачи | [`tasks/active/`](tasks/active/) |
|
|||
|
|
|
|||
|
|
## Структура директории
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
.claude/
|
|||
|
|
├── README.md # Этот файл — индекс
|
|||
|
|
├── architecture/ # Стабильные архитектурные docs
|
|||
|
|
│ ├── overview.md # Обзор системы и жизненный цикл запроса
|
|||
|
|
│ ├── bootstrap.md # Kernel, Config, Environment, ContainerFactory
|
|||
|
|
│ ├── http.md # HTTP слой: Request, Response, Router, Middleware
|
|||
|
|
│ ├── worker.md # Worker entrypoint и WorkerRunner
|
|||
|
|
│ ├── auth.md # Auth: JWT, AuthMiddleware
|
|||
|
|
│ ├── logging.md # Логирование
|
|||
|
|
│ ├── orm.md # ORM: MongoDB, entities, repositories
|
|||
|
|
│ └── console.md # Console-команды
|
|||
|
|
├── development/ # Практика разработки
|
|||
|
|
│ ├── patterns.md # Переиспользуемые code patterns
|
|||
|
|
│ ├── conventions.md # Соглашения: коммиты, ветки, неймспейсы
|
|||
|
|
│ ├── commands.md # Команды запуска и утилиты
|
|||
|
|
│ └── testing.md # Отладка и тестирование
|
|||
|
|
├── decisions/ # Architecture Decision Records (ADR)
|
|||
|
|
│ ├── README.md # Индекс ADR + как писать
|
|||
|
|
│ └── ADR-NNN-*.md
|
|||
|
|
└── tasks/ # Контекст задач (по одному файлу на ветку)
|
|||
|
|
├── _template.md # Шаблон для новой задачи
|
|||
|
|
├── active/ # Активные ветки
|
|||
|
|
└── completed/ # Смерженные задачи
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Правила обновления
|
|||
|
|
|
|||
|
|
**Во время разработки в feature-ветке:**
|
|||
|
|
- Пиши только в `tasks/active/<branch-name>.md` (свой файл)
|
|||
|
|
- Можешь добавить `decisions/ADR-NNN.md` (новый файл — нет конфликтов)
|
|||
|
|
- НЕ трогай `architecture/` и `development/` — только в main
|
|||
|
|
|
|||
|
|
**После мержа в main (интегратор):**
|
|||
|
|
- Читает секцию "Merge Notes" в task-файле
|
|||
|
|
- При необходимости обновляет `architecture/` и `development/`
|
|||
|
|
- Перемещает: `tasks/active/<branch>.md` → `tasks/completed/<branch>.md`
|