Initial commit: Northern Thailand Ping River Monitor v3.1.0

Features:
- Real-time water level monitoring for Ping River Basin (16 stations)
- Coverage from Chiang Dao to Nakhon Sawan in Northern Thailand
- FastAPI web interface with interactive dashboard and station management
- Multi-database support (SQLite, MySQL, PostgreSQL, InfluxDB, VictoriaMetrics)
- Comprehensive monitoring with health checks and metrics collection
- Docker deployment with Grafana integration
- Production-ready architecture with enterprise-grade observability

 CI/CD & Automation:
- Complete Gitea Actions workflows for CI/CD, security, and releases
- Multi-Python version testing (3.9-3.12)
- Multi-architecture Docker builds (amd64, arm64)
- Daily security scanning and dependency monitoring
- Automated documentation generation
- Performance testing and validation

 Production Ready:
- Type safety with Pydantic models and comprehensive type hints
- Data validation layer with range checking and error handling
- Rate limiting and request tracking for API protection
- Enhanced logging with rotation, colors, and performance metrics
- Station management API for dynamic CRUD operations
- Comprehensive documentation and deployment guides

 Technical Stack:
- Python 3.9+ with FastAPI and Pydantic
- Multi-database architecture with adapter pattern
- Docker containerization with multi-stage builds
- Grafana dashboards for visualization
- Gitea Actions for CI/CD automation
- Enterprise monitoring and alerting

 Ready for deployment to B4L infrastructure!

src/config.py

