Documentation Index
Fetch the complete documentation index at: https://docs.laportenard.com/llms.txt
Use this file to discover all available pages before exploring further.
Manual QA checklist for the printing system. Run against a Tauri desktop build connected to a real thermal printer.
Prerequisites
- Tauri desktop build (
npm run desktop:build)
- At least one ESC/POS network thermal printer (e.g., Epson TM-T20III)
- Printer configured in Odoo POS config (IP address, kitchen routes)
1. Kitchen tickets
| # | Scenario | Expected |
|---|
| 1.1 | Basic kitchen ticket | Table, server, items with qty, timestamp, cut |
| 1.2 | Multi-station routing | Each printer receives only its category items |
| 1.3 | Refire ticket | Only delta items print on refire |
| 1.4 | Void ticket | VOID header, item name, reason |
| 1.5 | Void routing | Void ticket goes to category’s station printer |
| 1.6 | Spanish characters | Accents (ñ, é, á) render correctly |
| 1.7 | Long item names | Truncated with ellipsis, price aligned right |
| 1.8 | Takeout badge | TAKEOUT badge shown prominently |
| 1.9 | Delivery badge | DELIVERY badge shown prominently |
Reprint restrictions
Reprinting receipts and checks requires the reprint permission, which defaults to manager-only. Non-managers are prompted with a ManagerOverrideModal before the reprint executes.
| Action | Permission | Default access |
|---|
| Reprint check | reprint | Manager only |
| Reprint fiscal receipt | reprint | Manager only |
2. Checks (pre-payment bill)
| # | Scenario | Expected |
|---|
| 2.1 | Basic check | Company header, table, server, guests, items, subtotal, taxes, total |
| 2.2 | Check with discounts | Discount line shown under item, total reflects discount |
| 2.3 | Check reprint | COPY banner at top |
| 2.4 | Takeout check | TAKEOUT badge in header |
| 2.5 | Check alias | Check alias shown in header |
| 2.6 | POS reference | Reference number shown |
| 2.7 | Voided items excluded | Voided items not shown |
| 2.8 | Multiple tax lines | ITBIS + Propina both itemized |
| 2.9 | Currency formatting | Correct symbol, decimal places, alignment |
3. Fiscal receipts
| # | Scenario | Expected |
|---|
| 3.1 | Basic fiscal receipt | Company header with RNC, NCF box, items, taxes, payment section |
| 3.2 | Cash payment | Payment method: Cash, Amount, Change |
| 3.3 | Card payment | Payment method shown, no change line |
| 3.4 | Zero change | Change line omitted |
| 3.5 | Customer RNC | Customer name and RNC shown |
| 3.6 | NCF display | NCF prominently displayed in box |
| 3.7 | Receipt reprint | COPY banner at top |
| 3.8 | Voided items excluded | Only non-voided items on receipt |
4. Adapter routing
| # | Scenario | Expected |
|---|
| 4.1 | Tauri check | Uses printRaw (ESC/POS bytes) |
| 4.2 | Tauri fiscal receipt | Uses printRaw |
| 4.3 | Tauri kitchen ticket | Uses printRaw |
| 4.4 | Browser dev mode | Uses printHtml (HTML string) |
5. Queue and retry behavior
| # | Scenario | Expected |
|---|
| 5.1 | Offline printer recovery | Job retries after backoff, eventually prints |
| 5.2 | Backoff escalation | ~5s → ~30s → fails permanently |
| 5.3 | Manual retry | Job re-enters queue and prints |
| 5.4 | Queue persistence | Pending jobs restored from IndexedDB after app restart |
| 5.5 | Concurrent printers | Both jobs process in parallel |
| 5.6 | TCP timeout | Fails within timeout (not hanging) |
6. Device settings
| # | Scenario | Expected |
|---|
| 6.1 | Override receipt printer | Subsequent receipts go to selected printer |
| 6.2 | Override check printer | Subsequent checks go to selected printer |
| 6.3 | Clear override (None) | Falls back to POS default printer |
| 6.4 | Stale override cleanup | Override cleared when printer removed from Odoo config |
| 6.5 | Override persists | Override still applied after app restart |
7. Codepage / encoding
| # | Scenario | Expected |
|---|
| 7.1 | UTF-8 printer (TM-T20III) | Spanish chars (ñ, é, á, ¿, ¡) render correctly |
| 7.2 | CP437 fallback (older printer) | Spanish chars render via CP437 mapping |
| 7.3 | Mixed ASCII + accented | All characters correct |
8. Edge cases
| # | Scenario | Expected |
|---|
| 8.1 | Empty order | No print job created |
| 8.2 | Printing disabled | No print jobs enqueued |
| 8.3 | No printer configured | Warning logged, no crash |
| 8.4 | 20+ item order | Prints correctly, no truncation |
| 8.5 | Cash drawer enabled | Drawer opens after print |
Automated test coverage
| Module | Tests |
|---|
escpos.ts (ESC/POS builder) | 17 |
printQueue.ts (queue) | 9 |
printService.ts (service) | 17 |
models.ts (domain) | 13 |
checkEscpos.ts (template) | 10 |
fiscalReceiptEscpos.ts (template) | 7 |
fiscalReceiptTemplate.ts (HTML) | 9 |
| Total | 82 |