Мост .xlsx → PDF: SpreadsheetML-конвейер без LibreOffice/POI #91

Closed
ai wants to merge 8 commits from feat/xlsx-bridge into main
Collaborator
No description provided.
ai added 8 commits 2026-11-03 05:38:01 +03:00
SampleXlsxGenerator (POI 5.5.1, по образцу SampleDocxGenerator) + 7 закоммиченных
фикстур: basic (стили/merge/rich/hyperlink/hidden), numfmt (форматы v1), 1904,
wide (40 col + rowBreak + merge через срез), fit-to-page, chart-image, page-limit.
Общий сборщик docx-пакета для мостов .doc и (следующий шаг) .xlsx:
пакет internal, public record Part/write/storyPart, NAMESPACES + xmlns:c
(нужен xlsx-мосту для a:graphicData/c:chart). Механика не менялась.
checkDocxContainer → checkOoxmlContainer (ContainerKind DOCX/XLSX по маркерам
wordprocessingml/spreadsheetml в [Content_Types].xml; новый текст 400 для zip
без обоих маркеров — контракт). isSpreadsheet — короткий скан манифеста.
checkPageCountXlsx: видимые листы (state, r:id, rel на существующую часть) +
rowBreaks/brk (§18.3.1.74), двупроходный zip. validate() роутирует XLSX на
xlsx-оценку; текст zip-подписи перечисляет .docx/.doc/.xlsx.
internal/xlsx: XlsxPackage (zip/rels), WorkbookModel (листы, date1904),
SheetModel (cols/sheetData/mergeCells/hyperlinks/rowBreaks/pageSetup/
pageMargins/printOptions/olePresent), SharedStrings (CT_Rst с rPr),
StylesModel (fonts/fills/borders/cellXfs/indexedColors), Metrics (MDW по
бандлу → ширина колонки px→twips), ColorSpec, NumberText (General),
SheetToTable (w:tbl фиксированной сетки: скрытые строки/колонки, gridSpan/
vMerge, rich-раны, внешние гиперссылки hl0..), XlsxToDocx (оркестратор).
WordPdfConverter: роутинг isSpreadsheet → XlsxToDocx. Тесты: структура
docx-конвертата (XlsxToDocxTest) + сквозной PDF (XlsxPdfConverterTest).
- ThemeModel (clrScheme/minorFont, дефолтная палитра Office), ColorResolver
  (theme/indexed/tint/shade), NumberFormats (builtin+custom коды, эпоха 1904),
  emit заливок/границ/шрифтов/vAlign/jc/indent в SheetToTable
- юниты: XlsxPackage, ThemeModel, StylesModel, SheetModel, WorkbookModel,
  SharedStrings, SheetToTable, NumberText, Metrics, ColorSpec + крафтовые
  workbook-пакеты в XlsxToDocxTest (hidden-листы, errorOnOle, пустые листы)
- фиксы, найденные юнитами: StAX-обрыв sheetData на строке с битым @r
  (SheetModel), обрезание границы на первой цветной стороне (StylesModel),
  редирект контента merge в отсутствующую видимую клетку (SheetToTable),
  General-научный с 1e10 и разворот E-нотации (NumberText)
- PrintLayout: карта CT_PaperSize→twips (16 значений, вне карты — A4+warn),
  landscape-swap, pageMargins in→twips; greedy-нарезка видимых колонок по
  полезной ширине; fitToPage+fitToWidth=1 — один срез со сжатием ширин;
  @scale без fitToPage — игнор+warn; вертикальные фрагменты по rowBreaks/@id
  (обрывы за содержимым отбрасываются)
- SheetToTable.emit — список блоков (срез × фрагмент) с масштабом ширин;
  XlsxToDocx — paragraph-level sectPr после каждого блока, секция последнего
  блока — body-level sectPr (все листы скрыты — финальная A4-секция)
- фикстура xlsx-numfmt — Legal (sectionPerSheet); PDF-тесты: правый срез на
  своей странице, разрыв после 12-й строки, fitToPage — одна landscape-страница,
  MediaBox следует секции листа
- WarnOnce: литеральный NUL в исходнике заменён на '\0' (файл считался бинарным)
- DrawingBridge: xdr-якоря two/one/absoluteCell (EMU-кумулятив по Metrics,
  hidden=0; xdr:ext отличается от вложенного a:ext по namespace), inline-emit
  в from-ячейку, clamp скрытых строк/колонок, fallback-абзацы в конец листа;
  порог extent 22M EMU как DrawingPreRenderer
- xdr:pic → word/media/xlsx-imageN (as-is, тип по расширению); c:chart →
  word/charts/xlsx-chartN.xml c сохранением graphicData — штатный шаг 3.5
  дорисовывает PNG и ловит errorOnCharts (Kind.CHARTS, сквозной тест);
  SmartArt/фигуры/внешние blip — пропуск+warn; theme1.xml → word/theme
  (палитра для чартов); OLE — warn либо 422 по флагу
- юниты DrawingBridgeTest (8), пакетный тест эмита в cell+theme, PDF:
  imageCount≥3/distinct≥2 на xlsx-chart-image, errorOnCharts→Kind.CHARTS
feat(xlsx): REST + фронт + документация (шаг 8)
PR checks / web (pull_request) Successful in 39s
PR checks / java (pull_request) Successful in 1m37s
733662770b
- ConvertController: расширение .xlsx, текст 400 «только .docx, .doc и .xlsx»
  (контракт с фронтом), @Operation — флаг errorOnSmartArt на .xlsx не
  срабатывает; safeBaseName срезает .xlsx
- фронт: DropZone accept/подпись, подзаголовок App, api.ts фолбэк-имя режет
  .xlsx; web build+lint зелёные
- app-тесты: xlsxFile_convertsToPdf (200, PDF, filename* Отчёт.pdf, текст
  доехал), nonDocxFilename_rejected — .xlsx в тексте, safeBaseName .XLSX
- прод-автотест test_convert_xlsx (32 проверки)
- docs: новая docs/agent/xlsx-bridge.md (классы, единицы, деградации,
  соглашения PrintLayout↔валидатора); AGENTS.md — роутинг входа, секция
  моста .xlsx, REST/фронт/счётчики (75 классов/1095 тестов, 32 фикстуры);
  pipeline.md (ContainerKind, estimateXlsxPages), repo-map.md (пакет,
  DocxPackageWriter, генераторы, пересоздание xlsx), testing.md,
  doc-bridge.md (DocxWriter → internal/DocxPackageWriter)

Сквозная проверка java -jar + curl: xlsx→PDF 200 (filename* RFC5987),
chart-fixture 200 с отрисованными PNG, errorOnCharts=true → 422 контрактный
текст, .txt → 400 новый текст, .doc-регресс 200

Покрытие (JaCoCo)

Модуль Строки Ветви Порог строк
wordpdf-core 95.0% 85.5% 90%
wordpdf-app 93.9% 87.0% 90%
<!-- jacoco-coverage --> ## Покрытие (JaCoCo) | Модуль | Строки | Ветви | Порог строк | |---|---|---|---| | wordpdf-core | 95.0% | 85.5% | 90% | | wordpdf-app | 93.9% | 87.0% | 90% |
pjandro closed this pull request 2026-11-08 23:38:26 +03:00
Some checks are pending
PR checks / web (pull_request) Successful in 39s
PR checks / java (pull_request) Successful in 1m37s

Pull request closed

Sign in to join this conversation.
No Reviewers
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: pjandro/java-word-pdf#91