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

Closed
ai wants to merge 8 commits from feat/xlsx-bridge into main

8 Commits

Author SHA1 Message Date
Pjandro 733662770b feat(xlsx): REST + фронт + документация (шаг 8)
PR checks / web (pull_request) Successful in 39s
PR checks / java (pull_request) Successful in 1m37s
- 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
2026-11-03 02:37:43 +00:00
Pjandro 4a59662027 feat(xlsx): рисунки — картинки, диаграммы, theme, OLE-флаг (шаг 7)
- 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
2026-11-03 02:19:12 +00:00
Pjandro a48f8cd027 feat(xlsx): печать — секции, бумага/ориентация/поля, срезы колонок, rowBreaks (шаг 6)
- 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' (файл считался бинарным)
2026-11-03 02:01:31 +00:00
Pjandro 182f9d2910 feat(xlsx): стили/numFmt/цвета/тема (шаг 5) + полный набор юнитов парсеров
- 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)
2026-11-03 01:43:01 +00:00
Pjandro e8afc8966f feat(xlsx): мост .xlsx → in-memory .docx — каркас v1 (шаг 4)
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).
2026-11-03 00:30:32 +00:00
Pjandro 3a1bfba413 feat(validator): классификация .xlsx + нижняя оценка страниц до конвертации
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.
2026-11-02 23:48:29 +00:00
Pjandro 77ccac43f6 refactor(doc): перенос DocxWriter → internal.DocxPackageWriter (public)
Общий сборщик docx-пакета для мостов .doc и (следующий шаг) .xlsx:
пакет internal, public record Part/write/storyPart, NAMESPACES + xmlns:c
(нужен xlsx-мосту для a:graphicData/c:chart). Механика не менялась.
2026-11-02 23:39:00 +00:00
Pjandro bbe992e61f test(xlsx): генератор и фикстуры .xlsx для моста SpreadsheetML
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.
2026-11-02 23:36:10 +00:00