add standart

This commit is contained in:
2026-10-01 13:03:14 +07:00
parent 413c2d4497
commit 76af14cb96
2 changed files with 282 additions and 17 deletions
+7 -17
View File
@@ -9,26 +9,16 @@
- S3-совместимое хранилище для файлов;
- MCP встроен в основной сервис.
## Структура
## Стандарт Go-кода
- `api/` — protobuf-контракт;
- `proto/` — сгенерированный Go-код;
- `internal/app/` — gRPC/HTTP handlers;
- `internal/services/` — бизнес-логика;
- `internal/repos/` — работа с PostgreSQL;
- `internal/modules/` — переиспользуемые модули;
- `migrations/` — миграции базы данных.
[`docs/GO_STANDARD.md`](docs/GO_STANDARD.md) — единственный источник правил
написания Go-кода. Для задач, затрагивающих Go-бэкенд, соблюдай его требования.
## Правила
## Проектные ограничения
1. Сначала найди всех callers изменяемой функции и существующий паттерн.
2. Делай минимальное изменение; каждый модуль разделяй на интерфейс и реализацию.
3. Бизнес-логику держи в services, SQL — в repos, транспорт — в app.
4. Новые HTTP-методы добавляй через `api/main.proto` и регенерируй код.
5. `proto/` и Swagger — сгенерированные файлы; руками их не редактируй.
6. Изменения схемы БД оформляй отдельной миграцией, совместимой с предыдущей версией.
7. Не добавляй `.env`, ключи, пароли или локальные артефакты в Git.
8. Коммиты и push выполняет только пользователь; агент никогда не коммитит и не отправляет изменения.
- Не добавляй `.env`, ключи, пароли или локальные артефакты в Git.
- Коммиты и push выполняет только пользователь; агент никогда не коммитит и не
отправляет изменения.
## Проверки