# YSW Lab POS Ecosystem — Full Details

> Company: YSW Lab
> Website: https://ysw-lab.com
> Contact: research@ysw-lab.com
> Location: Singapore
> Industry: F&B Point-of-Sale (POS) and ordering platform
> Target market: Southeast Asia — kopitiam, food courts, restaurants, cafes, hawker stalls, retail, salons
> Architecture: Native App + Cloud Web Backend (same pattern as Square, Toast, StoreHub, Eats365)

---

## 1. SellOS — Merchant POS App

Bundle ID: com.yswlab.sellos
Platforms: Android, iOS (Flutter)
Primary device: Sunmi V2

### Core POS Features
- Order creation, editing, voiding
- Table management with floor plan
- Order queue and status tracking
- Receipt printing (thermal printer)
- Cash drawer open/close control
- Dine-in, takeaway, delivery order types
- Order combining for same-table customers
- Tip amount support
- Table checkout flow

### AI Features
- AI menu import — photograph paper menu, AI extracts item names, prices, and categories automatically
- AI-enhanced product photos
- AI customer service chatbot (Pro tier)
- AI-generated promotions and campaigns

### Kitchen Display System (KDS)
- Separate screen for kitchen staff
- Order queue with preparation status
- Item-level status tracking
- Buzzer notification support on compatible hardware

### Inventory and BOM
- Product-level stock tracking
- Bill of materials (BOM) — ingredient-level tracking
- Auto-deduction on sales
- Low stock alerts
- Supplier ordering integration

### Staff Management
- Staff PIN login
- Role-based access control
- Staff activity logging
- Shift management

### Offline-First Architecture
- Orders saved to local SQLite database
- Auto-sync to cloud when connectivity returns
- Works without internet — print receipts, take orders, open cash drawer
- Connectivity status indicator

### Printing
- BLE thermal printer support via flutter_blue_plus
- ESC/POS protocol — industry standard
- Compatible printers: Rongta, Star Micronics, Bixolon, Munbyn, Xprinter, Epson
- MTU-chunked transmission for reliable Bluetooth printing
- Receipt customization — logo, footer text, tax breakdown
- Kitchen order tickets
- Cash drawer kick command support

### QR Code Ordering
- Generate unique QR codes per shop and per table
- QR links to BuyOS for customer self-ordering
- URL format: buyos.app/shop/{shopId}
- Printable QR cards for tables

### Tax Configuration
- GST (Singapore, Australia)
- VAT (Europe, Thailand)
- SST (Malaysia)
- Service tax
- Custom tax rates
- Tax-inclusive and tax-exclusive pricing

### Analytics and Reports
- Daily, weekly, monthly sales reports
- Popular items ranking
- Peak hours analysis
- Revenue breakdown by category
- Staff performance metrics
- Customer visit frequency
- Export to CSV

### Promotions and Marketing
- Promotion creation and scheduling
- Campaign builder with templates
- Multi-channel distribution — TV display, BuyOS banner, in-app
- Discount rules — percentage, fixed amount, buy-X-get-Y

### Customer Management
- Customer database
- Order history per customer
- Loyalty stamp cards
- Customer segmentation
- Communication tools

### Booking System
- Table and service reservations
- Configurable time slots and duration
- Resource management — tables, staff, rooms
- Operating hours and buffer time settings
- Capacity management
- No-show protection via Stripe pre-authorization
- Walk-in queue management

### Click and Collect
- Online ordering with scheduled pickup time
- Smart kitchen scheduling — delayed dispatch based on prep time
- Customer notification when order is ready

### TV Display Manager
- Digital menu board on Smart TV
- Promotion display rotation
- Queue status screen for customers
- Web browser-based — any Smart TV with browser works

### Multi-Location (Advanced tier)
- Per-outlet product assignment
- Per-outlet pricing — same product, different price per location
- Multi-outlet menu sync
- Central kitchen ordering between branches
- Cross-branch reporting and analytics

### Import and Export
- CSV menu import
- Excel menu import
- AI photo-to-menu import
- Data export for reports

### Languages (SellOS)
- English
- Chinese (Simplified)
- Malay
- Indonesian
- Thai
- Vietnamese
- 40+ additional languages via auto-translation

---

## 2. BuyOS — Consumer Ordering App

