PromptTech Solutions E-Commerce Platform
A full-stack e-commerce platform with admin dashboard, user management, inventory control, and service booking capabilities.
🚀 Quick Start
# Start both backend and frontend with PM2
./scripts/start_with_pm2.sh
# Check service status
./scripts/check_status.sh
# Stop all services
./scripts/stop_pm2.sh
Access the application:
- Frontend: http://localhost:5300
- Backend API: http://localhost:8181
- API Docs: http://localhost:8181/docs
Admin Login:
- Email: admin@techzone.com
- Password: admin123
📁 Project Structure
PromptTech_Solution_Site/
├── backend/ # FastAPI backend server
├── frontend/ # React frontend application
├── docs/ # Documentation
│ ├── features/ # Feature documentation
│ ├── guides/ # User guides
│ └── reports/ # Technical reports
├── scripts/ # Utility scripts
├── tests/ # Test files
├── test_reports/ # Test execution reports
├── logs/ # Application logs
├── Logo/ # Brand assets
└── archive/ # Archived files
For detailed structure, see WORKSPACE_STRUCTURE.md
🛠️ Technology Stack
Backend:
- Python 3.x
- FastAPI 2.0
- SQLAlchemy (Async ORM)
- PostgreSQL
- Bcrypt & JWT Authentication
Frontend:
- React 19
- TipTap 3.15 (Rich Text Editor)
- Tailwind CSS
- shadcn/ui Components
- Axios
✨ Features
Customer Features
- Product catalog with multi-image support
- Service booking system
- Shopping cart and checkout
- Order history and tracking
- User authentication and profiles
- Product reviews and ratings
Admin Dashboard
- User Management: Create and manage users with 5 role levels (Admin, User, Employee, Accountant, Sales Manager)
- Inventory Management: Full CRUD with active/inactive toggle, filters, and pagination
- Product Management: Multi-image upload, rich text descriptions, stock tracking
- Service Management: Service catalog, bookings, and scheduling
- Order Management: Order processing, status updates, tracking
- Category Management: Product and service categorization
- Reports: Sales reports, inventory reports (CSV/PDF export)
📚 Documentation
Guides
Feature Documentation
Technical Reports
🗄️ Database
PostgreSQL Database:
- Database: techzone
- User: techzone_user
- Port: 5432
- Tables: 15+ tables (users, products, services, orders, etc.)
🔧 Development
Backend Setup
cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python server.py
Frontend Setup
cd frontend
npm install
npm start
Create Admin User
cd backend
source venv/bin/activate
python create_admin.py
🧪 Testing
# Run backend tests
python tests/backend_test.py
# Run admin feature tests
./scripts/verify_admin_features.sh
# Test database integration
./scripts/test_database_integration.sh
📦 Deployment
The application uses PM2 for process management:
# Start services
pm2 start scripts/ecosystem.config.json
# Monitor services
pm2 monit
# View logs
pm2 logs
# Restart services
pm2 restart all
🔐 Environment Variables
Backend (.env):
DATABASE_URL=postgresql+asyncpg://techzone_user:techzone_pass@localhost:5432/techzone
SECRET_KEY=your-secret-key-here
CORS_ORIGINS=http://localhost:5300
Frontend (.env):
REACT_APP_BACKEND_URL=http://localhost:8181
🤝 Contributing
- Keep code organized in respective folders
- Update documentation for new features
- Write tests for new functionality
- Follow existing code style and conventions
📝 Recent Updates (January 12, 2026)
- ✅ Complete rebranding to PromptTech Solutions
- ✅ User management system with RBAC (5 roles)
- ✅ Inventory filters and pagination
- ✅ Multi-image upload with rich text editor
- ✅ Performance optimizations
- ✅ Workspace organization and documentation
📞 Support
For questions or issues:
- Check the Quick Start Guide
- Review Technical Reports
- Check Feature Documentation
Company: PromptTech Solutions
Version: 2.0.0
Last Updated: January 12, 2026