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

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
lib/features/shell/main_shell.dartDart
import 'package:flutter/material.dart';
import '../../core/localization/app_localizations.dart';
import '../../core/navigation/deep_link.dart';
import '../../services/analytics_service.dart';
import '../../services/settings_service.dart';
import '../categories/categories_page.dart';
import '../home/home_page.dart';
import '../map/map_page.dart';
import '../tours/tours_page.dart';
import '../favorites/favorites_page.dart';
import '../offline/offline_downloads_page.dart';
import '../learning/learning_home_page.dart';
import '../learning/new_in_weimar_page.dart';
import '../settings/settings_page.dart';
import 'deep_link_detail_page.dart';
import 'extras_drawer.dart';
class MainShell extends StatefulWidget {
const MainShell({super.key, required this.settings, this.initialDeepLink});
final SettingsService settings;
final DeepLink? initialDeepLink;
@override
State<MainShell> createState() => _MainShellState();
}
class _MainShellState extends State<MainShell> {
final _scaffoldKey = GlobalKey<ScaffoldState>();
late int _index;
static const _screenNames = ['home', 'discover', 'tours', 'map'];
@override
void initState() {
super.initState();
_index = _indexFor(widget.initialDeepLink);
if (widget.initialDeepLink != null && !widget.initialDeepLink!.isHome) {
AnalyticsService.instance.track('deep_link_open', properties: {
'deep_link_kind': widget.initialDeepLink!.kind.name,
'object_id': widget.initialDeepLink!.id ?? ''
});
}
AnalyticsService.instance.screenView(_screenNames[_index]);
WidgetsBinding.instance.addPostFrameCallback((_) => _openInitialDeepLink());
}
int _indexFor(DeepLink? link) {
switch (link?.kind) {
case DeepLinkKind.discover:
return 1;
case DeepLinkKind.tours:
return 2;
case DeepLinkKind.map:
return 3;
default:
return 0;
}
}
void _openInitialDeepLink() {
if (!mounted) {
return;
}
final link = widget.initialDeepLink;
if (link == null ||
link.isHome ||
link.kind == DeepLinkKind.discover ||
link.kind == DeepLinkKind.tours ||
link.kind == DeepLinkKind.map) {
return;
}
Widget? page;
switch (link.kind) {
case DeepLinkKind.favorites:
page = const FavoritesPage();
break;
case DeepLinkKind.offline:
page = const OfflineDownloadsPage();
break;
case DeepLinkKind.learnGerman:
page = const LearningHomePage();
break;
case DeepLinkKind.newInWeimar:
page = const NewInWeimarPage();
break;
case DeepLinkKind.settings:
page = SettingsPage(settings: widget.settings);
break;
case DeepLinkKind.tour:
case DeepLinkKind.poi:
page = DeepLinkDetailPage(deepLink: link);
break;
case DeepLinkKind.unknown:
case DeepLinkKind.home:
case DeepLinkKind.discover:
case DeepLinkKind.tours:
case DeepLinkKind.map:
break;
}
if (page != null) {
Navigator.of(context).push(MaterialPageRoute(builder: (_) => page!));
}
}
void _selectDestination(int value) {
if (value == 4) {
AnalyticsService.instance.screenView('extras');
_scaffoldKey.currentState?.openEndDrawer();
return;
}
setState(() => _index = value);
AnalyticsService.instance.screenView(_screenNames[value]);
}
@override
Widget build(BuildContext context) {
final l10n = AppLocalizations.of(context);
final pages = [
const HomePage(),
const CategoriesPage(),
const ToursPage(),
const MapPage(),
];
return Scaffold(
key: _scaffoldKey,
body: IndexedStack(index: _index, children: pages),
endDrawer: ExtrasDrawer(settings: widget.settings),
bottomNavigationBar: NavigationBar(
selectedIndex: _index,
onDestinationSelected: _selectDestination,
destinations: [
NavigationDestination(
icon: const Icon(Icons.home_outlined),
selectedIcon: const Icon(Icons.home_rounded),
label: l10n.t('home'),
),
NavigationDestination(
icon: const Icon(Icons.grid_view_outlined),
selectedIcon: const Icon(Icons.grid_view_rounded),
label: l10n.t('discover'),
),
NavigationDestination(
icon: const Icon(Icons.route_outlined),
selectedIcon: const Icon(Icons.route),
label: l10n.t('tours'),
),
NavigationDestination(
icon: const Icon(Icons.map_outlined),
selectedIcon: const Icon(Icons.map),
label: l10n.t('map'),
),
NavigationDestination(
icon: const Icon(Icons.more_horiz_rounded),
selectedIcon: const Icon(Icons.more_horiz_rounded),
label: l10n.t('more'),
),
],
),
);
}
}

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%