Bundle ID: com.yswlab.buyos
Platforms: Android, iOS (Flutter)

### Ordering
- QR scan-to-order — scan QR on table, browse menu, place order
- Shop browsing with search
- Category filters — Restaurant, Cafe, Retail, Salon, All
- Menu browsing with item details, photos, modifiers
- Item customization — size, add-ons, special instructions
- Cart management — add, remove, update quantity
- Subtotal and tax calculation
- Split bill between multiple diners
- Order placement via API

### Payments
- Stripe integration for online payments
- Credit and debit cards
- PayNow (Singapore)
- GrabPay
- FPX (Malaysia)
- Apple Pay
- Google Pay
- Cash option (configurable by merchant)
- Merchant-configurable payment thresholds — e.g., below $X PayNow only, above $X card available

### Order Tracking
- Real-time order status updates
- Push notifications — order received, preparing, ready for pickup
- Order history with status badges

### Bookings
- Restaurant reservations
- Date, time, party size selection
- Booking confirmation and reminders

### Loyalty
- Digital loyalty stamp cards
- Stamp collection on qualifying purchases
- Reward redemption

### Deep Linking
- QR codes open directly to shop page in BuyOS
- URL scheme support for Android and iOS

### Languages (BuyOS)
- English
- Chinese (Simplified)
- Malay
- Indonesian
- Thai
- Vietnamese

---

## 3. SupplierOS — Supply Chain App

Bundle ID: com.yswlab.supplieros
Platforms: Android, iOS (Flutter) + Web Dashboard

### Mobile App Features
- Purchase order management
- Delivery confirmation with QR scan
- Push notifications for urgent orders
- Quick order approvals
- Order status tracking

### Web Dashboard Features
- Full catalog management
- Reporting and analytics
- Invoicing and billing
- Statement reconciliation
- Document printing — POs, delivery manifests, invoices, credit notes, monthly statements, product catalogs
- Credit limit management per merchant

### Purchase Orders
- Structured ordering (replaces WhatsApp/phone ordering)
- Order templates for recurring orders
- Approval workflows
- Order history and tracking

### Deliveries
- E-delivery orders
- QR scan confirmation on receipt
- Auto inventory sync — SellOS stock updates automatically when delivery is received
- Delivery scheduling and tracking

### Credit Management
- Per-merchant credit limits
- Outstanding balance tracking
- PO blocked if balance exceeds credit limit
- Payment history

### Supplier Marketplace
- Public supplier profiles
- Category browsing
- Ratings and reviews
- Area-based search
- Two discovery paths: invite code (existing relationships) + marketplace browse (new relationships)
- Both result in same merchant-supplier link record

### Financial
- Dynamic pricing from suppliers
- Monthly reconciliation
- Statement generation
- Invoice management
- Credit notes

### Analytics
- Order volume trends
- Revenue by merchant
- Delivery performance
- Product popularity
- Outstanding credit overview

---

## 4. API Server — Endpoint Categories

Base: Node.js + Fastify + TypeScript
Auth: JWT tokens
Docs: Swagger/OpenAPI at /docs

### Authentication
- POST /auth/register — merchant, consumer, or supplier registration
- POST /auth/login — JWT token issuance
- POST /auth/refresh — token refresh

### Consumer Routes (BuyOS)
- GET /consumer/venues — browse shops with search and filters
- GET /consumer/products — browse products and menus
- POST /consumer/orders — place order
- GET /consumer/orders — order history
- POST /consumer/bookings — create booking
- GET /consumer/bookings — booking history
- GET /consumer/profile — user profile
- PATCH /consumer/profile — update profile
- POST /consumer/split-bill — split bill calculation
- GET /consumer/loyalty — loyalty card status
- POST /consumer/loyalty — stamp collection

