- main.yml: новый job images (docker build + push, теги prod + sha-<7>,
DOCKER_BUILDKIT=0 — daemon за раннером podman); deploy: needs images,
restart.sh --deploy, .rollback.env без PREV_COMMIT (git-клон src на проде
больше не нужен); rollback: retag image ID на реестровые :prod
- GITEA-vars.md: Secrets REGISTRY_USER/REGISTRY_PASSWORD, Variable REGISTRY
- AGENTS.md: CI/CD и Деплой переписаны под pull-поток
maven-pmd-plugin 3.28.0 (PMD 7.17) на фазе verify для обоих модулей,
includeTests=true, ruleset pmd-ruleset.xml: codestyle без opinionated-правил,
MethodNamingConventions с junit5TestPattern под underscore-имена регрессий,
TooManyStaticImports до 12, XPath LiteralFirstInEquals (PMD 7 удалил
EqualsAvoidsNull), unused-правила bestpractices.
Литерал слева в equals/equalsIgnoreCase (NPE-safe), удаление неиспользуемых
параметров/локальных/импортов/полей, логгеры log→LOG (конвенция UPPER_SNAKE),
UselessParentheses/UnnecessaryCast/UseShortArrayInitializer, record без явного
static, пустой конструктор ChartSpec удалён. Семантика не меняется.
- docker-compose.dev.yml: ports 127.0.0.1:9011:80 → 9011:80 (вход по LAN-IP хоста)
- vite.config.ts: server.host=true — dev-сервер тоже на все интерфейсы
- api.ts: probeApiKey() — GET /api/v1/convert (POST-only эндпоинт): 401 от
ApiKeyFilter ⟺ сервер требует ключ; при выключенной аутентификации не 401
- App.tsx: экран ApiKeyGate показывается только когда зонд вернул 'required';
401 на конвертации возвращает к гейту (setGate('required'))
- AGENTS.md: обновлены поведенческие строки (dev-вход, контракт гейта)
При правке apiKeyName→paramName строка in = SecuritySchemeIn.HEADER была
срезана; в спеке apiKey-схема осталась без обязательного in — Swagger UI
не знал, куда положить ключ, и «Try it out» слал запросы без X-API-Key
(401; обнаружено браузерным E2E на проде после мержа #4). Тест
docsOpenWithoutKey теперь пинит in == header (прежних assert type+name
не хватало ровно на это). Локальный E2E (jar + браузер): запрос с
x-api-key, ответ 200.
Прод (наружный 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 синхронизирован.
Word в strict пишет проценты строками (a:shade val="50%",
w14:fillToRect w14:t="130%") и w:start/w:end вместо w:left/w:right —
JAXB-разбор docx4j падает на NumberFormatException (в mc-preprocessor.xslt
ветка % закомментирована, start/end не маппятся). Новый байтовый
StrictOoxmlNormalizer первым в цепочке нормализаторов приводит strict к
transitional-байту; mc-preprocessor доделывает namespaces и pt.
- StrictOoxmlNormalizer: %-атрибуты a:/w14:fillToRect -> тысячные (x1000),
текст wp14:pctWidth/pctHeight, элементы/атрибуты w:start/w:end ->
w:left/w:right (кроме w:lvl/w:start в numbering.xml), значения start/end
у w:jc/w:tab; transitional-документы — no-op (assertSame)
- WordPdfValidator: lightweight-путь читает атрибуты по локальному имени
(attrLocal) — иначе в strict не засчитываются w:br type="page";
pageCountOf при провале JAXB-разбора бросает ConversionException вместо NPE
- тесты: StrictOoxmlNormalizerTest (13), регрессии
strictOoxml_convertsNotRejected (in-memory strict-zip),
pageCount_strictBreaksCountedLightweight; AGENTS.md обновлён
Реальный develop/openxml.docx: 11 страниц как в эталоне Word, диаграммы
и SmartArt рендерятся. mvn clean verify: core 104 + app 20, BUILD SUCCESS.
docker-compose.yml: WORDPDF_API_KEY обязателен (:? — без ключа стек не
поднимется), springdoc выключен env'ами, nginx client_max_body_size 100m;
docker-compose.dev.yml — стенд без ключа на 127.0.0.1:9011 со springdoc;
gateway/nginx.conf — единственный вход; SPA base через ARG VITE_BASE;
.env.example — шаблон ключа и лимитов. .gitignore: +.codegraph/,
+references/convert.pdf.
ApiKeyGate: ключ в localStorage (wordpdf.api.key), при 401 очищается и
форма открывается заново; заголовок X-API-Key подставляет только api.ts.
base сборки — env VITE_BASE (дефолт '/'); vite.local.config.ts — локальный
прогон без прод-префикса.
WordPdfConverter/WordPdfValidator: вход и выход только byte[] (файловые
перегрузки убраны). Дефолты лимитов — в WordPdfSettings (20 МиБ/1000
страниц), переопределяются на вызове через ConvertOptions (лимиты,
renderCharts/renderSmartArt); DrawingPreRenderer пропускает выключенные
рисунки ранним continue.
Знак без глифа в шрифте ранa FOP рисовал .notdef — в эталонном
references/word.docx таких оставалось 28.
- Noto Naskh Arabic и Noto Sans Armenian (SIL OFL, 278 КБ) в бандле:
FontFallback.selectCovering перебирает весь реестр PhysicalFonts и
находит их сам — арабские дополнения и армянские Unicode 16 рисуются
без нашего кода.
- GlyphCoverageNormalizer режет ран по покрытию глифов и пишет семейство
в w:rFonts. Нужен из-за двух дыр docx4j: needsCoverage=false для
«латинской» группы (римские цифры U+2150–U+218F) и кэш fallbackByScript
на всю группу Юникода (армянские U+058D/U+058E получали DejaVu Serif).
- FopFallbackFonts.declare декларирует все бандл-семейства: FOP встраивает
только задекларированные, а font-family в FO может запросить любое.
В эталоне осталось 2 решёток: U+2188 и U+218A есть только в GNU FreeSerif
(GPL-3+ с Font Exception), которого в бандле нет намеренно.
17.x приносит WordLayoutFixups (постобработка DOM XSL-FO: columnBreaks,
lineBoxAttributes, stripHints и др.) и jeuclid-fop, поэтому начинают
работать две вещи, которых не было: формулы m:oMath (на стр. 4 эталона
формула молча исчезала) и w:cols/@w:num (две колонки на стр. 9-11).
Сходимость текста references/word.docx с экспортом Word 0,848 -> 0,981,
средний постраничный пиксельный diff 10,5% -> 7,4%.
Что пришлось починить по пути:
* docx4j навешивает на fo:inline fox:gsub-features, не объявляя префикс
fox. FO становится некорректным XML, WordLayoutFixups не парсит его и
молча отказывается от всех фикс, а оставленный хинт docx4j-baseline
отвергает уже FOP. Отключаем генерацию через
docx4j.convert.out.fo.gsubFeatures=false.
* FOP теперь форк org.docx4j:docx4j-fo-renderer*, и его
META-INF/services/org.apache.fop.fo.ElementMapping лежит ещё и в
docx4j-export-fo: в fat-jar без ServicesResourceTransformer второй файл
перезаписывает первый, FOP не узнаёт namespace fo: и падает на
UnknownXMLObj. Тесты этого не видят — они идут по classpath.
* addPhysicalFont не перезаписывает занятый ключ реестра: системный
DejaVuSerif.ttf занимает «dejavu serif» и наш DejaVuSerif-Regular.ttf
не регистрировался. BundledFonts.init() чистит реестр до регистрации.
* Fop.Renderers.getRenderer() теперь список w:renderer по mime —
FopFallbackFonts ищет application/pdf.
Em-dash (U+2000-U+2EFF) остался на шрифте ранa, если в нём есть глиф —
так же делает Word (в references/word.pdf em-dash нарисован Calibri/Times,
DejaVu нет вообще), поэтому тест проверяет «вшитый шрифт, не Helvetica»,
а не конкретное семейство.
Word записывает поле колонтитула как fldChar begin -> instrText "PAGE"
-> separate -> закэшированный результат -> end. Экспорт docx4j в XSL-FO
инструкцию внутри такого поля не видит и печатает кэш из docx: в
references/word.docx на всех страницах было «2» и «11/11».
FieldNormalizer разворачивает поле в w:fldSimple — его обрабатывает
FldSimpleWriter из docx4j-export-fo (PAGE -> fo:page-number, есть также
NUMPAGES/SECTIONPAGES). Закэшированные ран сохраняются внутри поля: они
дают оформление. Штатный FieldsCombiner docx4j делает то же, но не
заходит внутрь w:sdt, а Word держит нумерацию именно в контентном
контроле «Page Numbers (Top of Page)» — отсюда нормализация байтов.
Переписываются только инструкции, для которых есть обработчик; поле без
separate/end и вложенные поля пропускаются.
Word задаёт маркеры списков кодами из PUA (U+F0xx), а глиф выбирается по
имени шрифта. Экспорт docx4j в XSL-FO эти шрифты не знает: код уходит в
fallback-семейство, глифа там нет, FOP рисует .notdef — в PDF решётка «#».
SymbolFontNormalizer (шаг перед JAXB, как DocxOnOffNormalizer) меняет код
на Unicode, а имя шрифта — на DejaVu Sans. Таблица кодов — SymbolMapper из
docx4j 17.x, отфильтрована по наличию глифа в DejaVu; совпадение с экспортом
Word сверено по references/word.pdf. Обрабатываются w:lvl (numbering.xml),
w:r и w:sym — ран с w:sym разрезается, т.к. у символа собственный w:font.
В эталонном документе пропали все 19 решёток в маркированных списках
(− • ▪ ❖ ➢ ✓ ♥) и поправились два w:sym.
docx2fo.xslt умеет только a:graphicData/pic:pic — для c:chart и dgm:relIds
там notImplemented, т.е. объект молча исчезал из PDF. Новый internal/chart
рендерит их своим Java2D-движком в PNG 300 dpi и подменяет на pic:pic
(шаг 3.5 в convertToStream: после setFontMapper, до FOSettings).
surface3D: седловая ячейка режется диагональю с большей суммой значений
(верхняя огибающая седла). При фиксированной w00–w11 второй треугольник
становится невидимой щепкой, а видимая грань окрашивается не той полосой.
Конструктор BundledFontMapper каждый раз заново обнаруживает системные
шрифты; на Windows найденный Calibri покрывает U+2000-U+2EFF, и
RunFontSelector оставляет em-dash на Carlito вместо fallback-DejaVu
(красный ruPlain_emDashEmbeddedNotHelvetica). Очистка реестра после
init() и до load() делает вывод одинаковым на любой ОС; шрифты,
встроенные в docx, регистрируются при load() и остаются в реестре.