Документация специально сведена к короткому набору канонических файлов, чтобы человек и LLM не тратили время на чтение пересекающихся описаний одной и той же идеи.
- LLM Onboarding — главный обзор проекта: цель, структура, инварианты, зоны риска.
- Карта reusable-блоков — что именно является reusable core шаблона, а что является optional или example.
- Поток запроса — как запрос проходит через runtime и middleware.
- Protobuf и генерация кода — как устроен transport-contract слой и codegen.
- Инфраструктура и тестирование — PostgreSQL, Redis, миграции, quality gates и test profiles.
- Рекомендации по
protoc-php-gen— правила для endpoint-oriented protobuf codegen. protoc-php-genкак продукт — текущий supported scope и целевая modular model генератора.sql-genкак продукт — целеваяsqlc-likeмодель для typed SQL generation.Platform/Http/Clientкак продукт — целевая модель outbound HTTP client с reliability policy.
- Если нужен общий контекст, начинать с
llm-onboarding.md. - Если нужно понять, какие части проекта реально составляют шаблон, читать
reusable-blocks.md. - Если нужно понять runtime, читать
architecture/request-lifecycle.md. - Если меняется API surface, читать
architecture/protobuf-and-codegen.md. - Если меняется persistence direction и SQL toolchain, читать
design/sql-gen-product.md. - Если меняется outbound HTTP policy или внешние интеграции, читать
design/http-client-product.md. - Если меняется storage, cache, миграции или тестовый контур, читать
development/infrastructure-and-testing.md.
- Источник истины для core API template —
protos/proto/app/v1. - Сгенерированные артефакты нельзя редактировать вручную.
Platformдолжен оставаться маленьким runtime core.Capabilitiesдолжны оставаться простыми reusable-блоками.- Нейтральный
HealthCheckостаётся минимальным живым примером protobuf-first endpoint flow. - Для persistence целевым направлением считается explicit SQL с typed generation поверх него, а не усложнение ORM-like abstractions.