speckit: внедрение Spec Kit и фиксация архитектуры в конституции JT4D v1.0.0
CI / Сборка (push) Failing after 5s
CI / Деплой на стейджинг (push) Skipped
CI / Проверка кода (push) Skipped
CI / Документация (push) Skipped

- Интеграция 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>
This commit is contained in:
arswarog committed 2026-11-10 16:37:50 +03:00
1 parent 1d80630fb2
commit 7c60482467
55 files changed
+6070 -415

No files matched your search

+10 -10
View File
@@ -200,7 +200,7 @@ staging-db-postgres create <org/project> <branch>
## Применение на проде
Job `deploy-production` в `.gitea/workflows/production.yaml`, шаг `Deploy via SSH` — тот же
`jt4d-lab/ssh-action`, что и на стейджинге, плюс `workdir: /srv/geo-platform` и
`jt4d-lab/ssh-action`, что и на стейджинге, плюс `workdir: /srv/jt4d` и
`files: docker-compose.production.yml`: компоуз-файл приезжает тем же шагом, отдельного `scp` нет.
Порядок:
@@ -219,7 +219,7 @@ Job `deploy-production` в `.gitea/workflows/production.yaml`, шаг `Deploy vi
поднимает HTTP-слой NestJS, а `migration:run` идёт отдельным процессом со своим соединением через
`data-source.js`.
Логи приложения при провале смотрятся на хосте: `docker logs geo-platform_api --tail 50`.
Логи приложения при провале смотрятся на хосте: `docker logs jt4d_api --tail 50`.
⚠️ `migration:show` — не безобидная команда «только посмотреть»:
@@ -280,7 +280,7 @@ runbook отката.
```bash
ssh <prod>
docker exec geo-platform_api node_modules/.bin/typeorm migration:show -d data-source.js
docker exec jt4d_api node_modules/.bin/typeorm migration:show -d data-source.js
```
`[X]` — применена, `[ ]` — нет. Этот вывод — источник истины, а не лог job.
@@ -296,7 +296,7 @@ runbook отката.
`docker images git.jt4d.ru/jt4d/jt4d/api`:
```bash
cd /srv/geo-platform
cd /srv/jt4d
VERSION=<prev> docker-compose up -d
```
@@ -308,7 +308,7 @@ runbook отката.
старый код несовместим с новой схемой, откатывать схему придётся отдельно (`migration:revert`,
по одной миграции за вызов) или восстанавливать из ручного дампа.
5. **Проверить результат:** `/api/health` и `docker logs geo-platform_api --tail 100`.
5. **Проверить результат:** `/api/health` и `docker logs jt4d_api --tail 100`.
## Ручной запуск миграций на проде
@@ -320,13 +320,13 @@ runbook отката.
ssh <prod>
# посмотреть, что применится
docker exec geo-platform_api node_modules/.bin/typeorm migration:show -d data-source.js
docker exec jt4d_api node_modules/.bin/typeorm migration:show -d data-source.js
# применить
docker exec geo-platform_api node_modules/.bin/typeorm migration:run -t each -d data-source.js
docker exec jt4d_api node_modules/.bin/typeorm migration:run -t each -d data-source.js
# откатить последнюю применённую (по одной за вызов)
docker exec geo-platform_api node_modules/.bin/typeorm migration:revert -d data-source.js
docker exec jt4d_api node_modules/.bin/typeorm migration:revert -d data-source.js
```
Перед запуском учтите, что автоматического бэкапа нет (см. выше).
@@ -345,8 +345,8 @@ Api ходит в прод-БД под `aigeo_app` — это не владел
TypeORM `--fake` / `-f` (`MigrationRunCommand`, `MigrationExecutor`):
```bash
docker exec geo-platform_api node_modules/.bin/typeorm migration:show -d data-source.js # сначала посмотреть список
docker exec geo-platform_api node_modules/.bin/typeorm migration:run --fake -d data-source.js
docker exec jt4d_api node_modules/.bin/typeorm migration:show -d data-source.js # сначала посмотреть список
docker exec jt4d_api node_modules/.bin/typeorm migration:run --fake -d data-source.js
```
`--fake` вставляет записи в таблицу `migrations`, не выполняя `up()`. Он применяется ко **всему**