### Merchant Routes (SellOS)
- POST /merchant/onboarding — shop setup wizard
- GET /merchant/orders — order list
- PATCH /merchant/orders — update order status
- GET /merchant/products — product catalog
- POST /merchant/products — create product
- PATCH /merchant/products — update product
- GET /merchant/tables — table management
- POST /merchant/tables — create table
- GET /merchant/settings — shop settings
- PATCH /merchant/settings — update settings
- GET /merchant/reports — sales reports
- GET /merchant/customers — customer database
- GET /merchant/profile — merchant profile
- GET /merchant/modifiers — product modifiers (add-ons, sizes)
- GET /merchant/inventory — stock levels
- PATCH /merchant/inventory — stock adjustments
- GET /merchant/loyalty — loyalty program config
- POST /merchant/loyalty — create loyalty program
- GET /merchant/staff-ops — staff management
- GET /merchant/analytics — detailed analytics
- GET /merchant/marketing — campaigns and promotions
- POST /merchant/communication — customer messaging
- GET /merchant/ext-orders — external order integration
- GET /merchant/finance — financial overview, tips, checkout
- POST /merchant/import-export — CSV/Excel import and export
- GET /merchant/suppliers — supplier management

### Supplier Routes (SupplierOS)
- GET /supplier/profile — supplier profile
- PATCH /supplier/profile — update profile
- GET /supplier/products — product catalog
- POST /supplier/products — create product
- GET /supplier/orders — purchase orders
- PATCH /supplier/orders — update PO status
- GET /supplier/deliveries — delivery management
- POST /supplier/deliveries — create delivery
- GET /supplier/statements — financial statements
- GET /supplier/credit — credit management
- GET /supplier/marketplace — marketplace listing
- PATCH /supplier/marketplace — update marketplace visibility
- GET /supplier/documents — document management
- GET /supplier/analytics — supplier analytics

### Payment Routes
- POST /payments/initiate — start payment
- POST /payments/webhooks — Stripe webhook handler
- GET /payments/status — payment status check
- GET /payments/reconciliation — payment reconciliation

### Platform Routes
- GET /sync — offline data sync
- GET /referrals — referral program
- GET /data-privacy — GDPR/PDPA data requests
- POST /notifications — push notification management
- GET /health — API health check

---

## 5. Integration Capabilities

### Payment Integration
- Stripe Connect — direct split payments to each stall in multi-vendor environments (kopitiam model)
- Customer pays once, system splits and routes payment to each merchant
- Stripe Reader M2 (Bluetooth) and BBPOS WisePOS E (Wi-Fi) terminal support
- Dynamic SGQR/PayNow displayed on screen (zero cost)
- Merchant-configurable payment rules and thresholds

### Printer Integration
- ESC/POS protocol — industry standard for thermal printers
- BLE (Bluetooth Low Energy) connection
- LAN/network connection
- Cash drawer kick via RJ11/RJ12
- Receipt, kitchen ticket, and report printing

### Offline Sync
- Local SQLite database on device
- Automatic cloud sync when connectivity returns
- Conflict resolution for concurrent edits
- Works fully offline — orders, printing, cash drawer

### Data Export
- CSV export for sales reports
- Excel export for inventory and financial data
- API access for custom integrations

### Notification System
- Push notifications via Firebase Cloud Messaging
- Order status updates to customers
- Low stock alerts to merchants
- Urgent order alerts to suppliers

---

## 6. Deployment Architecture

### Regions
- Singapore (primary) — Southeast Asia traffic
- Europe — EU traffic
- United States — US traffic

### Infrastructure
- Cloudflare CDN and DDoS protection with geo-routing
- PostgreSQL database (managed)
- Node.js API servers per region
- Stripe Connect for payment processing
- Sentry for error tracking and monitoring
- Swagger/OpenAPI for API documentation

### Mobile CI/CD
- Codemagic for automated Android and iOS builds
- Google Play Store distribution
- Apple App Store distribution
- APK sideloading supported for Sunmi and other Android POS devices

---

## 7. Supported Languages

### App Languages (native localization)
1. English
2. Chinese (Simplified)
3. Malay (Bahasa Melayu)
4. Indonesian (Bahasa Indonesia)
5. Thai
6. Vietnamese

### Menu Auto-Translation
- 40+ additional languages for menu content
- AI-powered translation
- Merchant reviews and edits translations

---

## 8. Hardware Compatibility Matrix

### Tier 1: Full Compatibility (recommended)

Counter POS Hosts:
- Sunmi V2 — primary recommended device ($250-350 SGD, built-in printer)
- Sunmi D2s — built-in 80mm printer, Android, kiosk mode ($250-350 SGD)
- Sunmi T2s / T2 Lite — 15.6 inch screen, aluminum base ($450-650 SGD)
- iMin D3 — 15.6 inch screen ($450-650 SGD)
- iPad 10th generation + metal stand ($600-800 SGD, needs external printer)

