speckit: внедрение Spec Kit и фиксация архитектуры в конституции JT4D v1.0.0
- Интеграция 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:
1 parent
1d80630fb2
commit
7c60482467
55 files changed
+6070
-415
No files matched your search
@@ -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()`. Он применяется ко **всему**
|
||||
|
||||
Reference in new issue
Block a user