Initial commit - Mold Cost Calculator Application (Security Fixed)

2025-06-24 10:28:55 +08:00
commit 9b84cee5be
108 changed files with 15886 additions and 0 deletions
@@ -0,0 +1,422 @@
+# Mold Cost Calculator - Admin User Guide
+
+## 📋 Table of Contents
+1. [System Overview](#system-overview)
+2. [Cost Calculation System](#cost-calculation-system)
+3. [Cost Factors & Pricing](#cost-factors--pricing)
+4. [Admin Panel Access](#admin-panel-access)
+5. [User Management](#user-management)
+6. [Quotation Management](#quotation-management)
+7. [System Configuration](#system-configuration)
+8. [Troubleshooting](#troubleshooting)
+
+---
+
+## 🎯 System Overview
+
+The Mold Cost Calculator is a web-based application that calculates mold manufacturing costs based on various technical specifications and complexity factors. The system is designed for footwear industry professionals to get accurate cost estimates for different types of molds.
+
+### Key Features
+- **Multi-factor cost calculation** based on mold type, complexity, and texture
+- **Country-specific tax rates** for accurate regional pricing
+- **User management system** with role-based access control
+- **Comprehensive admin panel** for system oversight
+- **Real-time cost breakdown** with detailed component analysis
+
+---
+
+## 💰 Cost Calculation System
+
+### Base Calculation Formula
+
+The system uses a multi-layered calculation approach:
+
+```
+Total Cost = (Base Price + Complexity Cost + Texture Cost) × (1 + Tax Rate)
+```
+
+Where:
+- **Base Price** = DEFAULT_NET_BASE × Mold Type Factor
+- **Complexity Cost** = Base Price × (Slider Factor + Cavity Factor + High Sidewall Factor)
+- **Texture Cost** = Base Price × Texture Factor
+
+### Default Values
+- **DEFAULT_NET_BASE**: $12.50 (base unit cost)
+- **Tax Rates**: Varies by country (see below)
+
+---
+
+## 📊 Cost Factors & Pricing
+
+### 1. Mold Type Factors
+
+The system applies different multipliers based on the specific mold type:
+
+#### Rubber Molds
+| Specific Type | Factor | Description |
+|---------------|--------|-------------|
+| Flat | 1.00 | Standard flat outsole |
+| Flat with Top/Heel Tip | 1.25 | Flat with additional tip features |
+| Top PL | 1.05 | Top part line mold |
+| Visible PL | 1.28 | Visible part line mold |
+| Short PL (Heel/Forefoot) | 1.18 | Short part line for specific areas |
+| Wave PL | 1.32 | Wave pattern part line |
+
+#### CMEVA Molds
+| Specific Type | Factor | Description |
+|---------------|--------|-------------|
+| 2 Plates Mold | 1.00 | Standard 2-plate configuration |
+| 3 Plates Mold | 1.35 | Complex 3-plate configuration |
+| 2 Plates with in-mold channel | 1.25 | 2-plate with channel features |
+| Breathable + in-mold channel | 1.45 | Breathable with channel features |
+
+#### IMEVA Molds
+| Specific Type | Factor | Description |
+|---------------|--------|-------------|
+| 2 Plates Mold | 1.00 | Standard 2-plate configuration |
+| 3 Plates Mold | 1.35 | Complex 3-plate configuration |
+
+#### Sandal Molds
+| Specific Type | Factor | Description |
+|---------------|--------|-------------|
+| Sandal with Upper Bandage | 1.15 | Sandal with bandage features |
+| 2 Plate without Upper Bandage | 1.05 | Standard 2-plate sandal |
+
+#### Co-shot Molds
+| Specific Type | Factor | Description |
+|---------------|--------|-------------|
+| Co-shot mold | 1.25 | Multi-material injection |
+| Foaming mold | 1.40 | Foam injection process |
+
+#### PU Molds
+| Specific Type | Factor | Description |
+|---------------|--------|-------------|
+| 2 Plates Mold | 1.00 | Standard 2-plate configuration |
+| 3 Plates Mold | 1.35 | Complex 3-plate configuration |
+
+### 2. Complexity Factors
+
+Additional costs based on mold complexity:
+
+| Complexity Type | Factor | Calculation |
+|-----------------|--------|-------------|
+| High Sidewall (>60mm) | 0.18 | Base Price × 0.18 |
+| Slider | 0.10 | Base Price × (Number of Sliders × 0.10) |
+| Cavity | 0.12 | Base Price × ((Number of Cavities - 1) × 0.12) |
+
+### 3. Texture Factors
+
+Digital texture processing costs:
+
+| Texture Type | Factor | Description |
+|--------------|--------|-------------|
+| adidas digital | 0.00 | No additional cost |
+| customized texture | 0.15 | 15% of base price |
+| laser | 0.20 | 20% of base price |
+
+### 4. Tax Rates by Country
+
+| Country | Tax Rate | Percentage |
+|---------|----------|------------|
+| China | 0.06 | 6% |
+| Vietnam | 0.10 | 10% |
+| Indonesia | 0.07 | 7% |
+
+---
+
+## 🔐 Admin Panel Access
+
+### Accessing the Admin Panel
+
+1. **Login Requirements**: Must be logged in with admin privileges
+2. **URL**: Navigate to `/admin/dashboard`
+3. **Authentication**: System checks `current_user.is_admin` flag
+
+### Admin Privileges Required
+- User account must have `is_admin = True` in the database
+- Admin users can access all system features
+- Regular users are redirected to login with access denied message
+
+---
+
+## 👥 User Management
+
+### Viewing Users
+- **Location**: Admin Panel → Users
+- **Features**: 
+  - List all registered users
+  - Search and filter functionality
+  - Pagination (20 users per page)
+  - User status indicators
+
+### User Information Displayed
+- User ID
+- Username
+- Email address
+- Account status (Active/Inactive)
+- Role (Admin/User)
+- Last login date
+- Account creation date
+
+### User Actions
+
+#### View User Details
+- Click the eye icon (👁️) to view detailed user information
+- Shows user profile and quotation history
+
+#### Toggle User Status
+- Click the toggle button to activate/deactivate users
+- Inactive users cannot log in
+- Confirmation dialog required
+
+#### Delete User
+- **Restriction**: Cannot delete your own account
+- **Process**: Confirmation required before deletion
+- **Impact**: Permanently removes user and all associated data
+
+### User Statistics
+- Total registered users
+- Active users (logged in within 30 days)
+- User activity trends
+
+---
+
+## 📋 Quotation Management
+
+### Viewing Quotations
+- **Location**: Admin Panel → Quotations
+- **Features**:
+  - List all system quotations
+  - Advanced filtering options
+  - Pagination (20 quotations per page)
+  - Cost breakdown display
+
+### Filter Options
+- **Country**: Filter by mold shop country
+- **Mold Type**: Filter by main mold type
+- **Date Range**: Filter by creation date
+- **Clear Filters**: Reset all filters
+
+### Quotation Information Displayed
+- Quotation ID
+- User who created it
+- Model name
+- Country
+- Mold type
+- Base price
+- Total cost
+- Creation date
+
+### Quotation Actions
+
+#### View Quotation Details
+- Click the eye icon to view complete quotation details
+- Shows all form data and cost breakdown
+- Displays approval information
+
+#### Delete Quotation
+- **Process**: Confirmation required
+- **Impact**: Permanently removes quotation from system
+- **Audit**: Admin action logged
+
+### Quotation Statistics
+- Total quotations in system
+- Quotations by country
+- Recent quotation activity
+- Cost analysis trends
+
+---
+
+## ⚙️ System Configuration
+
+### Cost Factor Management
+
+#### Updating Cost Factors
+Cost factors are defined in `app/constants.py`:
+
+```python
+COST_FACTORS = {
+    'mold': {
+        'Flat': 1.0,
+        'Flat with Top/Heel Tip': 1.25,
+        # ... other factors
+    },
+    'complexity': {
+        'high_sidewall': 0.18,
+        'slider': 0.1,
+        'cavity': 0.12
+    },
+    'texture': {
+        'adidas_digital': 0.0,
+        'customized texture': 0.15,
+        'laser': 0.2
+    }
+}
+```
+
+#### Updating Tax Rates
+Tax rates are also in `app/constants.py`:
+
+```python
+TAX_RATES = {
+    'China': 0.06,
+    'Vietnam': 0.10,
+    'Indonesia': 0.07
+}
+```
+
+#### Updating Default Base Price
+Change `DEFAULT_NET_BASE` in `app/constants.py`:
+
+```python
+DEFAULT_NET_BASE = 12.5  # Change this value
+```
+
+### Database Management
+
+#### Creating Admin Users
+Use the CLI command to create admin users:
+
+```bash
+# Set environment variables
+export ADMIN_USERNAME="admin"
+export ADMIN_EMAIL="admin@company.com"
+export ADMIN_PASSWORD="secure_password"
+export ADMIN_COMPANY="Company Name"
+
+# Run the command
+flask init-db
+```
+
+#### Database Migrations
+The system uses Alembic for database migrations:
+
+```bash
+# Create a new migration
+flask db migrate -m "Description of changes"
+
+# Apply migrations
+flask db upgrade
+```
+
+### Environment Configuration
+
+#### Required Environment Variables
+- `SECRET_KEY`: Application secret key
+- `DATABASE_URL`: Database connection string
+- `ADMIN_EMAIL`: Admin user email
+- `ADMIN_PASSWORD`: Admin user password
+
+#### Optional Environment Variables
+- `FLASK_ENV`: Environment (development/production)
+- `LOG_LEVEL`: Logging level
+- `MAIL_SERVER`: Email server configuration
+
+---
+
+## 🔧 Troubleshooting
+
+### Common Issues
+
+#### Cost Calculation Errors
+**Problem**: Incorrect cost calculations
+**Solution**: 
+1. Check cost factors in `app/constants.py`
+2. Verify mold type mappings
+3. Ensure all factors are properly defined
+
+#### User Access Issues
+**Problem**: Users cannot access admin panel
+**Solution**:
+1. Verify user has `is_admin = True` in database
+2. Check user account is active
+3. Clear browser cache and cookies
+
+#### Database Connection Issues
+**Problem**: Database connection failures
+**Solution**:
+1. Check database server status
+2. Verify connection string in environment
+3. Check database permissions
+4. Review application logs
+
+#### Form Validation Errors
+**Problem**: Form submissions failing validation
+**Solution**:
+1. Check form field mappings
+2. Verify validation rules
+3. Review server logs for specific errors
+4. Ensure all required fields are properly configured
+
+### Log Analysis
+
+#### Application Logs
+- **Location**: `/app/logs/` directory
+- **Format**: Timestamp, log level, message
+- **Key Logs**: Error messages, validation failures, calculation results
+
+#### Database Logs
+- **Location**: Database server logs
+- **Key Information**: Connection issues, query performance, errors
+
+### Performance Monitoring
+
+#### System Metrics
+- User activity levels
+- Quotation creation rates
+- Calculation response times
+- Database query performance
+
+#### Optimization Tips
+- Monitor database query performance
+- Review cache hit rates
+- Check for slow calculations
+- Monitor memory usage
+
+---
+
+## 📞 Support & Maintenance
+
+### Regular Maintenance Tasks
+1. **Database Backups**: Regular automated backups
+2. **Log Rotation**: Manage log file sizes
+3. **Security Updates**: Keep dependencies updated
+4. **Performance Monitoring**: Monitor system performance
+5. **User Management**: Review and clean up inactive users
+
+### Emergency Procedures
+1. **System Downtime**: Check server status and logs
+2. **Data Corruption**: Restore from latest backup
+3. **Security Breach**: Review access logs and user activity
+4. **Performance Issues**: Scale resources or optimize queries
+
+### Contact Information
+- **Technical Support**: [Your IT Support Email]
+- **System Administrator**: [Admin Contact]
+- **Emergency Contact**: [Emergency Phone Number]
+
+---
+
+## 📈 System Analytics
+
+### Key Performance Indicators (KPIs)
+- **User Adoption**: Number of active users
+- **Usage Patterns**: Peak usage times
+- **Calculation Accuracy**: Error rates in calculations
+- **System Performance**: Response times and uptime
+
+### Reporting Capabilities
+- User activity reports
+- Quotation volume analysis
+- Cost factor impact analysis
+- Geographic usage patterns
+
+### Data Export
+- Quotation data export (CSV/Excel)
+- User activity reports
+- Cost analysis reports
+- System performance metrics
+
+---
+
+*This admin guide should be updated whenever system changes are made to cost factors, user management features, or administrative functions.*