Remix

Make your own version of Beje Ops Hub

Edit the prompt below and generate a customized version in seconds.

Original by Fatyah Al Buchori

Describe your app

# Struktur Proyek Beje Tracking System (Update Master Table & Upsert)

Dokumentasi ini adalah sumber kebenaran tunggal untuk arsitektur direktori dan alur kerja sistem **Beje Tracking System** yang dirancang untuk skala produksi.

## 📁 Root Directory
- `.env` - Kredensial Turso DB, Firebase Admin (Auth), ImageKit, dan Google GenAI (Gemini).
- `db.sh` - Skrip pembantu untuk operasi database (Push & Generate). **Catatan: Jalankan 'chmod +x db.sh' sebelum digunakan.**
- `firestore.rules` - Aturan keamanan Firebase Firestore (RBAC untuk notifikasi).
- `drizzle.config.ts` - Konfigurasi sinkronisasi Drizzle ORM dengan Turso.
- `package.json` - Daftar dependensi utama (Next.js 15, Firebase SDK, ImageKit, Drizzle, Genkit).

## 📁 src/ (Source Code)

### 📂 app/ (Sektor Monitoring & UI Routes)
- `page.tsx` - **Dashboard Utama**: Ringkasan statistik operasional, pendapatan, dan alert kritis.
- `layout.tsx` - Root Layout dengan Firebase Client Provider & Global Error Listener.
- `globals.css` - Tema ShadCN (Custom HSL untuk Bahasa Indonesia).
- `verification/`
  - `page.tsx` - **Verifikasi Sebelum Packing**: Scan order untuk deteksi duplikat (Anti-Double).
- `orders/`
  - `page.tsx` - **Master Table Pesanan**: Tabel 63 kolom standar TikTok dengan fitur Sticky Column, Paginasi, dan Search.
  - `import/tiktok/`
    - `page.tsx` - **TikTok Order Import**: Fitur Bulk Import (Upsert dari Excel/File) dan Manual Form detail dengan Accordion.
- `shipments/`
  - `page.tsx` - **Monitoring Pengiriman**: Pantau status kurir secara real-time.
  - `stale/`
    - `page.tsx` - **Paket Tertahan**: Fokus pada resi yang macet >3 hari (Anti-Lost).
- `issues/`
  - `page.tsx` - **Log Kendala**: Pusat investigasi paket hilang/rusak dan komplain customer.
- `returns/`
  - `page.tsx` - **Manajemen Retur**: Validasi barang kembali (QC) dan status refund.
- `reports/`
  - `page.tsx` - **Rekonsiliasi**: Audit data keuangan marketplace vs realita stok.
- `api/` (Route Handlers)
  - `orders/`
    - `route.ts` - CRUD Pesanan (Dukungan 63 kolom).
    - `bulk/route.ts` - Logika **Upsert Bulk** (Batch processing 100 baris).
    - `check/route.ts` - Validasi duplikasi Order ID real-time.
  - `notifications/` - API polling notifikasi real-time.

### 📂 modules/ (Sektor Logika Bisnis)
- `orders/`
  - `orders.service.ts` - Logika `checkDuplicate()` dan sinkronisasi data TikTok (Bulk/Manual).
  - `orders.repository.ts` - Query Drizzle dengan `.onConflictDoUpdate()` untuk stabilitas data (Upsert).
- `shipments/`
  - `shipments.service.ts` - Logika `detectStaleShipments()` untuk memicu auto-issue.
- `returns/`
  - `returns.service.ts` - Logika validasi kondisi barang vs pengembalian stok.
- `issues/`
  - `issues.repository.ts` - Penyimpanan log investigasi kurir.

### 📂 db/ (Database Layer)
- `schema.ts` - Definisi tabel lengkap (63 kolom Orders dengan Indeks Performa).
- `index.ts` - Inisialisasi koneksi Turso DB (Pola Singleton untuk SaaS).

### 📂 firebase/ (Infrastruktur Auth & Firestore)
- `config.ts` - Konfigurasi Firebase SDK.
- `provider.tsx` - Context Provider untuk Auth & Firestore instances.
- `errors.ts` - Penanganan error permission Firestore secara kontekstual.
- `non-blocking-updates.tsx` - Utilitas update data Firestore (Optimistic UI).

### 📂 ai/ (GenAI Capability)
- `genkit.ts` - Inisialisasi Google Gemini Pro.
- `flows/`
  - `ai-alert-summarization-flow.ts` - AI Agent meringkas kendala kritis.

### 📂 lib/ (Utilities)
- `imagekit.ts` - SDK ImageKit untuk upload bukti foto paket/retur.
- `db-mock.ts` - Mock data untuk simulasi awal.

### 📂 components/ (UI Components)
- `ui/` - Komponen ShadCN (Tabs, Table, Card, Dialog, Badge, Calendar, dll).
- `layout/` - Header, Sidebar (Modular Nav), UserNav.
- `notifications/` - Bell notifikasi dengan audio feedback.
- `dashboard/` - Event Simulator untuk pengujian live.

---

## 🔄 Alur Kerja Sistem (Data Flow)
1. **Import TikTok**: Data masuk via Bulk Import (Excel/File) atau Manual -> Jalankan **Upsert** (Update jika nomor order sama, Insert jika baru).
2. **Master Monitoring**: Data tampil di `orders/page.tsx` dengan format 63 kolom persis Excel TikTok (Sticky Column).
3. **Anti-Double**: Verifikasi manual atau otomatis di `verification/` untuk mencegah kirim 2x.
4. **Anti-Lost**: `ShipmentsService` memantau paket macet (>3 hari) dan otomatis membuat `Issue` jika > 5 hari diam.
5. **QC Retur**: Barang kembali di-scan di `returns/`, divalidasi kondisinya, lalu stok diperbarui.

Free to use. No credit card required.