DocHub
DocHub/Captain Van's POS/Point of Sale System/Project Overview
Captain Van's retail POS system — business context, architecture, and current status

Captain Van’s POS — Project Overview

Business Context

Item Value
Business Captain Van’s
Type Retail store (formerly DVD rental, pure retail since 2017)
Location West End, Roatan, Islas de la Bahia, Honduras
Currency HNL (Honduran Lempira)
Tax regime Honduras SAR — ISV 15% standard, 18% luxury, 0% exempt
Language Spanish
Timezone America/Tegucigalpa

The store is already operating using a very old legacy system (Microsoft Access database). This project replaces that system with a modern touchscreen POS.

What We’re Building

A complete retail POS system with:

  • Touchscreen interface — Odoo 17 POS (browser-based, tablet/touch-friendly)
  • Barcode scanning — Hardware barcode scanner for product lookup
  • Receipt printing — Thermal receipt printer with Honduras SAR-compliant invoice format
  • Customer management — 1,895 existing customers migrated from legacy system
  • Product catalog — 2,505 products with categories, taxes, and barcodes
  • Inventory tracking — Stock management integrated with POS
  • Honduras SAR compliance — Custom module for CAI invoice authorization (required by law)

Architecture

[Touchscreen Terminal]  -->  [Odoo 17 Web UI]  -->  [Odoo Server (Docker)]
[Barcode Scanner]       -->       |                        |
[Receipt Printer]       <--       |                   [PostgreSQL 15]
                                  |                        |
                            [Honduras SAR Module]    [Product/Customer Data]

Deployment: Local at the store. Odoo runs on a machine physically at Captain Van’s — not cloud-hosted.

Technology Stack

Component Technology Version
POS application Odoo Community Edition 17.0
Database PostgreSQL 15 (Alpine)
Containerization Docker + Docker Compose v2
Custom module Honduras SAR CAI 17.0.1.0.0
Import scripts Python 3 (stdlib only) 3.x
API Odoo XML-RPC /xmlrpc/2/

Docker Services

Service Container Port Image
Odoo captainvans-odoo 8069 odoo:17.0
PostgreSQL captainvans-odoo-db 5435 postgres:15-alpine

Repository

Item Value
GitHub OmelasAI/captainvans-odoo (private)
Branch main
Local path Laptop: /home/chas-watkins/code/CaptainVans-Odoo/

File Structure

CaptainVans-Odoo/
├── CLAUDE.md              # Full project documentation for AI
├── CHANGELOG.md           # Change history
├── UNPACK.md              # Setup guide (recreate from scratch)
├── docker-compose.yml     # Docker services
├── config/odoo.conf       # Odoo server configuration
├── start-odoo.sh          # Start containers
├── stop-odoo.sh           # Stop containers
├── import_data.py         # XML-RPC data import (Python 3)
├── convert_data.py        # Legacy CSV → Odoo CSV converter
├── addons/
│   └── honduras_sar/      # Custom Honduras SAR CAI module
│       ├── __manifest__.py
│       ├── models/cai_authorization.py
│       ├── views/cai_views.xml, menu.xml
│       └── security/ir.model.access.csv
└── data/
    ├── odoo_products.csv      # 2,505 products
    ├── odoo_customers.csv     # 1,895 customers
    ├── odoo_suppliers.csv     # 36 suppliers
    └── odoo_categories.csv    # 15 categories

Current Status

Phase: READY FOR TESTING (since January 27, 2026)

Milestone Status
Legacy data extracted Done
Data converted to Odoo format Done
Docker environment created Done
Odoo modules installed Done
Company configured (HNL, Honduras) Done
Data imported (products, customers, suppliers) Done
Honduras SAR module built & installed Done
POS configuration (payment methods, categories, cashiers) Not started
Hardware integration (scanner, printer) Not started
Client provides RTN + CAI Waiting on client
User acceptance testing Not started
Deploy to store Not started

Odoo Modules Installed

Module Purpose
Point of Sale Touchscreen POS terminal
Inventory Stock management
Accounting Financial management, taxes
Website Online store capability (optional)
Honduras SAR CAI invoice compliance (custom)

Odoo Community Edition Limitations

These features are Enterprise-only and NOT available:

  • Offline POS mode (requires internet)
  • IoT box integration (direct hardware management)
  • Loyalty programs / gift cards
  • Kitchen display
  • Advanced restaurant features

Hardware (barcode scanner, receipt printer) connects directly to the browser/OS — not through Odoo IoT box.

Credentials

System User Password Notes
Odoo Web admin admin Must change for production
PostgreSQL odoo odoo Internal Docker network only

Project History

Date Milestone
Jan 9, 2026 Original Access database received from client (205 MB)
Jan 10-12 First attempt: OSPOS — archived (poor touchscreen support)
Jan 13 Chromis POS evaluated — rejected
Jan 26 Odoo 17 selected, Docker environment created
Jan 26 Data converted from legacy CSV to Odoo format
Jan 27 All modules installed, company configured, data imported
Jan 27 Custom Honduras SAR module built and installed
Jan 27 System marked “Ready for Testing”
Feb 27 Git repository created on GitHub