How odoo/obox-app works
ePOS Proxy is a desktop bridge that makes a USB Epson printer available to Odoo POS through a local HTTP endpoint. The documented user flow is to launch the app, let it detect the printer, copy its displayed address, and configure Odoo to use it. The frontend also exposes printer status and LAN-printer management, while print-format handlers and ESC/POS code indicate internal print-processing capabilities. Backend implementation excerpts were not provided, so backend relationships beyond the documented HTTP workflow are left out.
Main entry points: App.tsx App interface · StepDialog.tsx Step guide dialog · PrinterList.tsx Printer list · PrinterContext.tsx Printer state
Components 26
Desktop interface
- App interface
frontend/src/App.tsx - App state
frontend/src/contexts/AppContext.tsx - Toast feedback
frontend/src/contexts/ToastContext.tsx - Dialog framework
frontend/src/components/Dialog.tsx - Step guide dialog
frontend/src/components/StepDialog.tsx - Guide navigation
frontend/src/hooks/useStepDialog.ts - Formatted text
frontend/src/functions/renderFormattedText.tsx
Printer management
- Printer state
frontend/src/contexts/PrinterContext.tsx - Printer list
frontend/src/components/PrinterList.tsx - Printer item
frontend/src/components/PrinterListItem.tsx - LAN printer setup
frontend/src/components/NetworkIpDialog.tsx - Network setup guide
frontend/src/components/NetworkPrinting.tsx - Enabled guidance
frontend/src/components/NetworkPrintingEnabledDialog.tsx - Printer actions
frontend/src/components/PrinterActions.tsx - Printer manager
internal/printer/manager.go - USB printer access
internal/printer/usb.go - LAN printer access
internal/printer/lan.go
Print processing
- Print dispatch
frontend/src/functions/executePrint.ts - ePOS print sender
frontend/src/functions/sendEposPrint.ts - Label print sender
frontend/src/functions/sendLabelPrint.ts - ESC/POS encoding
internal/escpos/commands.go - ESC/POS XML
internal/escpos/xml.go
Local service
- Local HTTP service
internal/server/server.go - Desktop app binding
app.go
Other components
- Desktop user
- Odoo POS
Connections 21
- Desktop user → App interface: uses
- App interface → Printer list: renders
frontend/src/App.tsx - App interface → Network setup guide: renders
frontend/src/App.tsx - App interface → Enabled guidance: renders
frontend/src/App.tsx - App interface → App state: provides state
frontend/src/App.tsx - App interface → Printer state: provides state
frontend/src/App.tsx - Printer list → Printer state: reads state
frontend/src/components/PrinterList.tsx - Printer list → Printer item: renders
frontend/src/components/PrinterList.tsx - Printer list → LAN printer setup: opens
frontend/src/components/PrinterList.tsx - Printer state → Desktop app binding: calls bindings
frontend/src/contexts/PrinterContext.tsx - Network setup guide → Printer state: reads state
frontend/src/components/NetworkPrinting.tsx - Network setup guide → Step guide dialog: opens guide
frontend/src/components/NetworkPrinting.tsx - Enabled guidance → Formatted text: formats text
frontend/src/components/NetworkPrintingEnabledDialog.tsx - Enabled guidance → Dialog framework: uses
frontend/src/components/NetworkPrintingEnabledDialog.tsx - Step guide dialog → Guide navigation: navigates steps
frontend/src/components/StepDialog.tsx - Step guide dialog → Formatted text: formats text
frontend/src/components/StepDialog.tsx - Step guide dialog → Dialog framework: uses
frontend/src/components/StepDialog.tsx - Print dispatch → ePOS print sender: dispatches
frontend/src/functions/executePrint.ts - Print dispatch → Label print sender: dispatches
frontend/src/functions/executePrint.ts - Odoo POS → Local HTTP service: sends print requests
- Desktop user → Odoo POS: configures address