LokBar POS - Server + Tablet

Offline pokladní a skladový systém pro stánkový prodej. Server běží na notebooku u stánku, tablety ve stánku se připojují přes lokální Wi-Fi.

Struktura projektu

LokBar_POS/
  server/              # Dart backend (API + databáze)
  apps/tablet/         # Flutter POS klient pro Android tablet
  packages/lokbar_api/ # Sdílené API modely
  docs/                # Dokumentace
  scripts/             # Bootstrap skripty

Požadavky

• Flutter SDK (stable)
• Dart SDK (součást Flutter)
• Android tablet nebo emulátor pro klienta
• Windows notebook pro server

Rychlý start

1. Bootstrap (jednorázově)

scripts\bootstrap.bat

2. Spuštění serveru (notebook u stánku)

cd server
dart run bin/server.dart

Server naslouchá na http://0.0.0.0:8080.

3. Spuštění tabletu

cd apps\tablet
flutter run

V nastavení tabletu zadej IP adresu notebooku, např. http://192.168.1.100:8080.

Síť na akci

1. Notebook vytvoří Wi-Fi hotspot nebo je oba připojené ke stejné síti.
2. Zjistěte IP notebooku (ipconfig na Windows).
3. Na tabletu nastavte tuto adresu v Nastavení serveru.
4. Úvodní obrazovka zobrazí stav připojení.

Dokumentace

• docs/01_PRD.md — požadavky
• docs/02_ARCHITEKTURA.md — původní feature-first návrh
• docs/06_SERVER_TABLET_ARCHITEKTURA.md — server + tablet model
• docs/04_ROADMAPA.md — vývoj po etapách

Vývoj

Po každé etapě:

dart format .
cd server && dart test
cd apps\tablet && flutter analyze && flutter test

Aktuální stav

Etapa 0 — server health API + tablet klient s kontrolou připojení.