Drop Xamarin skeleton and add project guidelines

The Nuvolari app is being rebuilt as a Flutter project targeting Android first and iOS later on a single codebase, so the original Xamarin.Android skeleton no longer applies. Its files were already removed from the working tree; this records the removal. Adds CLAUDE.md with the golden rules that constrain the rewrite: English code and commit messages with Italian UI via ARB, no secrets in the repo, AdMob test IDs only, no direct polling of ARPA/DPC from the app, and no server-side precise user locations. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 10:36:57 +02:00
parent 7a45880059
commit 3b0fce2516
27 changed files with 50 additions and 230 deletions
@@ -1,5 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.nuvolari" android:versionCode="1">
-	<application android:allowBackup="true" android:icon="@mipmap/appicon" android:label="Nuvolari" android:supportsRtl="true"></application>
-	<uses-permission android:name="android.permission.INTERNET" />
-</manifest>
@@ -0,0 +1,50 @@
+# CLAUDE.md — Radar Meteo Piemonte
+
+## Project
+Cross-platform weather-radar app for the Piedmont region (Italy). Android first, iOS later,
+single Flutter codebase. Free app monetized with AdMob (GDPR consent via UMP).
+Region-scoped now (Piemonte) but extensible to other regions via configuration.
+
+## Golden rules
+- Code, identifiers and commit messages in English. UI text in Italian via ARB localization.
+- Never commit secrets. Use .env + --dart-define; keep .gitignore updated.
+- Use ONLY AdMob TEST ad unit IDs in development.
+- Never poll ARPA/DPC servers directly from the app: always go through our backend/CDN.
+- Never store precise user locations server-side: rain notifications use geographic CELLS.
+- Do not use ARPA/DPC name, logo or the word "ufficiale" in a way implying an official app.
+
+## Architecture
+- Monorepo: /app (Flutter), /backend (Python worker), /docs (detailed docs).
+- Radar data via RadarSource interface with adapters:
+  DpcRadarSource (default, public), ArpaRadarSource (stub, awaits authorization),
+  MockRadarSource (offline/demo). Active source chosen by region config + runtime flag.
+- App reads PNG frames + manifest.json from CDN produced by the backend worker
+  (crop to Piemonte bbox, reproject to EPSG:3857).
+
+## Data sources & licenses (attribution is mandatory on the Sources screen)
+- Radar (MVP): Radar-DPC — base https://radar-api.protezionecivile.it/ ,
+  GET /findLastProductByType?type=VMI , POST /downloadProduct (GeoTIFF via presigned S3).
+  REQUIRE header `origin: https://radar.protezionecivile.it`. License CC BY-SA — credit
+  "Radar-DPC"; derivative data products must stay CC BY-SA. Docs: dpc-radar.readthedocs.io.
+- Radar (future): ARPA Piemonte (HDF5 ODIM), access via email info.meteo@arpa.piemonte.it.
+  License CC BY 4.0 — credit "Fonte: Arpa Piemonte - www.arpa.piemonte.it".
+- Forecast: MET Norway api.met.no (CC BY 4.0, commercial OK) — MANDATORY identifying
+  User-Agent (app name + contact). Fallback: ItaliaMeteo ICON-2I via MeteoHub (CC BY 4.0,
+  credit "ItaliaMeteo-ARPAE"). Do NOT use Open-Meteo free tier (non-commercial only).
+- Alerts: ARPA Piemonte XML-CAP bulletin — reproduce alert levels WITHOUT reinterpreting;
+  link the official channel.
+- Base map: OSM data via PMTiles/MapTiler — show OSM/ODbL attribution.
+- Lightning: DO NOT use Blitzortung (commercial use prohibited).
+
+## Verification loop (run after each milestone)
+- `dart format .` ; `flutter analyze` ; `flutter test` ; `flutter build appbundle`
+- Backend: `python -m pytest` ; lint. Commit frequently with clear messages.
+
+## Store / compliance targets
+- Google Play: target API 36 (Android 16) by 2026-08-31; closed testing 12 testers / 14 days;
+  Data safety section; prominent disclosure for location; signed AAB.
+- Consent: Google-certified CMP (UMP), IAB TCF 2.3, non-personalized ads if user declines.
+- iOS later: keep platform abstractions clean (ATT + privacy nutrition label to add).
+
+## Docs to maintain in /docs
+architecture.md, data-sources.md, licenses.md, stack-decisions.md, roadmap.md, privacy.md
@@ -1,90 +0,0 @@
-using Android.App;
-using Android.OS;
-using Android.Gms.Maps;
-using Android.Gms.Maps.Model;
-using Android.Widget;
-using Android.Locations;
-using System.Threading.Tasks;
-using System.Linq;
-
-/*
- * IDEE:
- * Fare una versione molto base dell'app senza troppe funzionalità, giusto per mostrare una mappa.
- * Fare poi una versione con più funzionalità, ma con pubblicità per guadagnare qualcosa da quello.
- */
-
-namespace Nuvolari
-{
-    [Activity(Label = "@string/app_name", MainLauncher = true)]
-    public class MainActivity : Activity, IOnMapReadyCallback
-    {
-        private MapFragment? mapFragment;
-        private GoogleMap? googleMap;
-        private SearchView? searchView;
-
-        protected override void OnCreate(Bundle? savedInstanceState)
-        {
-            base.OnCreate(savedInstanceState);
-
-            // Usa il layout personalizzato con SearchView e MapFragment
-            SetContentView(Resource.Layout.activity_main);
-
-            // Ottieni riferimenti ai componenti UI
-            searchView = FindViewById<SearchView>(Resource.Id.searchView);
-            mapFragment = FragmentManager.FindFragmentById(Resource.Id.map) as MapFragment;
-
-            mapFragment?.GetMapAsync(this);
-
-            // Gestione ricerca
-            if (searchView != null)
-            {
-                searchView.QueryTextSubmit += async (s, e) =>
-                {
-                    var query = e?.Query ?? string.Empty;
-                    await SearchAndMoveToLocationAsync(query);
-                    searchView.ClearFocus();
-                };
-            }
-        }
-
-        public void OnMapReady(GoogleMap map)
-        {
-            googleMap = map;
-            // Imposta solo la navigazione base (scroll/zoom)
-            googleMap.UiSettings.CompassEnabled = false;
-            googleMap.UiSettings.MapToolbarEnabled = false;
-            googleMap.UiSettings.MyLocationButtonEnabled = false;
-
-            // Posizione iniziale: Milano
-            var position = new LatLng(45.4642, 9.19);
-            googleMap.MoveCamera(CameraUpdateFactory.NewLatLngZoom(position, 10));
-        }
-
-        private async Task SearchAndMoveToLocationAsync(string query)
-        {
-            if (string.IsNullOrWhiteSpace(query) || googleMap == null)
-                return;
-
-            var geocoder = new Geocoder(this);
-#pragma warning disable CA1422 // Suppress warning for obsolete API on Android 33+
-            var addresses = await Task.Run(() => geocoder.GetFromLocationName(query, 1));
-#pragma warning restore CA1422
-            var address = addresses?.FirstOrDefault();
-            if (address != null)
-            {
-                var latLng = new LatLng(address.Latitude, address.Longitude);
-                RunOnUiThread(() =>
-                {
-                    googleMap?.AnimateCamera(CameraUpdateFactory.NewLatLngZoom(latLng, 10));
-                });
-            }
-            else
-            {
-                RunOnUiThread(() =>
-                {
-                    Toast.MakeText(this, "Luogo non trovato", ToastLength.Short).Show();
-                });
-            }
-        }
-    }
-}
@@ -1,20 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFramework>net9.0-android</TargetFramework>
-    <SupportedOSPlatformVersion>21</SupportedOSPlatformVersion>
-    <OutputType>Exe</OutputType>
-    <Nullable>enable</Nullable>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <ApplicationId>com.companyname.Nuvolari</ApplicationId>
-    <ApplicationVersion>1</ApplicationVersion>
-    <ApplicationDisplayVersion>1.0</ApplicationDisplayVersion>
-    <!--
-      Enables trim analyzers and full trimming during Release mode.
-      To learn more, see: https://learn.microsoft.com/dotnet/core/deploying/trimming/trimming-options#trimming-granularity
-    -->
-    <TrimMode>full</TrimMode>
-  </PropertyGroup>
-  <ItemGroup>
-    <PackageReference Include="Xamarin.GooglePlayServices.Maps" Version="119.2.0.1" />
-  </ItemGroup>
-</Project>
@@ -1,25 +0,0 @@
-
-Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 17
-VisualStudioVersion = 17.13.35931.197 d17.13
-MinimumVisualStudioVersion = 10.0.40219.1
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Nuvolari", "Nuvolari.csproj", "{B6CEEA40-2867-4F58-96EA-BB986DE9489C}"
-EndProject
-Global
-	GlobalSection(SolutionConfigurationPlatforms) = preSolution
-		Debug|Any CPU = Debug|Any CPU
-		Release|Any CPU = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{B6CEEA40-2867-4F58-96EA-BB986DE9489C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{B6CEEA40-2867-4F58-96EA-BB986DE9489C}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{B6CEEA40-2867-4F58-96EA-BB986DE9489C}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{B6CEEA40-2867-4F58-96EA-BB986DE9489C}.Release|Any CPU.Build.0 = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(SolutionProperties) = preSolution
-		HideSolutionNode = FALSE
-	EndGlobalSection
-	GlobalSection(ExtensibilityGlobals) = postSolution
-		SolutionGuid = {646B2C8A-0EA4-4133-AB5A-3C6DD1D72D94}
-	EndGlobalSection
-EndGlobal
@@ -1,44 +0,0 @@
-Images, layout descriptions, binary blobs and string dictionaries can be included 
-in your application as resource files.  Various Android APIs are designed to 
-operate on the resource IDs instead of dealing with images, strings or binary blobs 
-directly.
-
-For example, a sample Android app that contains a user interface layout (main.xml),
-an internationalization string table (strings.xml) and some icons (drawable-XXX/icon.png) 
-would keep its resources in the "Resources" directory of the application:
-
-Resources/
-    drawable/
-        icon.png
-
-    layout/
-        main.xml
-
-    values/
-        strings.xml
-
-In order to get the build system to recognize Android resources, set the build action to
-"AndroidResource".  The native Android APIs do not operate directly with filenames, but 
-instead operate on resource IDs.  When you compile an Android application that uses resources, 
-the build system will package the resources for distribution and generate a class called "Resource" 
-(this is an Android convention) that contains the tokens for each one of the resources 
-included. For example, for the above Resources layout, this is what the Resource class would expose:
-
-public class Resource {
-    public class Drawable {
-        public const int icon = 0x123;
-    }
-
-    public class Layout {
-        public const int main = 0x456;
-    }
-
-    public class Strings {
-        public const int first_string = 0xabc;
-        public const int second_string = 0xbcd;
-    }
-}
-
-You would then use Resource.Drawable.icon to reference the drawable/icon.png file, or 
-Resource.Layout.main to reference the layout/main.xml file, or Resource.Strings.first_string 
-to reference the first string in the dictionary file values/strings.xml.
@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
-    android:orientation="vertical"
-    android:layout_width="match_parent"
-    android:layout_height="match_parent">
-  <SearchView
-      android:id="@+id/searchView"
-      android:layout_width="match_parent"
-      android:layout_height="wrap_content"
-      android:queryHint="Cerca città o luogo" />
-  <fragment
-      android:id="@+id/map"
-      android:name="com.google.android.gms.maps.MapFragment"
-      android:layout_width="match_parent"
-      android:layout_height="0dp"
-      android:layout_weight="1" />
-</LinearLayout>
@@ -1,13 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:app="http://schemas.android.com/apk/res-auto"
-    xmlns:tools="http://schemas.android.com/tools"
-    android:layout_width="match_parent"
-    android:layout_height="match_parent">
-    <TextView 
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:layout_centerInParent="true"
-        android:text="@string/app_text"
-    />
-</RelativeLayout>
@@ -1,4 +0,0 @@
-<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
-  <background android:drawable="@mipmap/appicon_background" />
-  <foreground android:drawable="@mipmap/appicon_foreground" />
-</adaptive-icon>
@@ -1,4 +0,0 @@
-<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
-  <background android:drawable="@mipmap/appicon_background" />
-  <foreground android:drawable="@mipmap/appicon_foreground" />
-</adaptive-icon>
@@ -1,4 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<resources>
-    <color name="ic_launcher_background">#2C3E50</color>
-</resources>
@@ -1,4 +0,0 @@
-<resources>
-    <string name="app_name">Nuvolari</string>
-    <string name="app_text">Hello, Android!</string>
-</resources>