💬 Wuzz Chat — Actionable Knowledge Messaging Engine

Wuzz Chat adalah platform perpesanan real-time modern yang menggabungkan komunikasi instan 1-on-1 terenkripsi ujung-ke-ujung (E2EE P-256), obrolan grup terstruktur, forum topik efemeral, serta AI Memory Engine terkurasi dengan filosofi "AI captures. Humans validate. Wuzz remembers."

---

🏗️ Struktur Monorepo

wuzz-chat/
├── backend/                  # Modular Monolith Golang Backend (Go 1.26)
│   ├── cmd/                  # E2E simulation & load test entrypoints
│   ├── internal/
│   │   ├── ai/               # LLM Provider (Gemini 2.5 Flash, Groq), Processor & Prompts
│   │   ├── api/              # Thin HTTP REST Handlers (auth, chat, group, memory, media)
│   │   ├── app/              # Dependency injection container & bootstrap wire (wire.go)
│   │   ├── auth/             # JWT token utilities, CORS, & RequireJWT middleware
│   │   ├── authz/            # Identity & Auth domain service, sessions, devices, & repo
│   │   ├── broker/           # Pub/Sub broker (Upstash Redis & In-Memory fallback)
│   │   ├── group/            # Persistent group & ephemeral forum topic domain services
│   │   ├── memory/           # AI Memory Engine (ContextSource, jobs, drafts, review approval)
│   │   ├── messaging/        # Core chat messaging, search, edit, delete, pin, & receipts
│   │   ├── push/             # Multi-Platform Push Gateway (VAPID RFC 8292 & FCM v1 provider)
│   │   ├── shared/           # Shared cross-domain config, errors, validator, rate limiter
│   │   ├── storage/          # Media store-and-forward driver (Supabase, local) & purge worker
│   │   ├── store/            # Data layer (PostgreSQL Supabase, SQLite, In-Memory)
│   │   ├── worker/           # Background workers (memory job queue worker)
│   │   └── ws/               # WebSocket Hub, Client read/write pump, & message routing
│   ├── go.mod
│   ├── go.sum
│   └── main.go               # Slim bootstrap entrypoint & graceful shutdown
│
├── frontend/                 # Web Interface (Next.js 16 Turbopack + React 19 + TypeScript)
│   ├── app/
│   │   ├── chat/             # Dual-platform chat UI (desktop split 2-col & mobile single-screen)
│   │   ├── login/            # Halaman Login
│   │   ├── register/         # Halaman Registrasi
│   │   ├── transfer/         # Halaman deep link pemindahan kunci E2EE via QR code
│   │   ├── globals.css       # Soft tri-color glassmorphism design system & CSS tokens
│   │   └── layout.tsx
│   ├── lib/                  # WebSocket client, API helper, IndexedDB caches, Web Crypto E2EE
│   ├── server.js             # Custom server proxy untuk WebSocket upgrade & /api/ isolation
│   └── package.json
│
├── docs/                     # Dokumentasi Resmi & Source of Truth
├── .agents/                  # Workspace configuration & AI lifecycle rules
└── README.md

---

📚 Dokumentasi Proyek

Untuk memahami arah, tujuan, dan detail teknis proyek, silakan baca dokumentasi kanonikal:

• 📌 PROJECT_STATE.md — CANONICAL SINGLE SOURCE OF TRUTH (SSOT): Ringkasan menyeluruh kondisi produk, kapabilitas aktual, arsitektur modular monolit, domain map, utang teknis, dan konteks pengembang AI.
• 🔌 BACKEND_API.md — Panduan integrasi teknis REST API, katalog event WebSocket, wire format E2EE, dan siklus hidup media.
• 🛡️ SECURITY_AND_PERFORMANCE.md — Panduan komprehensif arsitektur keamanan (BOLA/IDOR, Anti-SSRF, E2EE fail-closed) dan optimasi performa.
• 🗺️ ROADMAP.md — Peta jalan jangka panjang dan tahapan milestone fitur produk.
• 🏛️ ARCHITECTURE.md — Spesifikasi desain database relasional (ERD) dan batas domain modular monolit.
• 📱 MOBILE_INTEGRATION_GUIDE.md — Panduan arsitektur & implementasi klien mobile (Android & iOS).
• 📄 PROGRESS.md — Laporan kronologis pengerjaan per tanggal/sesi.

---

🚀 Fitur yang Telah Selesai (Fase 1 s/d Fase 7)

