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/repositories/tour_repository.dartDart
import 'package:latlong2/latlong.dart';
import '../core/api/meinweimar_api_client.dart';
import '../core/localization/app_localizations.dart';
import '../core/text/wp_text.dart';
import '../models/localized_content.dart';
import '../models/poi.dart';
import '../models/tour.dart';
import '../models/transport_mode.dart';
class TourRepository {
const TourRepository(this.api);
final MeinWeimarApiClient api;
Future<List<Tour>> fetchAll(
{required String languageCode, required Map<String, Poi> pois}) async {
final data = await api
.getJson('/tours', query: {'lang': languageCode, 'per_page': '100'});
final items =
(data['items'] as List? ?? const []).whereType<Map<String, dynamic>>();
return items.map((j) => _fromJson(j, languageCode, pois)).toList();
}
Tour _fromJson(Map<String, dynamic> j, String lang, Map<String, Poi> pois) {
final content = j['content'] as Map<String, dynamic>? ?? const {};
final topics = (j['topics'] as List? ?? const [])
.whereType<Map<String, dynamic>>()
.toList();
final names = topics
.map((e) => WpText.plain(e['name']))
.where((e) => e.isNotEmpty)
.toList();
final slugs = topics
.map((e) => e['slug']?.toString() ?? '')
.where((e) => e.isNotEmpty)
.toList();
final eras = (j['eras'] as List? ?? j['era'] as List? ?? const [])
.whereType<Map>()
.map((e) => Map<String, dynamic>.from(e))
.toList();
final eraNames = eras
.map((e) => WpText.plain(e['name']))
.where((e) => e.isNotEmpty)
.toList();
final eraSlugs = eras
.map((e) => e['slug']?.toString() ?? '')
.where((e) => e.isNotEmpty)
.toList();
final category = names.contains('Bauhaus')
? 'Bauhaus'
: names.contains('Klassik')
? 'Klassik'
: (names.isNotEmpty ? names.first : 'Highlights');
final rawStops = (j['stops'] as List? ?? const [])
.whereType<Map<String, dynamic>>()
.toList();
final stops = <TourStop>[];
const distance = Distance();
Poi? previous;
for (final row in rawStops) {
final poi = pois[row['poi_id'].toString()];
if (poi == null) continue;
final walkMinutes = previous == null
? 0
: (distance(LatLng(previous.latitude, previous.longitude),
LatLng(poi.latitude, poi.longitude)) /
75)
.round()
.clamp(1, 99)
.toInt();
stops.add(TourStop(
poiId: poi.id,
title: poi.title,
guideText: poi.guideText,
walkMinutesFromPrevious: walkMinutes,
audioUrls: poi.audioUrls,
));
previous = poi;
}
final title = WpText.plain(content['title'] ?? j['title']);
final subtitle =
WpText.plain(content['short_text'] ?? j['short_description']);
final distanceKm = (j['distance_km'] as num?)?.toDouble() ??
_estimateDistance(stops, pois);
final transport = j['transport'] as Map<String, dynamic>? ?? const {};
final apiSupported = (transport['supported'] as List? ?? const [])
.map((e) => TransportModeInfo.fromApi(e.toString()))
.toSet()
.toList(growable: false);
final recommendation = transport['recommended'] != null
? TransportModeInfo.fromApi(transport['recommended'].toString())
: _recommendTransport(distanceKm, stops.length);
final supported = apiSupported.isNotEmpty
? apiSupported
: _supportedTransport(distanceKm);
return Tour(
id: j['id'].toString(),
title: LocalizedContent({lang: title}),
subtitle: LocalizedContent({lang: subtitle}),
category: category,
durationMinutes: (j['duration_minutes'] as num?)?.round() ?? 0,
distanceKm: distanceKm,
stops: stops,
highlight: true,
imageUrl: WpText.url((j['image'] as Map<String, dynamic>?)?['url']),
familyFriendly: (j['target_groups'] as List? ?? const [])
.any((e) => e is Map && e['slug'] == 'familien'),
offlineReady: false,
recommendedTransport: recommendation,
supportedTransportModes: supported,
transportNote: WpText.nullablePlain(transport['note']) ??
_transportNote(distanceKm, recommendation, lang),
topicSlugs: slugs,
topicNames: names,
eraSlugs: eraSlugs,
eraNames: eraNames,
);
}
TransportMode _recommendTransport(double distanceKm, int stops) {
if (distanceKm <= 4.0) return TransportMode.walking;
if (distanceKm <= 10.0) return TransportMode.bicycle;
return TransportMode.publicTransit;
}
List<TransportMode> _supportedTransport(double distanceKm) {
if (distanceKm <= 4.0) {
return const [
TransportMode.walking,
TransportMode.bicycle,
TransportMode.publicTransit,
];
}
if (distanceKm <= 10.0) {
return const [
TransportMode.bicycle,
TransportMode.publicTransit,
TransportMode.carMotorcycle,
];
}
return const [
TransportMode.publicTransit,
TransportMode.carMotorcycle,
TransportMode.bicycle,
];
}
String _transportNote(double distanceKm, TransportMode mode, String lang) {
if (mode == TransportMode.walking) {
return AppLocalizations.tFor(lang, 'transportNoteWalk');
}
if (mode == TransportMode.bicycle) {
return AppLocalizations.tFor(lang, 'transportNoteBike');
}
if (mode == TransportMode.publicTransit) {
return AppLocalizations.tFor(lang, 'transportNoteTransit');
}
return AppLocalizations.tFor(lang, 'transportNoteCar');
}
double _estimateDistance(List<TourStop> stops, Map<String, Poi> pois) {
if (stops.length < 2) return 0;
const d = Distance();
double meters = 0;
for (var i = 1; i < stops.length; i++) {
final a = pois[stops[i - 1].poiId];
final b = pois[stops[i].poiId];
if (a != null && b != null) {
meters +=
d(LatLng(a.latitude, a.longitude), LatLng(b.latitude, b.longitude));
}
}
return meters / 1000;
}
}

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%