Version bump: 3.1.0 3.1.1

Version Updates:
- Core application version (src/__init__.py)
- Web API version (src/web_api.py)
- Main application logging (src/main.py)
- Package setup version (setup.py)
- Documentation generation (docs workflow)
- Release workflow example version
- Badge generation script
- Integration test version display
- README.md badge version
- Setup and deployment documentation
- Git initialization scripts

 Patch Release (3.1.1):
- Workflow token migration fixes (GITHUB_TOKEN  GH_TOKEN)
- Pip installation warning elimination
- Improved workflow reliability and logging
- Better Gitea compatibility
- Enhanced error handling and validation

 Files Updated:
- 13 files with version references updated
- Consistent versioning across all components
- Ready for release tagging and deployment

.gitea/workflows/ci.yml

@@ -14,7 +14,7 @@ env:
   REGISTRY: git.b4l.co.th
   IMAGE_NAME: b4l/northern-thailand-ping-river-monitor
   # GitHub token for better rate limits and authentication
-  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  GH_TOKEN: ${{ secrets.GH_TOKEN }}
 
 jobs:
   # Test job
@@ -44,9 +44,9 @@ jobs:
           
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements.txt
-        pip install -r requirements-dev.txt
+        python -m pip install --upgrade pip --root-user-action=ignore
+        pip install --root-user-action=ignore -r requirements.txt
+        pip install --root-user-action=ignore -r requirements-dev.txt
         
     - name: Lint with flake8
       run: |
@@ -106,8 +106,8 @@ jobs:
         
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements-dev.txt
+        python -m pip install --upgrade pip --root-user-action=ignore
+        pip install --root-user-action=ignore -r requirements-dev.txt
         
     - name: Run safety check
       run: |
@@ -167,7 +167,7 @@ jobs:
         cache-from: type=gha
         cache-to: type=gha,mode=max
       env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
         
     - name: Test Docker image
       run: |
@@ -205,8 +205,8 @@ jobs:
         
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements.txt
+        python -m pip install --upgrade pip --root-user-action=ignore
+        pip install --root-user-action=ignore -r requirements.txt
         
     - name: Test with VictoriaMetrics
       env:

.gitea/workflows/docs.yml

@@ -248,8 +248,8 @@ jobs:
         project = 'Northern Thailand Ping River Monitor'
         copyright = '2025, Ping River Monitor Team'
         author = 'Ping River Monitor Team'
-        version = '3.1.0'
-        release = '3.1.0'
+        version = '3.1.1'
+        release = '3.1.1'
         
         extensions = [
             'sphinx.ext.autodoc',

.gitea/workflows/release.yml

@@ -7,7 +7,7 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'Release version (e.g., v3.1.0)'
+        description: 'Release version (e.g., v3.1.1)'
         required: true
         type: string
 
@@ -16,7 +16,7 @@ env:
   REGISTRY: git.b4l.co.th
   IMAGE_NAME: b4l/northern-thailand-ping-river-monitor
   # GitHub token for better rate limits and authentication
-  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  GH_TOKEN: ${{ secrets.GH_TOKEN }}
 
 jobs:
   # Create release
@@ -83,9 +83,9 @@ jobs:
         
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements.txt
-        pip install -r requirements-dev.txt
+        python -m pip install --upgrade pip --root-user-action=ignore
+        pip install --root-user-action=ignore -r requirements.txt
+        pip install --root-user-action=ignore -r requirements-dev.txt
         
     - name: Run full test suite
       run: |
@@ -95,7 +95,7 @@ jobs:
         
     - name: Build Python package
       run: |
-        pip install build
+        pip install --root-user-action=ignore build
         python -m build
         
     - name: Upload Python package
@@ -160,9 +160,9 @@ jobs:
         image-ref: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ needs.create-release.outputs.version }}
         format: 'sarif'
         output: 'trivy-results.sarif'
-        github-token: ${{ secrets.GITHUB_TOKEN }}
+        github-token: ${{ secrets.GH_TOKEN }}
       env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
         
     - name: Upload Trivy scan results
       uses: actions/upload-artifact@v3

.gitea/workflows/security.yml

@@ -14,7 +14,7 @@ on:
 env:
   PYTHON_VERSION: "3.11"
   # GitHub token for better rate limits and authentication
-  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  GH_TOKEN: ${{ secrets.GH_TOKEN }}
 
 jobs:
   # Dependency vulnerability scan
@@ -33,8 +33,8 @@ jobs:
 
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
-          pip install safety bandit semgrep
+          python -m pip install --upgrade pip --root-user-action=ignore
+          pip install --root-user-action=ignore safety bandit semgrep
 
       - name: Run Safety check
         run: |
