rikrdo/mercadodevida
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(F-192): completed feature

Browse Source
This commit is contained in:
chattie
2026-08-23 07:53:17 +02:00
parent e542b180ad
commit a372e5abfb
9 changed files with 107 additions and 31 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
work/current.md
View File

@@ -1,26 +1,18 @@
# F-191 — POS terminal and daily cash close reconciliation
# F-192 — Simplify storefront net price VAT label
Design and implement terminal and daily cash close balancing: card/cash returns and pending payments.
Render price copy as amount sin IVA plus rate, removing the separator and duplicated IVA word.
## Scope
- POS cashiers can **close their session** (cash close): finalize expected vs actual cash count, handle over/short.
- `POST /pos/sessions/:id/close` accepts `actualCashCents` and calculates `varianceCents = actualCashCents - expectedCashCents`. Stores `varianceCents` and `closedAt` on `pos_cash_sessions`.
- Closed sessions can no longer accept new sales or rest-payments.
- `GET /pos/sessions/:id` returns session summary including total sales, cash received, expected cash, variance.
- `GET /pos/sessions` lists all sessions (open and closed) for a terminal or store.
- Admin view: list all cash sessions across terminals with variance. Filter by date range, store, terminal.
- `expected_cash_cents` is already maintained atomically by sale/rest-payment/return operations.
- Pending (PENDING state) POS orders from a closed session are still payable via rest-payment from an OPEN session (separate session, same terminal).
- In all storefront product views (product detail page, cart, search results, category listings), the net price display currently shows "X,XX € (IVA Y%)" or similar variants.
- Replace the display with a simpler pattern: "X,XX € sin IVA (Y%)" — remove separator and duplicate "IVA" word.
- Update all locales (Spanish primary, any others present).
- If the component is shared (e.g., `PriceDisplay` component), fix it once and it propagates everywhere.
## Out of scope
- Bank deposit slip generation.
- Multi-terminal reconciliation in a single close.
- Automatic variance alerts (out of scope, can be added later).
- Backend price calculation changes.
- Changes to admin price display.
## Acceptance
1. Cashier can close an open session; session transitions to `CLOSED` and `expected_cash_cents` is frozen.
2. Closing with exact cash (variance=0) is accepted without warning.
3. Closing with over/short is accepted; variance is stored and visible in admin session list.
4. No new sales can be started on a closed session.
5. Pending orders from a closed session can still be completed via rest-payment from an open session.
6. `verify.sh` green, typecheck green, all tests pass.
1. All storefront product price labels show "X,XX € sin IVA (Y%)" format.
2. No duplicate "IVA" word in the label.
3. `verify.sh` green, frontend typecheck green.