Initial BizOne portal setup

reference/01-product-requirements.md

@@ -0,0 +1,61 @@
+# WA Business Dashboard Platform - Product Requirements
+
+## Overview
+A complete web dashboard to manage WhatsApp Business operations through API integration. The platform acts as an admin dashboard, API backend, webhook receiver, and async processing engine.
+
+## Goals
+- Manage contacts and phonebook
+- View inbound and outbound messages
+- Save and manage draft messages
+- Send single and bulk messages
+- Manage templates
+- Manage users and roles
+- Configure API, webhook, and sender settings
+- Monitor webhook, jobs, and activity logs
+
+## Core Modules
+1. Authentication and RBAC
+2. Dashboard overview and analytics
+3. Contacts and tags
+4. Conversations and messages
+5. Draft management
+6. Campaigns and broadcast
+7. Template management
+8. WhatsApp API integration settings
+9. Webhook settings and logs
+10. User management
+11. Activity logs and queue monitor
+
+## Functional Requirements
+- JWT-based auth with role permissions
+- Contacts CRUD with import/export and tagging
+- Message list with filters and status tracking
+- Conversations inbox with assignment and notes
+- Draft approval flow
+- Bulk send with queue and scheduling
+- Template builder with variable preview
+- Public webhook endpoint with signature verification
+- Webhook logs with raw payload viewer and retry
+- Queue/job monitoring
+- Audit logging for admin actions
+
+## Non-Functional Requirements
+- Secure secret storage
+- HTTPS public webhook endpoint
+- Idempotent webhook processing
+- Queue-based bulk sending
+- Provider abstraction for future switching
+- Responsive desktop-first admin UI
+
+## User Roles
+- Super Admin
+- Admin
+- Operator
+- Viewer
+
+## Success Metrics
+- Message delivery rate
+- Failed message rate
+- Webhook success rate
+- Average job processing time
+- Campaign completion rate