Archidemia Pos - POS + ERP System (Flutter iOS App)

1. Overview

We are building a Point of Sale (POS) + ERP-style iOS application using Flutter (iOS-first). The app will support:

• User management (admins, employees, customers)
• Product and stock management
• Orders, tickets, and receipts
• Hardware integration (printers, scanners, card machines)
• WooCommerce synchronization (products, stock, orders, VAT rules, refunds)
• Payment handling and reporting
• VAT validation (EU + Georgia rules)
• Security and offline support

The system will integrate with WooCommerce (core sync), Supabase (auth, database, real-time sync), and hardware devices (Star printers, SumUp, SocketMobile).

Xero integration is not required (plugins already handle invoice generation). Instead, the focus is on ensuring compatibility with the WooCommerce “PDF Invoice” and “EU VAT Number” plugins.

---

2. System Architecture

• Frontend: Flutter (iOS-first).
• Backend & Database: Supabase (auth, real-time sync, local storage for offline mode).
• WooCommerce: Sync products, stock, orders, VAT, refunds.

---

3. Database

• Supabase for authentication, user management, stock, and order sync.
• Local storage layer for offline mode (orders, tickets).

---

4. Integrations

WooCommerce API

• Products & stock synchronization (bi-directional):

  • Changes in POS → reflect in WooCommerce.
  • Changes in WooCommerce → reflect in POS.

• Orders & refunds:

  • POS order creation → new WooCommerce order with customer, VAT, and product details.
  • POS refund → WooCommerce order note (refunded).

• VAT handling:

  • Books = reduced VAT (4% in EU, VAT-exempt in Georgia).
  • Other products = 21% VAT.
  • Plugin support: EU VAT Number.

• Webhooks or periodic jobs for synchronization.

Hardware Devices

• Printers: ESC/POS + Star printers (docs).
• Card machines: SumUp (API).
• Scanners: Socket Mobile (docs).

VAT Validation

• EU VAT validation via VIES API.

• Georgia VAT rules:

  • Standard VAT = 18%.
  • Printed books = VAT-exempt (Article 172, Georgian Tax Code).

---

5. UI/UX

The app will follow standard POS design flows, with inspiration from Loyverse POS.

Key screens:

• Login & User Management
• Dashboard
• POS screen (add to cart, save ticket, print receipt)
• Orders & Refunds
• Inventory & Stock Management
• Customers & Employees
• Reports & VAT breakdown

---

6. Development Order

1. Design UI/UX, database schema, wireframes.
2. Implement user management & login.
3. Stock, customer, and employee modules.
4. Item management (with VAT classes).
5. WooCommerce integration.
6. Reporting system.
7. Security hardening.
8. Payment feature.
9. Hardware integration (printers, scanners, SumUp).
10. Ticket management (save orders, print receipts in Loyverse style).
11. Staging testing.
12. Live testing & deployment.

---

7. Special Notes

• Hardware integration is critical. Without proper printer, scanner, and card machine support, the project cannot be considered complete.
• Xero integration is not required (WooCommerce plugin already generates invoices).
• Refunds and VAT rules must strictly follow WooCommerce plugin behavior.
• Multi-VAT handling must reflect both EU and Georgian requirements.
• Orders must only sync to WooCommerce after successful payment in POS.

---

8. Configuration Details

WooCommerce (Staging)

• URL: https://staging2.archidemia.com/wp-json/wc/v3
• Consumer Key: ck_eda7c07cdfc69d68d469329e4af901833fa745aa
• Secret Key: cs_fe5d57e6a17335c1463aa9790fb9dc08e271e2a3
• Switching logic: Only one WooCommerce API (staging/live) can be active at a time.

Supabase

static const supabaseUrl = 'https://tccdogfoljnyliwkcgwn.supabase.co';
static const supabaseAnonKey =
    'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InRjY2RvZ2ZvbGpueWxpd2tjZ3duIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTU2OTU1MzAsImV4cCI6MjA3MTI3MTUzMH0.c1CN9rimUwgG__p2FvW3Ng1ncs27A7YHoIBNMrX1Qbw';