feat(M3): contracts editor, templates, PDF render via Puppeteer/Chromium

Backend:
- numbers.ts — per-org per-doctype per-year sequential numbering (ДГ-2026/001, СЧ-2026/001…)
- money.ts — line totals + Russian rubInWords helper
- documents/routes.ts — CRUD with transactional lines bulk-replace, status changes, history endpoint for client-line autocomplete
- templates/routes.ts — CRUD + instantiate (clones template body into new draft document)
- shared/render/toHtml.ts — block→HTML renderer with placeholder substitution ({{customer.inn}}, {{contract.number}}, {{today}}…)
- documents/pdf.ts — Puppeteer-based PDF rendering with auto-detected Chromium executable
- documents/pdf.routes.ts — GET /:id/preview (HTML) and GET /:id/pdf
- Dockerfile.api — added apk chromium + cyrillic fonts

Web:
- api.ts — Document, DocumentTemplate, Block, LineHistoryItem types
- BlocksEditor — generic block list with reorder/add/remove and per-block forms (heading, party, services_table, totals, terms, signatures, custom_text, page_break)
- LinesEditor — services rows with auto sumCents, "from catalog" picker, "from history by client" panel
- ClientPicker — reusable client dropdown
- pages: Documents list, DocumentEdit (new+existing), Templates list, TemplateEdit
- richtext.ts — plain↔TipTap-JSON conversion (no TipTap yet, just keeps the format compatible)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
admin
2026-05-01 08:29:44 +03:00
parent 0722a25845
commit 9807d47c8d
24 changed files with 3428 additions and 40 deletions
+99 -1
View File
@@ -68,7 +68,105 @@ export type Service = {
name: string;
unit: string;
defaultPriceCents: number; // BigInt сериализуется в number (см. apps/api/src/lib/bigint.ts)
defaultVat: 'none' | 'vat_0' | 'vat_5' | 'vat_7' | 'vat_10' | 'vat_20';
defaultVat: VatRate;
notes: string | null;
archivedAt: string | null;
};
export type VatRate = 'none' | 'vat_0' | 'vat_5' | 'vat_7' | 'vat_10' | 'vat_20';
export type DocType = 'contract' | 'invoice' | 'act' | 'upd';
export type DocStatus = 'draft' | 'issued' | 'sent' | 'partially_paid' | 'paid' | 'cancelled' | 'signed';
export type DocumentLine = {
id: string;
documentId: string;
position: number;
serviceId: string | null;
name: string;
qtyMilli: number;
unit: string;
priceCents: number;
vat: VatRate;
sumCents: number;
};
export type DocumentSummary = {
id: string;
organizationId: string;
docType: DocType;
number: string;
issuedAt: string | null;
status: DocStatus;
clientId: string | null;
client: { id: string; name: string; kind: Client['kind'] } | null;
parentDocumentId: string | null;
totalCents: number;
vatCents: number;
currency: string;
tochkaDocumentId: string | null;
pdfPath: string | null;
createdAt: string;
updatedAt: string;
};
export type Document = DocumentSummary & {
body: DocBody;
client: Client | null;
lines: DocumentLine[];
};
export type DocumentTemplate = {
id: string;
organizationId: string;
docType: DocType;
name: string;
body: DocBody;
createdAt: string;
updatedAt: string;
};
// === Block schema (mirrors packages/shared) ===
export type RichText = {
type: string;
content?: RichText[];
text?: string;
marks?: { type: string }[];
};
export type Block =
| { id: string; type: 'heading'; level: 1 | 2 | 3; text: RichText }
| { id: string; type: 'paragraph'; text: RichText }
| {
id: string;
type: 'party';
role: 'executor' | 'customer';
bind: { kind: 'self' } | { kind: 'client'; clientId?: string };
}
| {
id: string;
type: 'services_table';
columns: Array<'name' | 'qty' | 'unit' | 'price' | 'vat' | 'sum'>;
lines: { lineId: string }[];
}
| { id: string; type: 'totals'; showVat: boolean; showInWords: boolean }
| { id: string; type: 'terms'; text: RichText }
| { id: string; type: 'signatures'; sides: ('executor' | 'customer')[] }
| { id: string; type: 'custom_text'; text: RichText }
| { id: string; type: 'page_break' };
export type DocBody = {
version: 1;
blocks: Block[];
vars: Record<string, unknown>;
};
export type LineHistoryItem = {
serviceId: string | null;
name: string;
unit: string;
priceCents: number;
vat: VatRate;
lastUsed: string;
useCount: number;
};