BSR POS Wiki

This site is the internal wiki for the bsr-pos-plus monorepo. It is intended to become the single place for system structure, operator workflows, setup notes, and deployment-sensitive reminders.

Scope

• Mobile POS application in apps/mobile
• POS terminal application in apps/pos-terminal
• Shared workspace packages in packages/*
• Android setup and machine migration notes
• Core business workflows such as sales, checkout, and peripheral interactions

Start here

• System overview
• Mobile and terminal architecture
• Sales workflow
• Goods receipt workflow
• Login to home workflow
• Home menu and permissions
• Mobile transport and vehicles
• Android setup
• Machine migration checklist
• Wiki maintenance policy
• Change log

Documentation principles

• Keep diagrams close to the markdown page that explains them.
• Prefer Mermaid for architecture and workflow diagrams so changes can be reviewed in Git.
• Keep setup docs machine-agnostic where possible.
• Record repo-specific exceptions explicitly when a path, toolchain, or release step differs from the default.
• When a system flow changes in the app, update the corresponding wiki page in the same task by default.