cleaning structure

2025-10-16 01:42:59 +03:00
parent e0ba349862
commit 50c791e242
469 changed files with 1016 additions and 29776 deletions
--- a/code/DATABASE_SETUP_README.md
+++ b/code/DATABASE_SETUP_README.md
@@ -0,0 +1,133 @@
+# Quick Database Setup for Trasabilitate Application
+
+This script provides a complete one-step database setup for quick deployment of the Trasabilitate application.
+
+## Prerequisites
+
+Before running the setup script, ensure:
+
+1. **MariaDB is installed and running**
+2. **Database and user are created**:
+   ```sql
+   CREATE DATABASE trasabilitate;
+   CREATE USER 'trasabilitate'@'localhost' IDENTIFIED BY 'Initial01!';
+   GRANT ALL PRIVILEGES ON trasabilitate.* TO 'trasabilitate'@'localhost';
+   FLUSH PRIVILEGES;
+   ```
+3. **Python virtual environment is activated**:
+   ```bash
+   source ../recticel/bin/activate
+   ```
+4. **Python dependencies are installed**:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+## Usage
+
+### Quick Setup (Recommended)
+```bash
+cd /srv/quality_recticel/py_app
+source ../recticel/bin/activate
+python3 app/db_create_scripts/setup_complete_database.py
+```
+
+### What the script creates:
+
+#### MariaDB Tables:
+- `scan1_orders` - Quality scanning data for process 1
+- `scanfg_orders` - Quality scanning data for finished goods
+- `order_for_labels` - Label printing orders
+- `warehouse_locations` - Warehouse location management
+- `permissions` - System permissions
+- `role_permissions` - Role-permission mappings
+- `role_hierarchy` - User role hierarchy
+- `permission_audit_log` - Permission change audit trail
+
+#### Database Triggers:
+- Auto-increment approved/rejected quantities based on quality codes
+- Triggers for both scan1_orders and scanfg_orders tables
+
+#### SQLite Tables:
+- `users` - User authentication (in instance/users.db)
+- `roles` - User roles (in instance/users.db)
+
+#### Configuration:
+- Updates `instance/external_server.conf` with correct database settings
+- Creates default superadmin user (username: `superadmin`, password: `superadmin123`)
+
+#### Permission System:
+- 7 user roles (superadmin, admin, manager, quality_manager, warehouse_manager, quality_worker, warehouse_worker)
+- 25+ granular permissions for different application areas
+- Complete role hierarchy with inheritance
+
+## After Setup
+
+1. **Start the application**:
+   ```bash
+   python3 run.py
+   ```
+
+2. **Access the application**:
+   - Local: http://127.0.0.1:8781
+   - Network: http://192.168.0.205:8781
+
+3. **Login with superadmin**:
+   - Username: `superadmin`
+   - Password: `superadmin123`
+
+## Troubleshooting
+
+### Common Issues:
+
+1. **Database connection failed**:
+   - Check if MariaDB is running: `sudo systemctl status mariadb`
+   - Verify database exists: `sudo mysql -e "SHOW DATABASES;"`
+   - Check user privileges: `sudo mysql -e "SHOW GRANTS FOR 'trasabilitate'@'localhost';"`
+
+2. **Import errors**:
+   - Ensure virtual environment is activated
+   - Install missing dependencies: `pip install -r requirements.txt`
+
+3. **Permission denied**:
+   - Make script executable: `chmod +x app/db_create_scripts/setup_complete_database.py`
+   - Check file ownership: `ls -la app/db_create_scripts/`
+
+### Manual Database Recreation:
+
+If you need to completely reset the database:
+
+```bash
+# Drop and recreate database
+sudo mysql -e "DROP DATABASE IF EXISTS trasabilitate; CREATE DATABASE trasabilitate; GRANT ALL PRIVILEGES ON trasabilitate.* TO 'trasabilitate'@'localhost'; FLUSH PRIVILEGES;"
+
+# Remove SQLite database
+rm -f instance/users.db
+
+# Run setup script
+python3 app/db_create_scripts/setup_complete_database.py
+```
+
+## Script Features
+
+- ✅ **Comprehensive**: Creates all necessary database structure
+- ✅ **Safe**: Uses `IF NOT EXISTS` clauses to prevent conflicts
+- ✅ **Verified**: Includes verification step to confirm setup
+- ✅ **Informative**: Detailed output showing each step
+- ✅ **Error handling**: Clear error messages and troubleshooting hints
+- ✅ **Idempotent**: Can be run multiple times safely
+
+## Development Notes
+
+The script combines functionality from these individual scripts:
+- `create_scan_1db.py`
+- `create_scanfg_orders.py`
+- `create_order_for_labels_table.py`
+- `create_warehouse_locations_table.py`
+- `create_permissions_tables.py`
+- `create_roles_table.py`
+- `create_triggers.py`
+- `create_triggers_fg.py`
+- `populate_permissions.py`
+
+For development or debugging, you can still run individual scripts if needed.