grabowski
af62cfef0b
Some checks failed
Security & Dependency Updates / Dependency Security Scan (push) Successful in 29s
Security & Dependency Updates / Docker Security Scan (push) Failing after 53s
Security & Dependency Updates / License Compliance (push) Successful in 13s
Security & Dependency Updates / Check for Dependency Updates (push) Successful in 19s
Security & Dependency Updates / Code Quality Metrics (push) Successful in 11s
Security & Dependency Updates / Security Summary (push) Successful in 7s
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!
146 lines
3.3 KiB
Makefile
146 lines
3.3 KiB
Makefile
# 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"
|