​

Frequently Asked Questions (FAQ)

​

📱 General

​

Apa itu MStore Mobile?

​

Platform apa saja yang didukung?

• iOS 12.0 ke atas
• Android 5.0 (API 21) ke atas
• Web (Chrome, Safari, Firefox)
• Windows 10 ke atas
• macOS 10.14 ke atas

​

Apakah MStore bisa digunakan offline?

​

Berapa biaya MStore Mobile?

​

🚀 Installation & Setup

​

Bagaimana cara install MStore Mobile?

# Clone repository
git clone <repository-url>

# Install dependencies
flutter pub get

# Generate code
flutter pub run build_runner build --delete-conflicting-outputs

# Run app
flutter run --flavor development -t lib/main_development.dart

​

Apa saja requirement untuk development?

• Flutter SDK 3.8+
• Dart SDK 3.8+
• Xcode 14+ (untuk iOS)
• Android Studio (untuk Android)
• CocoaPods (untuk iOS)

​

Bagaimana cara setup Firebase?

1. Buat project di Firebase Console
2. Download konfigurasi:
   • iOS: GoogleService-Info.plist
   • Android: google-services.json
3. Letakkan di folder yang sesuai
4. Enable Firebase services (Auth, Firestore, FCM, Crashlytics)

​

💻 Development

​

Bagaimana cara menambahkan fitur baru?

1. Buat branch baru: git checkout -b feature/nama-fitur
2. Ikuti struktur folder yang ada
3. Implement dengan BLoC pattern
4. Tambahkan unit tests
5. Update dokumentasi
6. Create pull request

​

Bagaimana cara menjalankan tests?

# Run all tests
flutter test

# Run specific test
flutter test test/features/product/bloc/product_bloc_test.dart

# Run with coverage
flutter test --coverage

# View coverage
genhtml coverage/lcov.info -o coverage/html
open coverage/html/index.html

​

Bagaimana cara generate code?

# One-time generation
flutter pub run build_runner build --delete-conflicting-outputs

# Watch mode (auto-generate on file changes)
flutter pub run build_runner watch --delete-conflicting-outputs

​

Kenapa build_runner error “Conflicting outputs”?

flutter pub run build_runner build --delete-conflicting-outputs

​

🏗️ Architecture

​

Apa arsitektur yang digunakan?

• Presentation Layer: UI, Widgets, BLoC
• Domain Layer: Business Logic, Use Cases, Entities
• Data Layer: Repository, API, Database

​

Mengapa menggunakan BLoC?

• ✅ Separation of concerns
• ✅ Testability
• ✅ Reusability
• ✅ Predictable state management
• ✅ Easy debugging

​

Bagaimana cara kerja offline-first?

1. Data disimpan di local database (Isar)
2. UI membaca dari local database
3. Background sync dengan API
4. Conflict resolution otomatis
5. Real-time updates via MQTT

​

🔐 Authentication

​

Bagaimana cara login?

• Email/Password
• Google Sign-In
• Apple Sign-In

// Email/Password
await authRepository.login(
  LoginRequest(email: email, password: password),
);

// Google Sign-In
await authRepository.signInWithGoogle();

// Apple Sign-In
await authRepository.signInWithApple();

​

Bagaimana token management?

• Access Token: Short-lived (15 menit)
• Refresh Token: Long-lived (30 hari)
• Auto-refresh: Handled by RefreshTokenInterceptor
• Storage: Encrypted di Isar database

​

Apa yang terjadi saat token expired?

1. Detect HTTP 401 response
2. Call refresh token endpoint
3. Update tokens
4. Retry original request
5. Jika refresh gagal → logout user

​

💳 Cashier & Transactions

​

Bagaimana cara melakukan transaksi?

1. Buka halaman Cashier
2. Cari dan tambahkan produk ke cart
3. Atur quantity jika perlu
4. Klik Checkout
5. Pilih metode pembayaran
6. Input jumlah bayar (untuk cash)
7. Process payment
8. Print receipt (opsional)

​

Apakah bisa scan barcode?

​

Metode pembayaran apa saja yang didukung?

• Cash
• Debit/Credit Card
• E-Wallet (GoPay, OVO, Dana, dll)
• Bank Transfer
• QRIS

