Documents need attachments and generated files (SPEC 9.4) before the UI of
M3 can show them, and the spec forbids external libraries for PDF and
spreadsheets.
- VolumeFileStore keeps files under <data>/files/<COMPANY>/<yyyy>/<guid>,
writing a .part file in the same folder with size limit and SHA-256, then
quota and scanner checks (IFileScanner hook, no-op by default).
- attachments table (migration 007) with kind, version series, lock, trash
and the uploading user; AttachmentService uploads, adds generated files as
the next version, lists, opens, zips, locks, trashes, restores and purges
after 30 days (new system job system.attachments-trash).
- FileGenerationService runs IFileGenerator implementations into the store;
three generators for the fictitious test document (PDF, CSV, XLSX).
- CsvWriter (Italian Excel defaults, formula-injection guard), XlsxWriter,
ZipStreamWriter and PdfWriter (standard Type1 fonts, WinAnsi, AFM widths,
JPEG, Flate, xref) only write asynchronously, so they can stream to an
HTTP response.
- ADR 0021 records versioning, storage layout, PDF scope and CSV defaults.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>