Add monorepo scaffolding and project documentation

Sets up the Nuvolari monorepo layout (app/, backend/, docs/, tool/) with the groundwork that does not depend on the Flutter toolchain: gitignore covering Flutter, Python and every secret file shape; env.example.json as the template for --dart-define-from-file; a verification script that skips stages whose target does not exist yet so it is runnable from day one; and a CI workflow in GitHub Actions syntax so it runs unchanged on Gitea or GitHub. The documentation records facts verified against the live services rather than restated from the brief. Two of them change the design: - DPC VMI rasters are 1200x1400 Float32 on a 1 km grid in a custom projection centred on Italy, not EPSG:4326 or EPSG:3857, and their GeoKeys are internally inconsistent. Reprojection is mandatory and the source CRS must be read from each file rather than hardcoded. - The ARPA CAP feed carries six level values, not four: BIANCO for the avalanche scale out of season and "-" for no data. Collapsing either into VERDE would report "no alert" where the bulletin reports "not assessed". Also documents why the frames we publish inherit CC BY-SA from the DPC source, and why rain notifications subscribe to cell topics from the device so no user location ever reaches a server. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 10:50:40 +02:00
parent 3b0fce2516
commit 3fcbb9f1c4
11 changed files with 1051 additions and 0 deletions
@@ -0,0 +1,78 @@
+# Gitea Actions workflow, written in GitHub Actions syntax so it runs unchanged on
+# either host. If the Gitea instance has no runner configured this file is inert and
+# tool/verify.ps1 is the verification that must pass locally.
+name: CI
+
+on:
+  push:
+    branches: [main]
+    paths: ['Nuvolari/**']
+  pull_request:
+    paths: ['Nuvolari/**']
+
+defaults:
+  run:
+    working-directory: Nuvolari
+
+jobs:
+  app:
+    name: Flutter app
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: subosito/flutter-action@v2
+        with:
+          flutter-version: '3.47.3'
+          channel: stable
+          cache: true
+
+      - name: Install dependencies
+        working-directory: Nuvolari/app
+        run: flutter pub get
+
+      - name: Check formatting
+        working-directory: Nuvolari/app
+        run: dart format --set-exit-if-changed .
+
+      - name: Analyze
+        working-directory: Nuvolari/app
+        run: flutter analyze
+
+      - name: Test
+        working-directory: Nuvolari/app
+        run: flutter test
+
+  backend:
+    name: Python worker
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Skip when the worker does not exist yet
+        id: guard
+        run: |
+          if [ -f backend/pyproject.toml ]; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Install dependencies
+        if: steps.guard.outputs.exists == 'true'
+        working-directory: Nuvolari/backend
+        run: pip install -e ".[dev]"
+
+      - name: Lint
+        if: steps.guard.outputs.exists == 'true'
+        working-directory: Nuvolari/backend
+        run: ruff check .
+
+      - name: Test
+        if: steps.guard.outputs.exists == 'true'
+        working-directory: Nuvolari/backend
+        run: pytest -q