Initial commit - PromptTech

archive/techzone-source/memory/PRD.md

@@ -0,0 +1,84 @@
+# TechZone - E-commerce & Services Website
+
+## Original Problem Statement
+Create a production-ready, full-stack website for services and e-commerce. Sell products (phones, laptops, accessories) and offer services (repair, data recovery, etc.). JWT-based authentication, dark/light theme toggle, modern UI with hover effects and clean borders.
+
+## Architecture
+- **Frontend**: React 19 + Tailwind CSS + Shadcn UI
+- **Backend**: FastAPI (Python) with SQLAlchemy
+- **Database**: PostgreSQL (migrated from MongoDB)
+- **Authentication**: JWT (bcrypt for password hashing)
+
+## User Personas
+1. **Shoppers**: Browse and purchase electronics (phones, laptops, accessories)
+2. **Service Seekers**: Book repair and tech support services
+3. **Admin**: Manage products, services, orders, inventory, and view reports
+
+## Core Requirements (Static)
+- [x] Product catalog with categories and search
+- [x] Services listing with booking functionality
+- [x] JWT authentication (login/register)
+- [x] Shopping cart with checkout
+- [x] Order tracking with status history
+- [x] Product reviews and ratings
+- [x] Contact form
+- [x] Dark/Light theme toggle
+- [x] Responsive design (mobile, tablet, desktop)
+- [x] Modern UI with hover effects and clean borders
+
+## What's Been Implemented (December 2025)
+
+### Phase 1 - MVP
+- User authentication (register, login, JWT tokens)
+- Products CRUD with categories
+- Services CRUD with categories
+- Shopping cart management
+- Contact form submission
+- Service booking system
+- Theme toggle
+
+### Phase 2 - Admin & Inventory (Latest)
+- **PostgreSQL Migration**: Full database migration from MongoDB
+- **Order System**: Complete checkout with order creation, status tracking
+- **Order Statuses**: Pending, Processing, Layaway, Shipped, Delivered, Cancelled, Refunded, On Hold
+- **Reviews System**: Product reviews with ratings, verified purchase badges
+- **Admin Dashboard**:
+  - Dashboard with stats (revenue, orders, users, products)
+  - Low stock alerts with customizable thresholds
+  - Products CRUD (create, update, delete)
+  - Services CRUD (create, update, delete)
+  - Orders management with status updates
+  - Inventory management with stock adjustments
+  - Service bookings management
+  - Sales reports (daily/weekly/monthly)
+  - CSV and PDF export functionality
+
+### Admin Credentials
+- Email: admin@techzone.com
+- Password: admin123
+
+## Database Schema (PostgreSQL)
+- users, products, services, cart_items, orders, order_items
+- order_status_history, reviews, bookings, contacts, inventory_logs
+- categories, sales_reports
+
+## Prioritized Backlog
+### P0 (Critical)
+- ✅ All core features implemented
+
+### P1 (Important)
+- Payment integration (Stripe)
+- Email notifications for orders
+- Order invoice PDF generation
+
+### P2 (Nice to Have)
+- Wishlist functionality
+- Advanced search with filters
+- Customer analytics dashboard
+- SMS notifications
+
+## Next Tasks
+1. Add Stripe payment integration
+2. Implement email notifications for order status changes
+3. Generate printable invoices for orders
+4. Add customer reviews analytics in admin dashboard