• Bidirectional WebSocket Engine (Fase 1): Arsitektur hub Go dengan goroutine read/write pump dan graceful disconnect.
• Next.js Reverse Proxy (server.js) (Fase 1): Menangani WebSocket upgrade event pada custom server dan me-reverse proxy /api/* serta /uploads/*, mengisolasi URL backend dari browser.
• Multi-Database Flexible Store (Fase 2): Otomatis mendukung Supabase PostgreSQL, Local Postgres, SQLite, dan In-Memory fallback.
• Chat History Persistence (Fase 2): Riwayat pesan otomatis tersimpan di cloud database dan dimuat saat pengguna membuka obrolan atau me-refresh tab.
• User Identity & JWT Authentication (Fase 3): Pendaftaran akun dengan password hashing bcrypt, login JWT 7 hari, profil user, dan pencarian kontak instan.
• Direct Messages & 2-Kolom Layout (Fase 3): Obrolan 1-on-1 permanen dengan layout WhatsApp-grade, sidebar Recent Chats, dan standby welcome screen.
• Sound FX Synthesizer (Fase 4): Efek suara prosedural Web Audio API saat kirim/terima pesan dan reaksi tanpa file audio eksternal.
• Live Typing Indicator (Fase 4): Animasi typing indicator real-time saat lawan bicara sedang mengetik.
• Real-Time 3-Stage Receipts (Fase 4): Transisi tanda centang 🕒 Pending ➔ ✓ Sent (centang 1 abu) ➔ ✓✓ Delivered (centang 2 abu saat lawan online) ➔ ✓✓ Read (centang 2 biru saat dibaca).
• Sidebar Receipt Icons & Unread Counter (Fase 4): Tanda centang di depan cuplikan teks pesan terakhir pada daftar obrolan sidebar dan badge unread counter persisten.
• Emoji Reactions & Reply/Quote Message (Fase 4): Toolbar reaksi emoji cepat (👍 ❤️ 😂 😮 😢 🙏), badge interaktif, dan balasan kutipan pesan dengan fitur ke pesan asli.

---

🛠️ Tech Stack

Layer	Teknologi	Keterangan
Backend	Go (Golang) 1.24+	Gorilla WebSocket, Lib/PQ, Go-Redis v9, Modernc SQLite
Frontend	Next.js 16 (App Router) + React 19 + TypeScript	Vanilla CSS Design System, Responsive Dark Mode
Database	PostgreSQL (Supabase) / SQLite	Relational schema, auto-migrations, indexing
Pub/Sub & Cache	Redis (Upstash) / In-Memory Fallback	Multi-node WebSocket sync & link preview cache
Storage	Supabase Storage (S3 API) / Local Disk	Media transit buffer with Store-and-Forward
Hosting	VPS (Backend, nginx) & Vercel (Frontend)	Backend self-hosted di VPS
Testing	Go Testing Suite + TypeScript Check	100% test passing & zero linter errors

---

🌐 Production Endpoints (VPS & Vercel)

• Live Web App: https://chat.wuzzhub.id (Mirror: https://wuzz-chat.vercel.app)
• REST API Base URL: https://chat-api.wuzzhub.id
• WebSocket Endpoint: wss://chat-api.wuzzhub.id/ws
• Health Check: https://chat-api.wuzzhub.id/health

---

🚀 Menjalankan Secara Lokal

Prasyarat

• Go (v1.22 atau lebih baru)
• Node.js (v18 atau lebih baru) & npm

1. Jalankan Backend Go (Lokal)

cd backend
go run main.go

Server backend berjalan di ws://localhost:8080/ws (Health check: http://localhost:8080/health).

2. Jalankan Frontend Next.js (Lokal)

cd frontend
npm install
npm run dev

Aplikasi web berjalan di http://localhost:3047 (Otomatis membaca .env.local).

---

🧪 Menjalankan Pengujian Otomatis

Unit Test Backend (Go):

cd backend
go test -v ./...

Type Check Frontend (TypeScript):

cd frontend
npx tsc --noEmit

---

🚢 Deployment Status

• Backend (Golang): Dideploy ke VPS (nginx reverse proxy, support persistent WebSocket connection; deploy via deploy-chat.sh).
• Frontend (Next.js): Dideploy ke Vercel dengan environment variable BACKEND_API_URL dan NEXT_PUBLIC_WS_URL.