Dinar POS · project status · 10 September 2026, evening

Stock in, expenses, the dashboard and the new look

The third milestone is built: suppliers and purchase orders that land stock and supplier debt, expenses, a dashboard with a thirty-day chart, Excel export and import, barcode labels, a yearly document series, and every screen redrawn on one component kit with four themes. All ten tasks are merged and reviewed, and the milestone is on main since 20:18. This page says what a shop can do now, what the reviews caught, and what needs a decision.

Branch m3/2026-09-10
ten tasks merged · branch merged into main
every screen, photographed

What a shop can do today

The shop keeps a file on each supplier and writes purchase orders against it. A delivery can arrive in parts; each receipt puts the goods into stock at their landed cost (transport and other costs spread over the lines by value, the odd centime on the last line) and raises what the shop owes the supplier by the value delivered, not ordered. A return sends goods back at the cost they came in at. Money handed to a supplier settles the oldest open order first, and a supplier's statement shows every movement with a running balance. A bon de réception is a delivery record, never a document with a number.

Expenses are written once against seeded categories (rent, electricity, wages, and so on) and never edited or deleted; a mistake is a second line. The cash position counts what actually moved through the drawer: cash sales at the amount paid, the stamp as its own figure, customer payments in, supplier payments and expenses out.

The dashboard shows today and the month side by side: sales, gross margin (after the whole-document discount, cancelled papers excluded, credit notes reversing at the cost the goods were sold at), expenses, cash position, customer and supplier debt, the products running low, the ten best sellers by units and by margin, and a thirty-day chart by day or by week. A stock recount repairs the cached quantity to what the movement ledger says and writes a line for every drift it finds.

Documents now number by year (FA-2026-000001, restarting at one each January, never a gap), which is what every Algerian shop's comptable expects. The catalogue exports to Excel and imports back from the same file, matched on barcode, with a dry run that lists what would change and refuses a bad row with its reason. Barcode labels print eighteen to an A4 sheet, with the EAN-13 check digit verified before anything is printed or imported.

And the whole application was redrawn. Every screen now sits on one component kit (shadcn/ui on the shop's own colours and type), switchable between four themes with one attribute: Comptoir (paper and green), Registre (ink and brass), Observe (white cards on cool grey) and its dark version. The logo is one coin mark that reads as a Latin D and an Arabic dal; the wordmark follows the language. A development seeder fills a shop with thirty days of realistic trading so every screen can be judged full, and every screen is photographed in French and Arabic on this site.

The ten tasks

Task	Status	What it is
Yearly series	done	Documents number per kind and per year, gapless, backfilled for what already exists.
Tables and rules	done	Suppliers, ledger, purchases, receipts, expenses and the jobs table; the document kinds as database rules.
Suppliers	done	The file, the append-only ledger, payments oldest-first, the statement.
Purchases	done	Orders, partial receipts, landed cost, returns, closing short, supplier debt on delivery.
Expenses and cash	done	Seeded categories, write-once expenses, the cash position that counts what moved.
Stock recount	done	The cache repaired to the ledger, one audit line per drift.
Dashboard	done	Today and the month, margin after discount and reversals, low stock, top ten, the thirty-day chart.
Excel and labels	done	Export, import with a dry run, eighteen labels per sheet, the check digit verified.
Seeder and series	done	A development-only binary that fills a shop with thirty days of trading; the series behind the chart.
Closing sweep	done	The spec and the architecture pages brought up to date, the review of the whole milestone, its fixes, this page.

Beside them, the design work of the same day: the four themes and the tokens, the vendored fonts, the logo, the component kit with a rule that refuses bare browser controls, and the nine screens redrawn one by one.

Reviewed before merge

Every task went through the money, data-reach and test-quality lenses before it merged, and the whole milestone was read once more at the end. The closing review found the code sound and two real gaps, both in the Excel import, both fixed the same evening with a test that failed first:

• A re-import with a blank cost cell overwrote the product's real cost with zero, which would have made every later sale look free of cost on the dashboard. Blank now means "leave it as it is", the way a blank barcode already did.
• A barcode of any shape was accepted at import and only refused later, when a label was printed. The thirteen-digit check with its check digit now runs at import too, and a file over five thousand rows is refused before it is read.
• Two tests were made stricter: the purchase property test now proves a refused payment was really above the debt, and a dashboard test sells at 19 % so a mix-up between the amount with and without tax cannot pass unnoticed.

Earlier in the day the reviews of single tasks caught and fixed: the cash position reading the total instead of the amount paid on cash sales (the stamp was missed on every cash sale over 300 DA); a division by zero on a free purchase order; a receipt of zero value writing no debt; supplier credit placed on the order's value instead of the delivery's; a label routine accepting twelve digits; an export range that stopped one second short of midnight.

Open for Anouar and the comptable

• The dashboard reads the margin after the whole-document discount. The comptable should confirm that is the figure they want, or whether the discount should sit on its own line.
• The yearly restart of the facture numbering (FA-2026-000001) is what the shops we know do; a word from the comptable that the tax office accepts it closes the question.
• The seeded shop dates itself to the real today, so the dashboard looks alive; the same seed on another day gives a different file. Fine for demos; say if a frozen date is wanted.
• The four themes are all in; if only two should ship in the first release, which two.

Decided along the way

• A bon de réception is a delivery record, not a numbered document; the supplier debt rises on delivery, never on the order.
• Landed cost is fixed at the moment of receipt and never recomputed; a return leaves at the cost it arrived at.
• Reports beyond Excel (sales by period and product, a TVA summary, stock valuation, debt ageing, PDF) are recorded as a later plan, not started.
• The screens are switched between themes by one attribute on the page; no screen knows which theme is on, and a test refuses any code that branches on it.
• The build folder is shared by every working copy on the build box, claimed per copy and locked to one build at a time, after a morning in which separate build folders filled the disk and crashed the machine five times.

Next

• The merge to main was made on the build box's own gate run: GitHub's hosted checks have refused to start since the afternoon because the organisation's billing failed, which Anouar can fix under Billing and plans. Then the fourth milestone: roles (owner, manager, cashier), a PIN at the till, the permission list, and the audit log on every action.
• The design system's second half: the Claude Design bundle refreshed from the repository, and the landing page in Astro with the product shots.