@@ -95,18 +95,18 @@ jobs:
 
       - name: Check GitHub token availability
         run: |
-          if [ -z "${{ secrets.GITHUB_TOKEN }}" ]; then
-            echo "⚠️ GITHUB_TOKEN not configured. Trivy scans may fail due to rate limits."
-            echo "💡 To fix: Add GITHUB_TOKEN secret in repository settings"
+          if [ -z "${{ secrets.GH_TOKEN }}" ]; then
+            echo "⚠️ GH_TOKEN not configured. Trivy scans may fail due to rate limits."
+            echo "💡 To fix: Add GH_TOKEN secret in repository settings"
           else
-            echo "✅ GITHUB_TOKEN is configured"
+            echo "✅ GH_TOKEN is configured"
           fi
 
       - name: Build Docker image for scanning
         run: |
           docker build -t ping-river-monitor:scan .
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
 
       - name: Run Trivy vulnerability scanner
         uses: aquasecurity/trivy-action@master
@@ -114,9 +114,9 @@ jobs:
           image-ref: "ping-river-monitor:scan"
           format: "json"
           output: "trivy-report.json"
-          github-token: ${{ secrets.GITHUB_TOKEN }}
+          github-token: ${{ secrets.GH_TOKEN }}
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
         continue-on-error: true
 
       - name: Run Trivy filesystem scan
@@ -126,9 +126,9 @@ jobs:
           scan-ref: "."
           format: "json"
           output: "trivy-fs-report.json"
-          github-token: ${{ secrets.GITHUB_TOKEN }}
+          github-token: ${{ secrets.GH_TOKEN }}
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
         continue-on-error: true
 
       - name: Upload Trivy reports
@@ -177,9 +177,9 @@ jobs:
 
       - name: Install pip-licenses
         run: |
-          python -m pip install --upgrade pip
-          pip install pip-licenses
-          pip install -r requirements.txt
+          python -m pip install --upgrade pip --root-user-action=ignore
+          pip install --root-user-action=ignore pip-licenses
+          pip install --root-user-action=ignore -r requirements.txt
 
       - name: Check licenses
         run: |
@@ -222,13 +222,13 @@ jobs:
 
       - name: Install pip-check-updates equivalent
         run: |
-          python -m pip install --upgrade pip
-          pip install pip-review
+          python -m pip install --upgrade pip --root-user-action=ignore
+          pip install --root-user-action=ignore pip-review
 
       - name: Check for outdated packages
         run: |
           echo "📦 Checking for outdated packages..."
-          pip install -r requirements.txt
+          pip install --root-user-action=ignore -r requirements.txt
           pip list --outdated --format=json > outdated-packages.json || true
 
           if [ -s outdated-packages.json ]; then
@@ -303,9 +303,9 @@ jobs:
 
       - name: Install quality tools
         run: |
-          python -m pip install --upgrade pip
-          pip install radon xenon vulture
-          pip install -r requirements.txt
+          python -m pip install --upgrade pip --root-user-action=ignore
+          pip install --root-user-action=ignore radon xenon vulture
+          pip install --root-user-action=ignore -r requirements.txt
 
       - name: Calculate code complexity
         run: |

DEPLOYMENT_CHECKLIST.md

@@ -259,7 +259,7 @@ make health-check
 
 **Deployment Date**: ___________  
 **Deployed By**: ___________  
-**Version**: v3.1.0  
+**Version**: v3.1.1  
 **Environment**: ___________  
 
 **Sign-off**:

GITEA_SETUP_SUMMARY.md

@@ -222,12 +222,12 @@ Your repository is now equipped with:
 2. **Configure deployment environments** (staging/production)
 3. **Set up monitoring dashboards** for workflow metrics
 4. **Configure notifications** for team collaboration
-5. **Create your first release** with `git tag v3.1.0`
+5. **Create your first release** with `git tag v3.1.1`
 
 Your **Northern Thailand Ping River Monitor** is now ready for professional development and deployment! 🎊
 
 ---
 
-**Workflow Version**: v3.1.0  
+**Workflow Version**: v3.1.1  
 **Setup Date**: 2025-08-12  
 **Repository**: https://git.b4l.co.th/grabowski/Northern-Thailand-Ping-River-Monitor

README.md

@@ -2,7 +2,7 @@
 
 A comprehensive real-time water level monitoring system for the Ping River Basin in Northern Thailand, covering Royal Irrigation Department (RID) stations from Chiang Dao to Nakhon Sawan with advanced data collection, storage, and visualization capabilities.
 
