Apskel POS Flutter

Aplikasi Point of Sale (POS) berbasis Flutter untuk manajemen kasir restoran. Mendukung manajemen order, produk, meja, pelanggan, pembayaran, printer bluetooth/network, analitik, dan push notification via FCM.

---

Fitur Utama

• Autentikasi — Login dengan email & password, logout, session management
• Order Management — Buat, kelola, dan proses order
• Produk & Kategori — Manajemen menu dan kategori produk
• Meja — Manajemen meja restoran
• Pelanggan — Data pelanggan dan riwayat transaksi
• Checkout & Pembayaran — Proses checkout dengan berbagai metode pembayaran
• Split Bill — Pembagian tagihan
• Void & Refund — Pembatalan dan pengembalian transaksi
• Printer — Cetak struk via Bluetooth dan Network printer
• Analitik — Dashboard, laporan penjualan, produk, kategori, payment method, profit/loss, inventory
• Sinkronisasi — Sinkronisasi data offline/online
• Push Notification (FCM) — Notifikasi real-time via Firebase Cloud Messaging

---

Tech Stack

Kategori	Library
State Management	flutter_bloc + bloc
Dependency Injection	get_it + injectable
Navigation	auto_route
HTTP Client	dio
Local Database	sqflite
Local Storage	shared_preferences
Firebase	firebase_core, firebase_crashlytics, firebase_messaging
Push Notification	flutter_local_notifications
Device Info	device_info_plus, package_info_plus
Code Generation	freezed, json_serializable
Printer	print_bluetooth_thermal, flutter_esc_pos_network
Chart	fl_chart
Connectivity	connectivity_plus

---

Arsitektur

Project menggunakan Clean Architecture dengan 4 layer:

lib/
├── application/        # BLoC — state management per fitur
├── domain/             # Entity, repository interface, failure
├── infrastructure/     # Implementasi repository, DTO, datasource
├── presentation/       # UI — pages, components, router
└── common/             # Shared utilities, DI modules, service, theme

Struktur per Fitur

feature/
├── application/
│   └── feature_bloc.dart         # BLoC
├── domain/
│   ├── entities/                 # Domain model (freezed)
│   ├── repositories/             # Interface repository
│   └── failures/                 # Failure types
└── infrastructure/
    ├── datasources/
    │   ├── remote_data_provider.dart
    │   └── local_data_provider.dart
    ├── dtos/                     # Data Transfer Object (json_serializable)
    └── repositories/             # Implementasi repository

---

Setup & Menjalankan

Prasyarat

• Flutter SDK ^3.8.1
• Dart SDK ^3.8.1
• Android SDK / Xcode (untuk iOS)
• Firebase project yang sudah dikonfigurasi

Instalasi

# Clone repository
git clone <repo-url>
cd apskel-pos-flutter-v2

# Install dependencies
flutter pub get

# Generate kode (freezed, injectable, auto_route, json_serializable)
dart run build_runner build --delete-conflicting-outputs

Menjalankan App

# Development
flutter run

# Release
flutter run --release

App otomatis menggunakan environment dev saat debug dan prod saat release.

---

Environment

Konfigurasi environment ada di lib/env.dart:

Environment	Base URL	Database
dev	https://api-pos.apskel.id	apskel_pos_dev.db
prod	https://api-pos.apskel.id	apskel_pos_dev.db

Environment dipilih otomatis di main.dart:

await configureDependencies(
  kReleaseMode ? Environment.prod : Environment.dev,
);

---

Dependency Injection

DI menggunakan get_it + injectable. Semua service, repository, dan BLoC didaftarkan via annotation.

Modul DI

File	Isi
di_firebase.dart	FirebaseMessaging, FlutterLocalNotificationsPlugin, DeviceInfoPlugin, PackageInfo
di_dio.dart	Dio HTTP client
di_shared_preferences.dart	SharedPreferences
di_database.dart	DatabaseHelper (SQLite)
di_auto_route.dart	AppRouter
di_connectivity.dart	Connectivity

Setelah menambah atau mengubah class yang menggunakan annotation injectable, jalankan:

dart run build_runner build --delete-conflicting-outputs

---

Firebase & FCM

Setup

Firebase sudah dikonfigurasi di android/app/google-services.json. Inisialisasi dilakukan di main.dart sebelum app berjalan.

FCM Service

FcmService (lib/common/service/fcm_service.dart) menangani:

• Request permission notifikasi (Android 13+ / iOS)
• Ambil dan log FCM token
• Foreground notification via flutter_local_notifications
• Background & terminated message handler
• Subscribe/unsubscribe topic

FCM token dikirim ke server saat login bersama device info.

Login Payload

Saat login, app mengirim data berikut ke API:

{
  "email": "user@example.com",
  "password": "secret",
  "fcm_token": "dXj3k9...",
  "device_id": "abc123",
  "device_name": "Samsung Galaxy Tab S8",
  "device_type": "tablet",
  "platform": "android",
  "app_version": "1.0.4+9",
  "os_version": "Android 13 (SDK 33)"
}

Nilai valid: device_type → mobile | tablet | desktop, platform → android | ios | web

---

Printer

Mendukung dua jenis printer:

• Bluetooth — via print_bluetooth_thermal
• Network (LAN) — via flutter_esc_pos_network

---

Orientasi Layar

App dikunci ke mode landscape (kiri & kanan) karena didesain untuk tablet POS.

---

Catatan Development

• Jangan edit injection.config.dart dan file *.freezed.dart / *.g.dart secara manual — file tersebut di-generate otomatis
• Gunakan log() dari dart:developer untuk logging, bukan print()
• print() dinonaktifkan di release mode