@@ -0,0 +1,191 @@
+import os
+from typing import Dict, Any, Optional
+
+try:
+    from .exceptions import ConfigurationError
+    from .models import DatabaseType, DatabaseConfig
+except ImportError:
+    # Handle case when running as standalone script
+    class ConfigurationError(Exception):
+        pass
+    
+    from enum import Enum
+    
+    class DatabaseType(Enum):
+        SQLITE = "sqlite"
+        MYSQL = "mysql"
+        POSTGRESQL = "postgresql"
+        INFLUXDB = "influxdb"
+        VICTORIAMETRICS = "victoriametrics"
+
+class Config:
+    """Configuration class for the Water Level Monitor"""
+    
+    # Database settings
+    DATABASE_PATH = os.getenv('WATER_DB_PATH', 'water_levels.db')
+    
+    # Website settings
+    TARGET_URL = "https://hyd-app-db.rid.go.th/hydro1h.html"
+    API_URL = "https://hyd-app-db.rid.go.th/webservice/getGroupHourlyWaterLevelReportAllHL.ashx"
+    REQUEST_TIMEOUT = int(os.getenv('REQUEST_TIMEOUT', '30'))
+    USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
+    
+    # Database configuration
+    DB_TYPE = os.getenv('DB_TYPE', 'sqlite').lower()
+    
+    # VictoriaMetrics settings
+    VM_HOST = os.getenv('VM_HOST', 'vm.newedge.house')
+    VM_PORT = int(os.getenv('VM_PORT', '443'))
+    
+    # Support for HTTPS URLs (e.g., behind reverse proxy)
+    VM_URL = os.getenv('VM_URL')  # Full URL override (e.g., https://vm.example.com)
+    
+    # InfluxDB settings
+    INFLUX_HOST = os.getenv('INFLUX_HOST', 'localhost')
+    INFLUX_PORT = int(os.getenv('INFLUX_PORT', '8086'))
+    INFLUX_DATABASE = os.getenv('INFLUX_DATABASE', 'water_monitoring')
+    INFLUX_USERNAME = os.getenv('INFLUX_USERNAME')
+    INFLUX_PASSWORD = os.getenv('INFLUX_PASSWORD')
+    
+    # PostgreSQL settings
+    POSTGRES_CONNECTION_STRING = os.getenv('POSTGRES_CONNECTION_STRING')
+    
+    # MySQL settings
+    MYSQL_CONNECTION_STRING = os.getenv('MYSQL_CONNECTION_STRING')
+    
+    # Scheduler settings
+    SCRAPING_INTERVAL_HOURS = int(os.getenv('SCRAPING_INTERVAL_HOURS', '1'))
+    
+    # Logging settings
+    LOG_LEVEL = os.getenv('LOG_LEVEL', 'INFO')
+    LOG_FILE = os.getenv('LOG_FILE', 'water_monitor.log')
+    LOG_FORMAT = '%(asctime)s - %(levelname)s - %(message)s'
+    
+    # Data retention
+    DATA_RETENTION_DAYS = int(os.getenv('DATA_RETENTION_DAYS', '365'))
+    
+    # Retry settings
+    MAX_RETRIES = int(os.getenv('MAX_RETRIES', '3'))
+    RETRY_DELAY_SECONDS = int(os.getenv('RETRY_DELAY_SECONDS', '60'))
+    
+    @classmethod
+    def validate_config(cls) -> bool:
+        """Validate configuration settings"""
+        errors = []
+        
+        # Validate database type
+        try:
+            DatabaseType(cls.DB_TYPE)
+        except ValueError:
+            errors.append(f"Invalid DB_TYPE: {cls.DB_TYPE}")
+        
+        # Validate database-specific settings
+        if cls.DB_TYPE == 'victoriametrics':
+            if not cls.VM_HOST:
+                errors.append("VM_HOST is required for VictoriaMetrics")
+            if not isinstance(cls.VM_PORT, int) or cls.VM_PORT <= 0:
+                errors.append("VM_PORT must be a positive integer")
+        
+        elif cls.DB_TYPE == 'influxdb':
+            if not cls.INFLUX_HOST:
+                errors.append("INFLUX_HOST is required for InfluxDB")
+            if not cls.INFLUX_DATABASE:
+                errors.append("INFLUX_DATABASE is required for InfluxDB")
+        
+        elif cls.DB_TYPE in ['postgresql', 'mysql']:
+            connection_string = (cls.POSTGRES_CONNECTION_STRING if cls.DB_TYPE == 'postgresql' 
+                               else cls.MYSQL_CONNECTION_STRING)
+            if not connection_string:
+                errors.append(f"Connection string is required for {cls.DB_TYPE.upper()}")
+        
+        # Validate numeric settings
+        if cls.SCRAPING_INTERVAL_HOURS <= 0:
+            errors.append("SCRAPING_INTERVAL_HOURS must be positive")
+        
+        if cls.DATA_RETENTION_DAYS <= 0:
+            errors.append("DATA_RETENTION_DAYS must be positive")
+        
+        if errors:
+            raise ConfigurationError(f"Configuration errors: {'; '.join(errors)}")
+        
+        return True
+    
+    @classmethod
+    def get_database_config(cls) -> Dict[str, Any]:
+        """Returns database configuration based on DB_TYPE"""
+        if cls.DB_TYPE == 'victoriametrics':
+            return {
+                'type': 'victoriametrics',
+                'host': cls.VM_HOST,
+                'port': cls.VM_PORT
+            }
+        elif cls.DB_TYPE == 'influxdb':
+            return {
+                'type': 'influxdb',
+                'host': cls.INFLUX_HOST,
+                'port': cls.INFLUX_PORT,
+                'database': cls.INFLUX_DATABASE,
+                'username': cls.INFLUX_USERNAME,
+                'password': cls.INFLUX_PASSWORD
+            }
+        elif cls.DB_TYPE == 'postgresql':
+            return {
+                'type': 'postgresql',
+                'connection_string': cls.POSTGRES_CONNECTION_STRING or 
+                    'postgresql://postgres:password@localhost:5432/water_monitoring'
+            }
+        elif cls.DB_TYPE == 'mysql':
+            return {
+                'type': 'mysql',
+                'connection_string': cls.MYSQL_CONNECTION_STRING or 
+                    'mysql://root:password@localhost:3306/water_monitoring'
+            }
+        else:  # sqlite
+            return {
+                'type': 'sqlite',
+                'connection_string': f'sqlite:///{cls.DATABASE_PATH}'
+            }
+    
+    @classmethod
+    def get_all_settings(cls) -> Dict[str, Any]:
+        """Returns all configuration settings"""
+        return {
+            'DB_TYPE': cls.DB_TYPE,
+            'DATABASE_PATH': cls.DATABASE_PATH,
+            'TARGET_URL': cls.TARGET_URL,
+            'API_URL': cls.API_URL,
+            'REQUEST_TIMEOUT': cls.REQUEST_TIMEOUT,
+            'SCRAPING_INTERVAL_HOURS': cls.SCRAPING_INTERVAL_HOURS,
+            'LOG_LEVEL': cls.LOG_LEVEL,
+            'LOG_FILE': cls.LOG_FILE,
+            'DATA_RETENTION_DAYS': cls.DATA_RETENTION_DAYS,
+            'MAX_RETRIES': cls.MAX_RETRIES,
+            'RETRY_DELAY_SECONDS': cls.RETRY_DELAY_SECONDS,
+            'VM_HOST': cls.VM_HOST,
+            'VM_PORT': cls.VM_PORT,
+            'INFLUX_HOST': cls.INFLUX_HOST,
+            'INFLUX_PORT': cls.INFLUX_PORT,
+            'INFLUX_DATABASE': cls.INFLUX_DATABASE
+        }
+    
+    @classmethod
+    def print_settings(cls):
+        """Prints all current settings"""
+        print("=== Water Level Monitor Configuration ===")
+        for key, value in cls.get_all_settings().items():
+            # Hide sensitive information
+            if 'PASSWORD' in key and value:
+                value = '*' * len(str(value))
+            print(f"{key}: {value}")
+        print("=" * 45)
+        
+        print("\nDatabase Configuration:")
+        db_config = cls.get_database_config()
+        for key, value in db_config.items():
+            if 'password' in key and value:
+                value = '*' * len(str(value))
+            print(f"  {key}: {value}")
+        print("=" * 45)
+
+if __name__ == "__main__":
+    Config.print_settings()