Files
Alby96andClaude Opus 5 f3a0e3794a Narrow scope to radar, and put the app on a real OpenStreetMap base map
Drops forecasts, lightning, the home-screen widget and advertising. What
remains is radar on a map, the official ARPA alert bulletin, and rain
notifications.

The base map is now OpenFreeMap's Positron style: real OpenStreetMap vector
tiles with no API key, no registration, no request limits and commercial use
permitted. Every other free tier — MapTiler, Stadia, Jawg, Thunderforest —
needs a key, which is a secret to manage, a quota to outgrow and a signup to
complete before anyone can build the project, and the map is the one thing the
app cannot work without. Positron rather than Liberty or Bright because the
radar overlay has to be the loudest thing on screen, and a desaturated grey
base is built to sit under data.

Its style JSON carries no `attribution` field, so MapLibre displays no credits
by itself. The app renders them from the region config instead: the two
mandatory credits, OpenStreetMap and OpenMapTiles, go in the always-visible
bar, and OpenFreeMap's own credit — optional by their terms — is listed on the
Sources screen with the rest. The bundled offline style is still reachable with
MAP_STYLE_URL=offline, and still claims no base map attribution, because
crediting OpenStreetMap while showing it would be a false claim.

Radar-DPC stays the source. ARPA Piemonte's own radar remains a disabled stub
for two reasons that belong to the project owner, not to the code: the
real-time access link is only issued by email, and the open-data page states
the data is "gratuiti" and nothing else. Free of charge is not a licence, and
rendering those volumes into frames served from a CDN is redistribution. Both
questions go in the same email. An earlier draft of the docs recorded ARPA
radar as CC BY 4.0; the source page does not support that, so the claim is
removed rather than carried forward.

The documentation is updated throughout rather than annotated: CLAUDE.md gains
an explicit scope boundary, data-sources drops MET Norway and ISTAT and gains
the base map, licenses records that free of charge is not a licence, privacy
loses the whole advertising section, and the roadmap is renumbered so the
backend worker is next — until it exists, DpcRadarSource has nothing to read.

licenses.md keeps Open-Meteo and Blitzortung listed as excluded even though the
features that would have used them are gone: both are non-commercial-only, ads
are a plausible future, and neither should be adopted on the grounds that there
are none today.

Verified: analyze clean, 130 tests passing, and on the emulator the radar
overlay sits correctly over Piedmont on real OSM tiles with Turin, Milan and
Genoa labelled, the age reads "Aggiornato 4 minuti fa", and the Sources screen
lists all five credits with their licences.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 16:10:29 +02:00

76 lines
2.7 KiB
JSON

{
// Debug configurations for the Run and Debug panel (F5).
//
// Open the "Nuvolari" folder as the VS Code workspace root — these paths are
// relative to it, not to the repository root.
//
// Every configuration boots the Android emulator first via a preLaunchTask,
// so F5 works from a cold machine with no manual step. The task returns
// immediately if a device is already attached.
"version": "0.2.0",
"configurations": [
{
// The everyday one: demo mode, no env.json needed, hot reload on save.
"name": "Nuvolari — debug (emulatore)",
"type": "dart",
"request": "launch",
"program": "${workspaceFolder}/app/lib/main.dart",
"cwd": "${workspaceFolder}/app",
"deviceId": "emulator-5554",
"flutterMode": "debug",
"preLaunchTask": "Avvia emulatore Android"
},
{
// Debug builds run the Dart VM unoptimised, so animation always looks
// worse than it is. Judge the radar timeline here, never in debug.
"name": "Nuvolari — profile (misura le prestazioni)",
"type": "dart",
"request": "launch",
"program": "${workspaceFolder}/app/lib/main.dart",
"cwd": "${workspaceFolder}/app",
"deviceId": "emulator-5554",
"flutterMode": "profile",
"preLaunchTask": "Avvia emulatore Android"
},
{
// Same as the first, but pointed at a live radar manifest. Requires
// env.json, which is git-ignored — copy env.example.json and fill it in.
"name": "Nuvolari — debug con env.json",
"type": "dart",
"request": "launch",
"program": "${workspaceFolder}/app/lib/main.dart",
"cwd": "${workspaceFolder}/app",
"deviceId": "emulator-5554",
"flutterMode": "debug",
"toolArgs": ["--dart-define-from-file=${workspaceFolder}/env.json"],
"preLaunchTask": "Avvia emulatore Android"
},
{
// Runs on the workstation instead of a device: no emulator, no Android
// build, seconds to start. Good for UI work; the native map will not
// render here, so it is useless for anything map-related.
"name": "Nuvolari — debug su Windows (senza mappa)",
"type": "dart",
"request": "launch",
"program": "${workspaceFolder}/app/lib/main.dart",
"cwd": "${workspaceFolder}/app",
"deviceId": "windows",
"flutterMode": "debug"
},
{
"name": "Test — tutti",
"type": "dart",
"request": "launch",
"program": "${workspaceFolder}/app/test",
"cwd": "${workspaceFolder}/app"
},
{
"name": "Test — file corrente",
"type": "dart",
"request": "launch",
"program": "${file}",
"cwd": "${workspaceFolder}/app"
}
]
}