Sascha Haselhuhn

glanzlicht / Meinweimar_Tourguide

Intelligenter Tourguide für Weimar

Verified secure showcase
167 Files 833 KB Public size 12 Redacted Dart · Markdown · YAML · HTML · JSON · GITIGNORE

Project overview

Meinweimar_Tourguide is a verified code showcase with 167 visible project entries across 5 top-level modules. The primary detected language is Dart; protected files remain visible in the structure while their contents stay private.

README

MeinWeimar Tourguide

MeinWeimar Tourguide

Eine produktionsnahe Flutter-App fuer Stadtentdeckung, Tourplanung und Sprachlernen in Weimar. Die App verbindet eine responsive mobile und webfaehige Oberflaeche mit einer WordPress-REST-API und macht aus redaktionellen Inhalten konkrete Wege, Orte und Empfehlungen.

Dieses Repository zeigt neben der UI auch die technische Produktarbeit dahinter: API-Integration, Offline-tolerante Datenhaltung, Lokalisierung, Routing, Audio/TTS, Analytics, Deep Links und automatisierte Qualitaetssicherung.

App-Eindruecke

Startseite Entdecken Touren Karte Mehr-Menue
Start · Entdecken · Touren · Karte · Mehr

Produktumfang

  • Entdecken: POIs, Touren, Veranstaltungen, Partner und Themen mit Suche,

    • Filtern und fehlertoleranter Trefferlogik.

  • Unterwegs: Kartenansicht, Standort, Fussgaenger-Routing, Tourfortschritt,

    • Favoriten und eine persoenliche Route aus der eigenen Weimar-Liste.

  • Mehrsprachigkeit: UI und CMS-Inhalte in Deutsch, Englisch,

    • Niederlaendisch, Franzoesisch, Polnisch, Italienisch, Spanisch und Tschechisch.

  • Audio und Lernen: Guide-Audio, Flutter TTS sowie SprachGuide-Kurse und

    • Lern-Touren.

  • Redaktion und Betrieb: WordPress REST API, Oeffnungszeiten mit

    • Zeitzonenlogik, Kampagnen, Partnerplatzierungen, Deep Links und First-Party- Analytics.

  • Responsive UX: kleine Displays, grosse Systemschrift, dynamische

    • Kartenhoehen und versionierte Web-Releases ohne veraltete Service-Worker- Assets.

Technischer Steckbrief

BereichUmsetzung
FrameworkFlutter / Dart 3.4+
PlattformeniOS, Android und Web
DatenWordPress REST API, typisierte Models und Repositories
Kartenflutter_map, latlong2, Standort und Fussgaenger-Routing
Audiojust_audio, flutter_tts
Lokaler ZustandShared Preferences, begrenztes Caching und Analytics-Puffer
QualitaetFlutter Analyzer, Widget- und Service-Tests, Lokalisierungs- und API-Modelltests

Die Codebasis ist nach Verantwortlichkeiten gegliedert:

lib/
	core/          gemeinsame API-, Lokalisierungs- und Navigationslogik
	data/          Datenzugriff und DTO-nahe Strukturen
	features/      produktbezogene Screens und Flows
	models/        fachliche Modelle
	repositories/  Datenzugriff hinter stabilen Schnittstellen
	services/      Routing, Audio, Analytics und Plattformdienste
	widgets/       wiederverwendbare UI-Bausteine
test/            fokussierte Tests fuer Services, Modelle und Widgets

Lokal starten

Voraussetzungen: aktuelles Flutter SDK und das darin enthaltene Dart SDK.

flutter pub get
flutter analyze
flutter test
flutter run -d chrome

Die Anwendung verwendet standardmaessig die oeffentliche API: https://tour.meinweimar.de/wp-json/meinweimar/v1

Web-Release

Fuer einen Web-Release das versionierte Build-Skript verwenden:

./tool/build_web_release.sh

Das Skript legt den Runtime-Build unter build/web/releases/<release-id>/ ab. Launcher und Versionsendpunkt bleiben bewusst nicht cachebar, damit Browser nach einem Reload die aktuelle Version auflosen. Startup-Diagnostik ist nur mit ?mwdebug=1 aktiv.

Dokumentation

  • [Deep Links](DEEP_LINKS.md) - Web-Routen fuer Bereiche, Touren und POIs
  • [Projektstatus](PROJECT_STATE.md) - aktueller Funktions- und Integrationsstand
  • [Changelog](CHANGELOG.md) - nachvollziehbare Produkt- und UX-Iterationen
  • [API-Integration](docs/API_INTEGRATION.md) - technische Integrationsnotizen
docs/FUNCTION_AUDIT.mdMarkdown
# v0.6.0 Function Audit
This audit removes the inert controls found in v0.5.1 and documents every visible interaction touched in v0.6.0.
## Fixed inert controls
- Home bookmark icon with empty handler: removed until real favourites persistence exists.
- Home quick chips: converted from passive `Chip` to working `ActionChip` navigation.
- Map fake search container: replaced by functional `TextField` search.
- Map POI “Details” empty handler: now opens `PoiDetailPage`.
- Map fake GPS/center ambiguity: split into “center Weimar” and real “my location”.
## Functional interaction paths
1. Home → Route zusammenstellen → planner screen.
2. Home → Interaktive Karte → map screen.
3. Home quick choice → pre-filtered ToursPage.
4. Home featured tour → TourDetailPage.
5. Sponsored Home banner → campaign landing placeholder.
6. Tours search → title/subtitle/category filtering.
7. Tours chips → category/highlight/family/time filtering.
8. Tours reset → clears all filters and search field.
9. Tour card → TourDetailPage.
10. Map search → filters markers.
11. Map category chips → filters markers.
12. Map marker → selection card.
13. POI details arrow → PoiDetailPage.
14. Map Weimar button → city center.
15. Map location button → geolocator current position or visible error snackbar.
16. Planner slider/chips/switch → invalidates old result.
17. Planner generate → builds new Tour and renders TourMap.
18. Planner result CTA → TourDetailPage.
19. TourDetail → pedestrian map + start guide.
20. Guide → live geolocation/routing + text/audio controls.
21. Splash ad CTA → campaign page; skip → app.
22. Tour/Tours/Planner ads → campaign page.
## Verification limitation in this build environment
The source tree was statically audited for inert empty tap/press handlers and pure logic tests were added. The container used to assemble this ZIP does not contain the Flutter SDK, so `flutter analyze`/`flutter test` cannot be executed here. They must be run on the developer machine before calling the build device-verified.

Architecture

High-level modules detected from the verified public snapshot. Protected implementation details are intentionally omitted.

libmodule
testmodule
docsmodule
webmodule
toolmodule

Technology stack

DartMarkdownLOCKHTMLShellHTACCESSFlutter / Dart
Dart89.9%
Markdown3.9%
LOCK3.1%
HTML1.7%
Shell0.8%
HTACCESS0.2%
YAML0.1%
METADATA0.1%