diff --git a/.gitignore b/.gitignore index f2768c4..d684903 100644 --- a/.gitignore +++ b/.gitignore @@ -24,6 +24,9 @@ Thumbs.db # Секреты деплоя .env +# Прод-координаты (файл живёт в /home/pjandro/prod/java-word-pdf/DEPLOY.md, вне репо) +DEPLOY.md + # Индекс CodeGraph .codegraph/ diff --git a/AGENTS.md b/AGENTS.md index dd5c241..6cab704 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -54,7 +54,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`). `ChartSpec.parse` (`enum Typ |`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API: `WordPdfApplication`, `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`| |`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): компоненты в `components/`, вся сеть в `api.ts`| |корневые `Dockerfile`, `docker-compose.yml`, `docker-compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage, temurin-21); compose app+web+gateway| -|корневой `.env.example`|шаблон env: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_BYTES`/`WORDPDF_MAX_PAGES`; реальный прод `.env` — в `PROD-DIR/`| +|корневой `.env.example`|шаблон env: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_BYTES`/`WORDPDF_MAX_PAGES`; реальный прод `.env` — на прод-сервере (координаты: `/home/pjandro/prod/java-word-pdf/DEPLOY.md`, вне репо)| |`develop/` (вне git)|рабочие материалы и эталоны Word 365 (`word.docx`+`word.pdf`, `word-export.*`, `diff/`) — **ручное сравнение, не фикстуры**, в тесты/jar не подключать| ## Development Commands @@ -79,7 +79,7 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \ ru.pjandro.wordpdf.SampleDocxGenerator wordpdf-core/src/test/resources/samples ``` -Деплой. **Прод** — каталог `PROD-DIR` (вне репо; проект `wordpdf-prod`, образы `*:prod`, build-context'ы указывают в репозиторий → пересборка берёт **рабочее дерево**, незакоммиченные правки поедут в прод): gateway только на `PROD-HOST:9010` (LAN), ключ — `.env` прод-каталога (fail-closed `${WORDPDF_API_KEY:?…}`), springdoc выключен env'ами, SPA собрана с `VITE_BASE=/pdf-converter/`, свой `nginx.conf` = репозиторный + `proxy_read_timeout 300s` (дефолтные 60 с рвут длинные конвертации). Наружный вход `https://pjandro.ru/pdf-converter/` (внешний nginx PROD-HOST). **Dev-стенд** — из репо `docker-compose.dev.yml` (проект `wordpdf-dev`, :9011, пустой ключ). Репозиторный `docker-compose.yml` — третий вариант (проект `wordpdf`, `9010:80` на все интерфейсы, `VITE_BASE` не передаётся). Перезапуск прода — `./restart.sh` в прод-каталоге: без флага `restart app web` → гейт healthy `app` (до 120 с) → `restart gateway`; `--build` — `up -d --build`. Gateway всегда последним (nginx кэширует DNS бэкендов — иначе 502). Гейт успешности: `docker compose ps` (3× healthy) + `curl http://PROD-HOST:9010/actuator/health` → UP. Запуск по просьбе пользователя = прод-стек; dev/`java -jar`/`npm run dev` — внутренняя отладка. +Деплой. **Прод** — на пользовательском LAN-сервере; координаты сервера, каталог, restart-секвенция, ключ и гейты успешности — вне репо: `/home/pjandro/prod/java-word-pdf/DEPLOY.md` (обязательно прочитать перед любым деплоем/перезапуском). Единая точка входа с dev-машины — `/home/pjandro/prod/java-word-pdf/restart.sh` (пробрасывает флаги удалённому скрипту: `--build` — пересборка образов из `origin/main` + перезапуск; без флага — restart контейнеров; предупреждает о не запушенном в `main`). В прод попадает только запушенное в `main` — рабочее дерево на сборку не влияет. Наружный вход `https://pjandro.ru/pdf-converter/`. **Dev-стенд** — из репо `docker-compose.dev.yml` (проект `wordpdf-dev`, :9011, пустой ключ). Репозиторный `docker-compose.yml` — третий вариант (проект `wordpdf`, `9010:80` на все интерфейсы, `VITE_BASE` не передаётся). Запуск по просьбе пользователя = прод-стек; dev/`java -jar`/`npm run dev` — внутренняя отладка. ## Code Conventions & Common Patterns