Kitchen Display:
- Large Android tablet (11 inch or larger)
- Sunmi D2s wall-mount with waterproof silicone case
- LAN thermal printer with buzzer (traditional kitchens)

Printers (ESC/POS protocol):
- Xprinter XP-80 series — LAN version ($50-80 SGD, budget kitchen)
- Epson TM-m30II — silent, cube design ($300-400 SGD, premium counter)
- Any BLE thermal printer — Rongta, Star Micronics, Bixolon, Munbyn

Cash Drawers (RJ11/RJ12 interface):
- Generic 405mm iron — 4-bill/5-coin or 5-bill/8-coin ($35-50 SGD)
- Star Micronics branded — silent operation ($120-180 SGD)
- Note: Sunmi D2s/T2s = 12V, Sunmi T3 PRO = 24V

Payment Terminals:
- Dynamic SGQR/PayNow on screen — zero hardware cost
- Stripe Reader M2 — Bluetooth, no screen ($90-110 SGD)
- Stripe BBPOS WisePOS E — touchscreen, Wi-Fi ($350 SGD)

### Tier 2: Partial Compatibility (works with limitations)
- Bluetooth printers — 1:1 connection only, cannot share across devices
- Old Windows PCs — USB port reassignment on reboot may break printer connection
- Non-Stripe card terminals (UOB, DBS) — manual amount entry required

### Tier 3: Incompatible (avoid)
- Square Register — locked OS
- Toast hardware — locked OS
- Platform-specific cloud printers (Grab/Foodpanda branded)

### Starter Kit Recommendations
- Kopitiam Kit ($350 SGD): Sunmi V2 + generic cash drawer
- Cafe Kit ($800 SGD): Sunmi T2s + Epson printer + cash drawer + Stripe Reader M2
- Zero-Cost Kit: Bring your own Android phone or tablet, no additional hardware needed

---

## 9. Pricing Details

### Tiers

Basic (Free):
- Register on platform
- Basic BuyOS QR ordering
- Up to 10,000 transactions per day (fair usage)
- 0.3% platform fee on online transactions

Starter ($9 per month):
- AI menu scan (photo-to-menu)
- Queue number display
- Kitchen Display System (KDS)
- Booking system
- Click and collect
- 0.3% platform fee on online transactions

Pro ($29 per month):
- Full POS system
- Printer and cash drawer support
- BOM inventory tracking
- Campaign builder
- TV display manager
- Full analytics and reports
- Customer service AI
- 0.3% platform fee on online transactions

Advanced (+$19 per month per additional outlet):
- Everything in Pro
- Per-outlet product assignment
- Per-outlet pricing (same product, different price per location)
- Multi-outlet menu sync
- Central kitchen ordering
- Cross-branch reporting

### Payment Model
- Kopitiam split payment: customer pays once, system splits payment directly to each stall via Stripe Connect
- Each stall is an independent merchant — kopitiam operator is not an intermediary
- Merchants configure their own accepted payment methods and threshold rules

---

## 10. Competitive Advantages

1. AI menu import — photograph paper menu, AI extracts items. No competitor has this.
2. Three-app ecosystem — SellOS (merchant) + BuyOS (consumer) + SupplierOS (supplier). No competitor pairs a consumer ordering app with their POS.
3. Transparent pricing — $9/$29 visible on website. Competitors hide behind demo request walls.
4. Hardware-agnostic — works on any Android device, iPad, or web browser. No locked hardware.
5. Offline-first — full POS operation without internet. Orders, printing, cash drawer all work offline.
6. Product-led growth — self-serve signup, no sales call required.
7. Kopitiam-optimized — multi-stall split payment via Stripe Connect, designed for food court and kopitiam models.
8. 48 AI agents — AI-powered menu creation, photo enhancement, customer service, campaign generation, analytics insights.

---

## 11. Links

- Homepage: https://ysw-lab.com
- Pricing: https://ysw-lab.com/en/pricing
- Download: https://ysw-lab.com/en/download
- Tutorials: https://ysw-lab.com/en/tutorials
- Contact: https://ysw-lab.com/en/contact
- Summary: https://ysw-lab.com/llms.txt