Docker deployment improvements: fixed backup/restore, sticky headers, quality code display

2025-11-13 02:40:36 +02:00
parent 3b69161f1e
commit 2ce918e1b3
13 changed files with 1034 additions and 117 deletions
--- a/IMPROVEMENTS_APPLIED.md
+++ b/IMPROVEMENTS_APPLIED.md
@@ -0,0 +1,123 @@
+# Improvements Applied to Quality App
+
+## Date: November 13, 2025
+
+### Overview
+All improvements from the production environment have been successfully transposed to the quality_app project.
+
+## Files Updated/Copied
+
+### 1. Docker Configuration
+- **Dockerfile** - Added `mariadb-client` package for backup functionality
+- **docker-compose.yml** - Updated with proper volume mappings and /data folder support
+- **.env** - Updated all paths to use absolute paths under `/srv/quality_app/`
+
+### 2. Backup & Restore System
+- **database_backup.py** - Fixed backup/restore functions:
+  - Changed `result_success` to `result.returncode == 0`
+  - Added `--skip-ssl` flag for MariaDB connections
+  - Fixed restore function error handling
+- **restore_database.sh** - Fixed SQL file parsing to handle MariaDB dump format
+
+### 3. UI Improvements - Sticky Table Headers
+- **base.css** - Added sticky header CSS for all report tables
+- **scan.html** - Wrapped table in `report-table-container` div
+- **fg_scan.html** - Wrapped table in `report-table-container` div
+
+### 4. Quality Code Display Enhancement
+- **fg_quality.js** - Quality code `0` displays as "OK" in green; CSV exports as "0"
+- **script.js** - Same improvements for quality module reports
+
+## Directory Structure
+
+```
+/srv/quality_app/
+├── py_app/              # Application code (mapped to /app in container)
+├── data/
+│   └── mariadb/         # Database files
+├── config/
+│   └── instance/        # Application configuration
+├── logs/                # Application logs
+├── backups/             # Database backups
+├── docker-compose.yml
+├── Dockerfile
+├── .env
+└── restore_database.sh
+```
+
+## Environment Configuration
+
+### Volume Mappings in .env:
+```
+DB_DATA_PATH=/srv/quality_app/data/mariadb
+APP_CODE_PATH=/srv/quality_app/py_app
+LOGS_PATH=/srv/quality_app/logs
+INSTANCE_PATH=/srv/quality_app/config/instance
+BACKUP_PATH=/srv/quality_app/backups
+```
+
+## Features Implemented
+
+### ✅ Backup System
+- Automatic scheduled backups
+- Manual backup creation
+- Data-only backups
+- Backup retention policies
+- MariaDB client tools installed
+
+### ✅ Restore System
+- Python-based restore function
+- Shell script restore with proper SQL parsing
+- Handles MariaDB dump format correctly
+
+### ✅ UI Enhancements
+- **Sticky Headers**: Table headers remain fixed when scrolling
+- **Quality Code Display**: 
+  - Shows "OK" in green for quality code 0
+  - Exports "0" in CSV files
+  - Better user experience
+
+### ✅ Volume Mapping
+- All volumes use absolute paths
+- Support for /data folder mapping
+- Easy to configure backup location on different drives
+
+## Starting the Application
+
+```bash
+cd /srv/quality_app
+docker compose up -d --build
+```
+
+## Testing Backup & Restore
+
+### Create Backup:
+```bash
+cd /srv/quality_app
+docker compose exec web bash -c "cd /app && python3 -c 'from app import create_app; from app.database_backup import DatabaseBackupManager; app = create_app(); 
+with app.app_context(): bm = DatabaseBackupManager(); result = bm.create_backup(); print(result)'"
+```
+
+### Restore Backup:
+```bash
+cd /srv/quality_app
+./restore_database.sh /srv/quality_app/backups/backup_file.sql
+```
+
+## Notes
+
+- Database initialization is set to `false` (already initialized)
+- All improvements are production-ready
+- Backup path can be changed to external drive if needed
+- Application port: 8781 (default)
+
+## Next Steps
+
+1. Review .env file and update passwords if needed
+2. Test all functionality after deployment
+3. Configure backup schedule if needed
+4. Set up external backup drive if desired
+
+---
+**Compatibility**: All changes are backward compatible with existing data.
+**Status**: Ready for deployment