Mise: project-local toolchain bootstrap (Linux + Windows)
PR checks / web (pull_request) Successful in 44s
PR checks / java (pull_request) Successful in 1m1s
Main: tests, deploy, autotests / web (push) Successful in 41s
Main: tests, deploy, autotests / java (push) Successful in 56s
Main: tests, deploy, autotests / images-app (push) Successful in 42s
Main: tests, deploy, autotests / images-web (push) Successful in 1m5s
Main: tests, deploy, autotests / deploy (push) Successful in 1m32s
Main: tests, deploy, autotests / autotests (push) Successful in 1m18s
Main: tests, deploy, autotests / rollback (push) Has been skipped

Корневой mise.toml пинит java temurin-17, maven 3.9.16, node 24, python 3.15
и задачи (verify/app-package/app-run/web-*/prod-tests); bootstrap.sh/.ps1
скачивают mise v2026.10.19 в ./.mise/bin (gitignored, вне системы); обёртки
mise.sh/.ps1 зовут его без PATH/активации шелла. prod-autotests/mise.toml
удалён — дубль корневого (venv тем же путём). AGENTS.md синхронизирован.
This commit was merged in pull request #51.
This commit is contained in:
Pjandro
2026-10-25 20:00:51 +00:00
parent 922bc915ba
commit ddb41ab620
8 changed files with 107 additions and 7 deletions
+4 -2
View File
@@ -62,12 +62,14 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|корневой `.env.example`|шаблон env для локальных/compose-стендов: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает binding long/int); проду `.env` **не нужен**: ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables, legacy-`.env` на проде удаляется деплоем|
|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты + coverage-сводка и комментарий в PR → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)|
|корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений|
|корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 21 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`|
|корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 21 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise корневого `mise.toml` (python 3.15 + автосоздаваемый `.venv`; прод-тесты: `./mise.sh run prod-tests`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`|
|`docs/standards/`|нормативная документация OOXML: PDF+md ECMA-376 Part 1 (5-е изд.), md [MS-OI29500]/[MS-ODRAWXML], полные наборы XSD `schema/strict/`+`schema/transitional/` — источник истины для chart-движка и фикстур (правило — в секции «Chart-движок»); `validate-fixtures.py` — XSD-валидация `samples/*.docx` (lxml); регенерация — `docs/standards/README.md`|
|`develop/` (вне git, gitignored)|рабочие материалы и эталоны сравнения рендера (скриншоты `original.jpg`/`converted.jpg`) — **не фикстуры**, в тесты/jar не подключать; пиксельные замеры зашиты числами в chart-тестах|
## Development Commands
Перед первой сборкой — бутстрап toolchain: скачивает сам mise в `./.mise/bin` (gitignored, в систему ничего не ставится) и ставит инструменты из корневого `mise.toml` — Linux/macOS `sh bootstrap.sh`, Windows `powershell -ExecutionPolicy Bypass -File .\bootstrap.ps1`. `mvn`/`npm`/`python`/`java` из команд ниже берутся из project-local mise: запуск `./mise.sh exec -- mvn clean verify` (Windows `.\mise.ps1 exec -- …`) либо активация шелла `eval "$(./.mise/bin/mise activate bash)"`; готовые задачи — `./mise.sh run verify|app-package|app-run|web-install|web-build|web-lint|web-dev|prod-tests`. Контейнерные/compose-команды не меняются.
```bash
mvn clean verify # все модули + тесты + PMD (pmd-ruleset.xml) + гейты JaCoCo: 90% строк (оба модуля) и 85% веток (core) — обязательный гейт перед push; mvnw НЕТ — только системный Maven
mvn -pl wordpdf-app -am package # исполняемый jar бэкенда
@@ -144,7 +146,7 @@ gateway). Кеш раннеров — сервер act_runner (серверна
## Runtime & Tooling Preferences
- Java 17 + Maven (обязательны; wrapper `mvnw` нет); UTF-8. Только Maven — никакого Gradle/Ant.
- Java 17 + Maven (обязательны; wrapper `mvnw` нет); UTF-8. Только Maven — никакого Gradle/Ant. Java/Maven/Node/Python для локальной разработки ставит project-local mise (бинарь в `.mise/`, вне системы; кеш инструментов — user-директория mise по умолчанию), версии пинятся в корневом `mise.toml`, ежедневный запуск — `./mise.sh` / `.\mise.ps1` (см. Development Commands).
- Версии зависимостей — только в корневом `pom.xml` (properties + dependencyManagement); новые зависимости — latest stable.
- Фронт: Node `^20.19.0 || >=22.12.0` (engines vite/rolldown/oxlint из `package-lock.json` — в `package.json` секции `engines` нет; 21.x и 22.0–22.11 НЕ поддерживаются), npm с закоммиченным `package-lock.json` (`npm ci`); vite `^8.3`, React `^19.2`, TS `~6.0` (**`strict` нигде не включён** — `npm run build` не является strict-гейтом), Tailwind `^4.3`, oxlint `^1.81`; podman-сборка web на `node:24-alpine`.
- Контейнеры (podman/buildah): `FROM` только FQDN (`docker.io/library/...` — short-name не резолвится без `unqualified-search-registries`); buildah подмешивает хостовые прокси-переменные в `RUN`/`HEALTHCHECK` — обнулять `HTTP_PROXY= http_proxy= …` **на самой команде** (ENV не перебивает).