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
|
|
|
[
|
|
|
|
|
{
|
|
|
|
|
"code": "OIL-ENG",
|
|
|
|
|
"name": "15W-40 CI-4",
|
|
|
|
|
"detail": "L/FORCE 15W40 CI-4",
|
|
|
|
|
"supplier": "Lube Force Traders cc",
|
|
|
|
|
"material_code": "25100",
|
|
|
|
|
"store_cost_code": "MPLANT, ENGOIL",
|
|
|
|
|
"drum_litres": 210,
|
|
|
|
|
"colour": "#EDAE49",
|
|
|
|
|
"qr": "15W-40 CI-4 | OIL-ENG"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"code": "OIL-HYD",
|
|
|
|
|
"name": "Hydraulic 68",
|
|
|
|
|
"detail": "L/FORCE HYDRAULIC 68",
|
|
|
|
|
"supplier": "Lube Force Traders cc",
|
|
|
|
|
"material_code": "25100",
|
|
|
|
|
"store_cost_code": "MPLANT, HYDOIL",
|
|
|
|
|
"drum_litres": 210,
|
|
|
|
|
"colour": "#30638E",
|
|
|
|
|
"qr": "Hydraulic 68 | OIL-HYD"
|
2026-10-22 09:39:18 +00:00
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"code": "FUEL-DSL",
|
|
|
|
|
"name": "Diesel",
|
|
|
|
|
"detail": "Bulk diesel tank",
|
|
|
|
|
"supplier": "",
|
|
|
|
|
"material_code": "",
|
|
|
|
|
"store_cost_code": "MPLANT, DIESEL",
|
|
|
|
|
"drum_litres": 650,
|
|
|
|
|
"opening_litres": 589,
|
|
|
|
|
"colour": "#D1495B",
|
|
|
|
|
"qr": "Diesel | FUEL-DSL"
|
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
|
|
|
}
|
2026-10-22 09:39:18 +00:00
|
|
|
]
|