​

Bagaimana cara print receipt?

1. Pair Bluetooth thermal printer
2. Configure di Settings → Printer
3. Receipt akan auto-print setelah transaksi
4. Atau manual print dari Transaction History

​

📦 Inventory

​

Bagaimana cara menambah produk?

1. Buka Inventory → Products
2. Klik tombol “Add Product”
3. Isi form (nama, SKU, harga, stok, dll)
4. Upload foto (opsional)
5. Save

​

Bagaimana cara stock opname?

1. Buka Inventory → Stock Opname
2. Pilih produk
3. Input actual stock
4. System akan create adjustment otomatis
5. Review dan approve

​

Bagaimana cara set low stock alert?

​

📊 Reports & Analytics

​

Report apa saja yang tersedia?

• Sales Report: Revenue, transactions, trends
• Inventory Report: Stock levels, movements
• Financial Report: Profit, expenses, cash flow
• Product Report: Top sellers, slow movers
• Employee Report: Performance, transactions

​

Bagaimana cara export report?

1. Buka report yang diinginkan
2. Set date range dan filters
3. Klik tombol Export
4. Pilih format (PDF/Excel)
5. File akan di-download

​

Apakah ada dashboard real-time?

• Today’s revenue
• Transaction count
• Top products
• Low stock alerts
• Recent transactions

​

🖨️ Printer

​

Printer apa yang didukung?

• Epson TM-T82
• Star TSP143III
• Zebra ZD410
• Generic 58mm/80mm thermal printers

​

Bagaimana cara connect printer?

1. Pair printer via Bluetooth settings
2. Buka Settings → Printer
3. Scan for devices
4. Select printer
5. Test print

​

Print tidak keluar, kenapa?

1. ✅ Printer paired dan connected
2. ✅ Printer has paper
3. ✅ Bluetooth permissions granted
4. ✅ Printer turned on
5. ✅ Try test print

​

🌐 Network & Sync

​

Bagaimana cara kerja sync?

1. Write: Data ditulis ke local database
2. Queue: Request di-queue untuk sync
3. Sync: Background job sync ke API
4. Retry: Auto-retry jika gagal
5. Conflict: Last-write-wins strategy

​

Apa itu MQTT dan untuk apa?

• Real-time inventory updates
• Transaction notifications
• System announcements
• Multi-device sync

​

Bagaimana jika sync conflict?

• Server timestamp digunakan sebagai reference
• Local data di-override dengan server data
• Conflict log disimpan untuk audit

​

🔧 Troubleshooting

​

App crash saat startup

1. Check logs: flutter logs
2. Clear app data
3. Reinstall app
4. Check Firebase configuration
5. Verify API endpoint

​

Data tidak sync

1. Check internet connection
2. Verify API credentials
3. Check sync queue: Settings → Sync Status
4. Manual sync: Pull to refresh
5. Clear cache dan re-sync

​

Build failed

# Clean and rebuild
flutter clean
flutter pub get
flutter pub run build_runner build --delete-conflicting-outputs
flutter run

​

🔒 Security

​

Apakah data aman?

• ✅ HTTPS untuk semua komunikasi
• ✅ JWT token authentication
• ✅ Encrypted local storage
• ✅ Role-based access control
• ✅ Audit logging

​

Bagaimana cara backup data?

1. Settings → Backup & Restore
2. Export data
3. Save to secure location

​

Apa yang terjadi jika device hilang?

1. Login dari device lain
2. Revoke access dari device lama
3. Data tetap aman di cloud
4. Transaction history tetap tersimpan

​

📞 Support

​

Bagaimana cara mendapat bantuan?

• 📖 Baca Documentation
• 💬 Internal Slack channel
• 📧 Email: [email protected]
• 🐛 Report bug via issue tracker

​

Bagaimana cara request fitur baru?

1. Check roadmap untuk planned features
2. Create feature request di issue tracker
3. Describe use case dan benefit
4. Team akan review dan prioritize

​

Dimana saya bisa belajar lebih lanjut?

• Getting Started Guide
• Architecture Overview
• Development Guidelines
• API Reference

​

📚 Additional Resources

• Flutter Documentation
• BLoC Library
• Firebase Documentation
• Dio Package