Pjandro
af5d09e001
refactor(core,app): WordPdfSettings упразднён — лимиты входа обязательны в ConvertOptions, пороги производные, REST-параметры maxMb/maxPages
...
PR checks / web (pull_request) Successful in 33s
PR checks / java (pull_request) Successful in 1m18s
- WordPdfSettings удалён; ConvertOptions.defaults() удалён; 2-аргументный
convert и безлимитные оверлоды валидатора сняты (options == null → 400)
- производные пороги (распаковка total/XML, пиксели растра, zip-записи)
считаются из maxMb/maxPages формулами в WordPdfConverter/WordPdfValidator
- мост: DocToDocx.convert(+maxMb) → OfficeArt.read(+maxPixels)
- REST: свойства wordpdf.max-mb/max-pages — дефолт эндпоинта (литералы
@Value 5/100), параметры запроса maxMb/maxPages переопределяют в обе
стороны (≤ 0 → 400); верхний потолок отсутствует (решение пользователя)
- HTTP-контексты тестов пиныт wordpdf.api-key= (mise подмешивает .env)
- доки/README/autotests-формулировки синхронизированы
2026-11-08 20:16:52 +00:00
Pjandro
ab8ea495a8
fix(app): 405/415 вместо catch-all 500; multipart-части на диске; heap в лимит контейнера
...
- ApiExceptionHandler: HttpRequestMethodNotSupportedException → 405,
HttpMediaTypeNotSupportedException → 415 (JSON-контракт {error: …})
- file-size-threshold 100MB→2MB: части > 2 МБ на диск Tomcat, heap держит
только getBytes() одной сериализованной конвертации (раньше каждая
параллельная загрузка буферизовалась в heap до валидации размера)
- Containerfile ENTRYPOINT: -XX:MaxRAMPercentage=70; compose/compose.dev/
прод-рендер: mem_limit: 2g у app
- ConvertController javadoc: ссылки на несуществующий ConversionService#validate нет
- Регрессии — ConvertControllerTest#methodNotSupportedReturns405/badContentTypeReturns415
2026-10-26 00:09:16 +00:00
Pjandro
1e20949a98
refactor: лимит размера входа во всех слоях — MAX_MB (МБ=MiB), байты вычисляются в checkInput
...
PR checks / java (pull_request) Successful in 1m7s
PR checks / web (pull_request) Successful in 43s
Ядро: WordPdfSettings.MAX_INPUT_MB=5, ConvertOptions.maxMb,
WordPdfValidator.checkInput(byte[], long maxMb) — единственная точка
пересчёта МБ→байты, сообщение «Файл больше N МБ: X байт > Y байт».
Приложение: свойство wordpdf.max-mb (env WORDPDF_MAX_MB, relaxed binding).
CI/конфиг/автотесты/доки: WORDPDF_MAX_BYTES → WORDPDF_MAX_MB (значение 5).
2026-10-20 20:34:01 +00:00
Pjandro
45b78f7fc9
core,app,web: дефолты лимитов входа 5 MiB / 100 страниц
2026-10-19 21:30:45 +00:00
Pjandro
65746db9d2
Migrate repo from docker to podman
...
- git mv docker-compose*.yml -> compose*.yml, Dockerfile -> Containerfile
(podman-compose picks compose.yml; buildah finds Containerfile first)
- compose/compose.dev: x-podman.name_separator_compat (dash container
names), explicit app/web healthchecks (OCI export drops image
HEALTHCHECK, depends_on service_healthy would hang forever), fixed
subnet 10.113.0.0/24 gw 10.113.0.1 for the aardvark-dns resolver
- gateway/nginx.conf: resolver + proxy_pass via variables (static
proxy_pass resolves once at start; podman-restart.service brings
gateway up before app -> dead upstream, 502 until manual restart)
- Containerfiles: pin base images to docker.io/library/* (no
unqualified-search-registries on hosts), truthful buildah proxy comments
- comments/docs: Docker HEALTHCHECK -> container HEALTHCHECK; READMEs,
AGENTS.md updated for podman/podman-compose
Verified on dev (podman 5.7.0, podman-compose 1.5.0): stack up with
dash names, app/web healthy, conversion through gateway returns PDF,
gateway survives app container restart without restart (resolver).
2026-10-19 00:13:52 +00:00
Pjandro
c7dec86b54
Fix: Swagger UI/OpenAPI под префиксом /pdf-converter, документация открыта без ключа
...
Прод (наружный nginx срезает /pdf-converter/): springdoc генерировал
абсолютные URL от корня хоста — пути до /v3/api-docs и swagger-ui битые.
server.forward-headers-strategy=framework + X-Forwarded-* (добавляет
наружный nginx) дают server https://pjandro.ru/pdf-converter и configUrl
с префиксом; 'native'-клапан Tomcat X-Forwarded-Prefix не понимает.
ApiKeyFilter: матч по пути без forwarded-contextPath (под префиксным
заголовком getRequestURI() включает префикс — HEALTHCHECK получил бы 401)
+ открытые без ключа /swagger-ui* и /v3/api-docs* (браузер не может
положить ключ в заголовок при загрузке UI; /api/** под ключом).
OpenApiConfig: @SecurityScheme X-API-Key — кнопка Authorize в UI,
@SecurityRequirement на convert — «Try it out» с ключом.
springdoc.swagger-ui.persist-authorization=true.
Регрессии: ApiKeyFilterTest#docsOpenWithoutKey,
#forwardedPrefix_healthStaysOpen, #forwardedPrefix_docsOpenWithoutKey
(вместо удалённого openApiRequiresKey). AGENTS.md синхронизирован.
2026-10-15 21:13:42 +00:00
Pjandro
25ed56bf20
API: ключ доступа X-API-Key и серверные лимиты входа
...
ApiKeyFilter — единственная граница доступа: сверяет X-API-Key со
свойством wordpdf.api-key (env WORDPDF_API_KEY, MessageDigest.isEqual);
пустое свойство = аутентификация выключена; /actuator/** открыт для
HEALTHCHECK; 401 отдаёт сам фильтр. Лимиты входа задаёт только
конфигурация сервера (wordpdf.max-bytes/max-pages, env
WORDPDF_MAX_BYTES/WORDPDF_MAX_PAGES, @Value с дефолтом-SpEL из констант
ядра; <=0 — падение на старте), параметрами запроса не переопределяются
(регрессии requestLimitParams_areIgnored, nonPositiveLimits_failStartup).
Конвертация — байты насквозь; опции рисования из запроса → ConvertOptions.
2026-10-14 01:50:35 +00:00
Pjandro
8c390104d2
Замена wordpdf-cli на Spring Boot REST API: wordpdf-app, SPA wordpdf-web, docker-compose
2026-10-13 16:38:18 +00:00