mega-plant/lib/insurance-rate-policy.ts

19 lines
940 B
TypeScript
Raw Normal View History

Add Running Costs sub-pages: insurance, financing, purchases, oil, operators, mechanics Splits the Running Costs group into six purpose-built pages, each with its own collection and its own source data, plus a coordinate parser for purchase orders. Insurance (R503 330/yr, 20 vehicles) A premium can move every month or three, so it is stored as a RATE PERIOD in insurance_rates and each month's cost is resolved against the rate in force that month. cost_lines insurance rows are derived from those periods. An absent rate is null, never 0 — nobody has entered the date, which is not the same as being insured for free. Financing (20 agreements, R428 585/mo) Instalment from the sheet; start date, paid-off date and the settled toggle are human-entered and preserved across re-seeds. Months-left and outstanding are null until a date is entered, never R0 on a live debt. The two paid-off agreements (WB02, DT01) show as settled and are excluded from the run-rate. Purchases + Oil Stock Uploads PO PDFs the way /income/invoices does. The parser reads columns by x-position, because plain text extraction reorders them, and refuses any PO whose lines do not sum to the sub-total. A cost code either names a machine ("SS-02" -> SS02) or a stock store ("MPLANT, ENGOIL") — never both, never guessed. Oil POs move litres into oil_stock_movements instead of onto a machine; stock is the sum of movements so the first usage is a subtraction from history. Operators (19) and Mechanics (2) Both are people with an employee number, separately reconcilable by the seed so someone added in the app survives. Mechanics get a badge QR; a mechanic with no employee number cannot be printed, because the code is what the QR encodes. Cross-cutting - The seed no longer deletes operators, mechanics or oil items: people are added in the app, and those rows exist in no file. - Re-pointing allocations that PocketBase clears because `assets` is rebuilt with new ids each seed (operators, purchase lines). - One QR encoder for screen and PDF, so a printed code cannot drift from the one on screen. pdf-lib writes real vector PDFs; pdfjs-dist only reads them. - Every figure is null-safe: unknown is never rendered as zero. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-08 23:06:27 +00:00
import policy from "./insurance-rate-policy.json";
/**
* How the insurance rate figures are treated — client note 2026-10-08: every rate on
* the "Vehicle Monthly Insurance" sheet is INCL VAT.
*
* This lives apart from `lib/insurance.ts` on purpose. The seed script imports that
* module directly, and bare Node cannot import JSON without an import attribute, so a
* JSON import in there breaks `npm run seed`. The flag is app-side presentation only
* — the amount booked is the incl-VAT figure either way, because it is the cash cost.
*/
export const RATES_INCLUDE_VAT: boolean = policy.ratesIncludeVat;
/**
* Suffix for a premium figure. Every rand printed from a rate carries it, because the
* same numbers sit beside an "Excl VAT" column on /overheads, and a reader who assumes
* the wrong basis will misread a comparison between the two screens.
*/
export const VAT_NOTE = RATES_INCLUDE_VAT ? "incl VAT" : "excl VAT";