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!

Makefile

@@ -0,0 +1,146 @@
+# Northern Thailand Ping River Monitor - Makefile
+
+.PHONY: help install install-dev test test-coverage lint format clean run run-api docker-build docker-run docs
+
+# Default target
+help:
+	@echo "Northern Thailand Ping River Monitor - Available Commands:"
+	@echo ""
+	@echo "Setup:"
+	@echo "  install      Install production dependencies"
+	@echo "  install-dev  Install development dependencies"
+	@echo ""
+	@echo "Development:"
+	@echo "  test         Run all tests"
+	@echo "  test-cov     Run tests with coverage report"
+	@echo "  lint         Run code linting"
+	@echo "  format       Format code with black and isort"
+	@echo "  clean        Clean up temporary files"
+	@echo ""
+	@echo "Running:"
+	@echo "  run          Run the monitor in continuous mode"
+	@echo "  run-api      Run the web API server"
+	@echo "  run-test     Run a single test cycle"
+	@echo ""
+	@echo "Docker:"
+	@echo "  docker-build Build Docker image"
+	@echo "  docker-run   Run with Docker Compose"
+	@echo "  docker-stop  Stop Docker services"
+	@echo ""
+	@echo "Documentation:"
+	@echo "  docs         Generate documentation"
+
+# Installation
+install:
+	pip install -r requirements.txt
+
+install-dev:
+	pip install -r requirements-dev.txt
+	pre-commit install
+
+# Testing
+test:
+	python test_integration.py
+	python test_station_management.py
+
+test-cov:
+	pytest --cov=src --cov-report=html --cov-report=term
+
+# Code quality
+lint:
+	flake8 src/ --max-line-length=100
+	mypy src/
+
+format:
+	black src/ *.py
+	isort src/ *.py
+
+# Cleanup
+clean:
+	find . -type f -name "*.pyc" -delete
+	find . -type d -name "__pycache__" -delete
+	find . -type f -name "*.log" -delete
+	rm -rf .pytest_cache/
+	rm -rf .mypy_cache/
+	rm -rf htmlcov/
+	rm -rf dist/
+	rm -rf build/
+	rm -rf *.egg-info/
+
+# Running
+run:
+	python run.py
+
+run-api:
+	python run.py --web-api
+
+run-test:
+	python run.py --test
+
+run-status:
+	python run.py --status
+
+# Docker
+docker-build:
+	docker build -t ping-river-monitor .
+
+docker-run:
+	docker-compose -f docker-compose.victoriametrics.yml up -d
+
+docker-stop:
+	docker-compose -f docker-compose.victoriametrics.yml down
+
+docker-logs:
+	docker-compose -f docker-compose.victoriametrics.yml logs -f
+
+# Documentation
+docs:
+	cd docs && make html
+
+# Database management
+db-migrate:
+	python scripts/migrate_geolocation.py
+
+# Monitoring
+health-check:
+	curl -f http://localhost:8000/health || exit 1
+
+metrics:
+	curl -s http://localhost:8000/metrics | jq .
+
+# Development helpers
+dev-setup: install-dev
+	cp .env.example .env
+	@echo "Development environment set up!"
+	@echo "Edit .env file with your configuration"
+
+# Production deployment
+deploy-check:
+	python run.py --test
+	@echo "Deployment check passed!"
+
+# Git helpers
+git-setup:
+	git remote add origin https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor.git
+	@echo "Git remote configured!"
+
+# Quick start
+quick-start: install dev-setup run-test
+	@echo "Quick start completed!"
+	@echo "Run 'make run-api' to start the web interface"
+
+# Gitea Actions
+validate-workflows:
+	@echo "Validating Gitea Actions workflows..."
+	@for file in .gitea/workflows/*.yml; do \
+		echo "Checking $$file..."; \
+		python -c "import yaml; yaml.safe_load(open('$$file', encoding='utf-8'))" || exit 1; \
+	done
+	@echo "✅ All workflows are valid"
+
+workflow-test:
+	@echo "Testing workflow components locally..."
+	make test
+	make lint
+	make format
+	@echo "✅ Workflow test completed"