-[![CI/CD](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions/workflows/ci.yml/badge.svg)](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions) [![Security](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions/workflows/security.yml/badge.svg)](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions) [![Documentation](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions/workflows/docs.yml/badge.svg)](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions) [![Python](https://img.shields.io/badge/Python-3.9+-blue.svg)](https://python.org) [![FastAPI](https://img.shields.io/badge/FastAPI-0.104+-green.svg)](https://fastapi.tiangolo.com) [![Docker](https://img.shields.io/badge/Docker-Ready-blue.svg)](https://docker.com) [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [![Version](https://img.shields.io/badge/Version-v3.1.0-blue.svg)](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/releases)
+[![CI/CD](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions/workflows/ci.yml/badge.svg)](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions) [![Security](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions/workflows/security.yml/badge.svg)](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions) [![Documentation](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions/workflows/docs.yml/badge.svg)](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/actions) [![Python](https://img.shields.io/badge/Python-3.9+-blue.svg)](https://python.org) [![FastAPI](https://img.shields.io/badge/FastAPI-0.104+-green.svg)](https://fastapi.tiangolo.com) [![Docker](https://img.shields.io/badge/Docker-Ready-blue.svg)](https://docker.com) [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [![Version](https://img.shields.io/badge/Version-v3.1.1-blue.svg)](https://git.b4l.co.th/B4L/Northern-Thailand-Ping-River-Monitor/releases)
 
 ## 🌟 Features
 

docs/GITEA_WORKFLOWS.md

@@ -297,6 +297,6 @@ make validate-workflows
 
 ---
 
-**Workflow Version**: v3.1.0  
+**Workflow Version**: v3.1.1  
 **Last Updated**: 2025-08-12  
 **Maintained By**: Ping River Monitor Team

scripts/generate_badges.py

@@ -29,7 +29,7 @@ def main():
         "FastAPI": generate_badge_url("FastAPI", "0.104%2B", "green"),
         "Docker": generate_badge_url("Docker", "Ready", "blue"),
         "License": generate_badge_url("License", "MIT", "green"),
-        "Version": generate_badge_url("Version", "v3.1.0", "blue"),
+        "Version": generate_badge_url("Version", "v3.1.1", "blue"),
     }
     
     print("# Status Badges")

scripts/init_git.bat

@@ -13,7 +13,7 @@ REM Add all files
 git add .
 
 REM Initial commit
-git commit -m "Initial commit: Northern Thailand Ping River Monitor v3.1.0
+git commit -m "Initial commit: Northern Thailand Ping River Monitor v3.1.1
 
 Features:
 - Real-time water level monitoring for Ping River Basin

scripts/init_git.sh

@@ -66,7 +66,7 @@ fi
 git add .
 
 # Initial commit
-git commit -m "Initial commit: Northern Thailand Ping River Monitor v3.1.0
+git commit -m "Initial commit: Northern Thailand Ping River Monitor v3.1.1
 
 Features:
 - Real-time water level monitoring for Ping River Basin

setup.py

@@ -22,7 +22,7 @@ for req in requirements:
 
 setup(
     name="northern-thailand-ping-river-monitor",
-    version="3.1.0",
+    version="3.1.1",
     author="Ping River Monitor Team",
     author_email="contact@example.com",
     description="Real-time water level monitoring system for the Ping River Basin in Northern Thailand",

src/__init__.py

@@ -6,7 +6,7 @@ A comprehensive real-time water level monitoring system for the Ping River Basin
 in Northern Thailand, covering Royal Irrigation Department (RID) stations.
 """
 
-__version__ = "3.1.0"
+__version__ = "3.1.1"
 __author__ = "Ping River Monitor Team"
 __description__ = "Northern Thailand Ping River Monitoring System"
 

src/main.py

@@ -297,7 +297,7 @@ Examples:
     )
     
     logger.info("🏔️ Northern Thailand Ping River Monitor starting...")
-    logger.info(f"Version: 3.1.0")
+    logger.info(f"Version: 3.1.1")
     logger.info(f"Log level: {args.log_level}")
     
     try:

src/web_api.py

@@ -143,7 +143,7 @@ async def lifespan(app: FastAPI):
 app = FastAPI(
     title="Northern Thailand Ping River Monitor API",
     description="Real-time water level monitoring system for Northern Thailand's Ping River Basin stations",
-    version="3.1.0",
+    version="3.1.1",
     lifespan=lifespan
 )
 

tests/test_integration.py

@@ -165,7 +165,7 @@ def test_logging():
 
 def main():
     """Run all tests"""
-    print("🧪 Running integration tests for Northern Thailand Ping River Monitor v3.1.0")
+    print("🧪 Running integration tests for Northern Thailand Ping River Monitor v3.1.1")
     print("=" * 60)
     
     tests = [