Commit Graph
17 Commits
Author SHA1 Message Date
arswarog 7c60482467 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>
2026-11-10 16:37:50 +03:00
arswarog 1d80630fb2 ci: перенос миграций к модулям, деплой стендов через jt4d-lab/ssh-action и caddy-лейблы
- миграции лежат по модулям в `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>
2026-10-31 16:13:13 +03:00
arswarog ae812b0dfa ci: отдельная база для каждого стенда
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
одной строкой.
2026-10-29 14:59:51 +03:00
arswarog fc13c66b0d ci: переезд на репозиторий jt4d/jt4d
Имена образов и стендов берутся из github.repository, домен стенда —
*.jt4d.jt4d.ru.net.
2026-10-29 14:23:52 +03:00
arswarog db4eb04092 all: health-проверка api и страница /health в web 2026-10-27 10:44:23 +03:00
arswarog bd6f349dc4 api: логирование через pino
Логгер на pino + nestjs-pino вместо стандартного ConsoleLogger: уровни
trace…fatal, details объектом, человекочитаемый вывод в dev и JSON в
проде,
автоматические HTTP-логи (reqId, url, statusCode, responseTime). Для
тестов —
LocalLoggerModule.forTesting() со своим TestingLogger и матчерами.

Документация по логированию — в docs/55-logging.
2026-10-27 10:44:15 +03:00
arswarog 157d79932a style: привести импорты и формат к правилам линтера
Порядок импортов в app.module, app.controller, typeorm.config и web-файлах,
пустая строка перед комментарием в styles.css, prettier в
.github/workflows/ci.yml. Каталог .agents исключён из prettier: это
сгенерированные файлы Nx, они перезаписываются инструментом.
2026-10-27 10:44:06 +03:00
arswarog 8014a968b7 api: объявить зависимости api и починить сборку
- 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
2026-10-27 10:44:06 +03:00
arswarog dbd5762ecf docs: документация по архитектуре, данным и деплою
Конвенции слоёв api и web, работа с БД и миграциями, тесты, деплой
миграций, а также оглавление документации и README шаблона.
2026-10-27 10:43:49 +03:00
arswarog 9d5478ddeb ci: шаблоны задач Gitea
Шаблоны issue: эпик, user story, задача и баг.
2026-10-27 10:43:49 +03:00
arswarog 7ffba57a13 ci: сборка, деплой и стенды в Gitea Actions
Workflows CI, деплоя на прод и очистки стендов веток, docker-compose для прода и
стейджинга, публикация документации.
2026-10-27 10:43:49 +03:00
arswarog 80808a1e75 api: миграции TypeORM и снимки состояния БД
DataSource для CLI, генерация статического списка миграций для webpack,
отдельная сборка
data-source.js для деплоя, скрипты снимка и восстановления данных БД.
2026-10-27 10:43:49 +03:00
arswarog 94f9b06527 api: приложение NestJS и e2e-тесты
Каркас api: NestJS со сборкой через webpack, health-контроллер с версией
и статусом БД,
Dockerfile, тесты Vitest и e2e-тесты на Jest.
2026-10-27 10:43:43 +03:00
arswarog 94e5e09218 web: приложение React + Vite с Tailwind
Каркас web-приложения: Vite, Tailwind, ESLint, раздача статики через
Caddy, страница со
статусом и версией проекта.
2026-10-27 10:43:38 +03:00
arswarog efba11d83f chore: настройка линтинга, форматирования и проверок
ESLint 9 flat config, Prettier, Stylelint, husky-хуки, lint-staged и nx-таргеты проверок
в корневом project.json.
2026-10-26 20:31:02 +03:00
arswarog 8c368cd68f chore: инициализация Nx-монорепозитория
Каркас воркспейса: конфигурация Nx и TypeScript, манифест yarn
workspaces, EditorConfig,
параметры docker-сборки и инструкции со скиллами для ИИ-агентов
(AGENTS.md).
2026-10-26 20:30:59 +03:00
arswarog 231dd48844 Initial commit 2026-10-26 18:24:11 +03:00