- Интеграция Spec Kit для pi: команды `/speckit.*`, bash-скрипты и шаблоны в `.specify`
- Конституция JT4D v1.0.0 вместо шаблона: принципы WELD для слоёв web и api, публичный API
директории
- Слои web описаны по методологии WELD и проверяются `eslint-plugin-weld`
- Vitest в api запускает `*.test.ts` рядом с `*.spec.ts`, тесты исключены из сборки приложения
- `yarn.lock` пересобран через `yarn deduplicate`
## Мотивация
Нужно зафиксировать архитектуру проекта в конституции JT4D v1.0.0 и подключить Spec Kit, чтобы
планировать фичи до написания кода.
## Ключевые моменты реализации
- `eslint-plugin-weld` настроен только в `apps/web`: схема слоёв API описана конституцией и
документацией, но линтером пока не проверяется
Reviewed-on: jt4d/jt4d#4
Co-authored-by: Arswarog <arswarog@yandex.ru>
- миграции лежат по модулям в `apps/api/src/<module>/migrations/`; `tools/buildDataSource.ts`
сканирует `apps/api/src/**/migrations/` и генерирует список в `apps/api/src/migrations.ts`
- `deploy-staging` накатывает миграции шагами `migration:show` и `migration:run -t each`
- стенды получают маршрутизацию через лейблы `caddy` и `caddy.reverse_proxy`, web-образ стенда
собирается с `CADDYFILE=Caddyfile.staging`
## Мотивация
Миграции нужно накатывать на стендах автоматически и держать рядом с модулем, которому они
принадлежат, а деплой — сводить к одному шагу, который сам копирует компоуз-файл на хост и выполняет
скрипт.
## Ключевые моменты реализации
- `Caddyfile.staging` слушает `:80` без хостового матчера и HTTPS: имена стендов динамические,
маршрутизацию и TLS берёт внешний caddy-docker-proxy по лейблам
Reviewed-on: jt4d/jt4d#2
Co-authored-by: Arswarog <arswarog@yandex.ru>
deploy-staging создаёт роль и БД ветки через staging-db-postgres до
docker compose up, cleanup.yaml удаляет их при удалении ветки (гасит
стек раньше, иначе DROP DATABASE не пройдёт). POSTGRES_* в compose
читаются из .env, куда инструмент пишет доступы.
Попутно: DEPLOY_URL стенда из env и в summary, версия сборки — ветка и
короткий sha, в проде APP_VERSION берётся из VERSION, health в Caddyfile
одной строкой.
Логгер на pino + nestjs-pino вместо стандартного ConsoleLogger: уровни
trace…fatal, details объектом, человекочитаемый вывод в dev и JSON в
проде,
автоматические HTTP-логи (reqId, url, statusCode, responseTime). Для
тестов —
LocalLoggerModule.forTesting() со своим TestingLogger и матчерами.
Документация по логированию — в docs/55-logging.
Порядок импортов в app.module, app.controller, typeorm.config и web-файлах,
пустая строка перед комментарием в styles.css, prettier в
.github/workflows/ci.yml. Каталог .agents исключён из prettier: это
сгенерированные файлы Nx, они перезаписываются инструментом.
- apps/api: @nestjs/swagger, @nestjs/terminus, typeorm, dotenv и pg
объявлены
зависимостями — без них api не собирался и не стартовал; pg убран из
devDependencies корня, lodash и @types/multer объявлены там же
- список миграций генерируется и для пустой директории migrations/:
иначе
api:build падал на db-migrations-list
- vitest/globals в types (web) и импорт expect в e2e-спеке: падал
typecheck
- yarn.lock приведён в соответствие с package.json: без этого не
проходит
yarn install --frozen-lockfile в CI и при сборке образа api
DataSource для CLI, генерация статического списка миграций для webpack,
отдельная сборка
data-source.js для деплоя, скрипты снимка и восстановления данных БД.
Каркас воркспейса: конфигурация Nx и TypeScript, манифест yarn
workspaces, EditorConfig,
параметры docker-сборки и инструкции со скиллами для ИИ-агентов
(AGENTS.md).