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/learning/language_learning_tour_detail_page.dartDart
import 'package:flutter/material.dart';
import '../../core/localization/app_localizations.dart';
import '../../core/theme/app_colors.dart';
import '../../models/language_learning_tour.dart';
import '../../models/localized_content.dart';
import '../../models/tour.dart';
import '../../models/transport_mode.dart';
import '../../widgets/tour_map.dart';
import '../../services/analytics_service.dart';
import 'language_learning_tour_run_page.dart';
import 'learning_unit_page.dart';
class LanguageLearningTourDetailPage extends StatelessWidget {
const LanguageLearningTourDetailPage({super.key, required this.tour});
final LanguageLearningTour tour;
Tour _mapTour(BuildContext context) {
final l10n = AppLocalizations.of(context);
final lang = Localizations.localeOf(context).languageCode;
String local(String key) => l10n.t(key);
return Tour(
id: 'learning-${tour.definition.id}',
title: LocalizedContent({lang: local(tour.definition.titleKey)}),
subtitle: LocalizedContent({lang: local(tour.definition.subtitleKey)}),
category: 'learning',
durationMinutes: tour.definition.durationMinutes,
distanceKm: 0,
highlight: false,
recommendedTransport: TransportMode.walking,
supportedTransportModes: const [TransportMode.walking],
stops: [
for (final stop in tour.stops)
if (stop.location?.poiId != null)
TourStop(
poiId: stop.location!.poiId!,
title: LocalizedContent({lang: stop.title}),
guideText: LocalizedContent({
lang: stop.units
.map((u) => '${u.phraseDe} — ${u.help}')
.join('\n'),
}),
walkMinutesFromPrevious: 0,
),
],
);
}
@override
Widget build(BuildContext context) {
final l10n = AppLocalizations.of(context);
final mapTour = _mapTour(context);
return Scaffold(
appBar: AppBar(title: Text(l10n.t('learningToursTitle'))),
body: ListView(
padding: const EdgeInsets.fromLTRB(20, 6, 20, 110),
children: [
Text(l10n.t(tour.definition.titleKey),
style: Theme.of(context)
.textTheme
.headlineSmall
?.copyWith(fontWeight: FontWeight.w900)),
const SizedBox(height: 8),
Text(l10n.t(tour.definition.subtitleKey),
style: const TextStyle(color: AppColors.mutedInk, height: 1.35)),
const SizedBox(height: 14),
Wrap(spacing: 8, runSpacing: 8, children: [
Chip(
avatar: const Icon(Icons.place_outlined, size: 18),
label: Text(l10n
.tf('learningTourStops', {'n': '${tour.stops.length}'}))),
Chip(
avatar: const Icon(Icons.translate_rounded, size: 18),
label: Text(l10n
.tf('learningTourLessons', {'n': '${tour.lessonCount}'}))),
Chip(
avatar: const Icon(Icons.schedule_rounded, size: 18),
label: Text(l10n.tf('learningTourMinutes',
{'n': '${tour.definition.durationMinutes}'}))),
]),
if (mapTour.stops.length >= 2) ...[
const SizedBox(height: 18),
TourMap(tour: mapTour, height: 280),
],
const SizedBox(height: 24),
Text(l10n.t('learningTourRoute'),
style: Theme.of(context)
.textTheme
.titleLarge
?.copyWith(fontWeight: FontWeight.w900)),
const SizedBox(height: 10),
for (var i = 0; i < tour.stops.length; i++) ...[
_StopCard(index: i + 1, stop: tour.stops[i]),
if (i < tour.stops.length - 1) const SizedBox(height: 12),
],
],
),
bottomNavigationBar: SafeArea(
minimum: const EdgeInsets.all(16),
child: FilledButton.icon(
onPressed: tour.stops.isEmpty
? null
: () {
AnalyticsService.instance.track('learning_tour_start',
properties: {
'learning_tour_id': tour.definition.id,
'stop_count': tour.stops.length
});
Navigator.of(context).push(MaterialPageRoute(
builder: (_) => LanguageLearningTourRunPage(tour: tour),
));
},
icon: const Icon(Icons.play_arrow_rounded),
label: Text(l10n.t('learningTourStart')),
),
),
);
}
}
class _StopCard extends StatelessWidget {
const _StopCard({required this.index, required this.stop});
final int index;
final LanguageLearningTourStop stop;
@override
Widget build(BuildContext context) {
final l10n = AppLocalizations.of(context);
return Container(
padding: const EdgeInsets.all(16),
decoration: BoxDecoration(
color: Colors.white,
border: Border.all(color: AppColors.line),
borderRadius: BorderRadius.circular(22)),
child: Column(crossAxisAlignment: CrossAxisAlignment.start, children: [
Row(crossAxisAlignment: CrossAxisAlignment.start, children: [
CircleAvatar(
radius: 20,
backgroundColor: AppColors.ink,
child: Text('$index',
style: const TextStyle(
color: Colors.white, fontWeight: FontWeight.w900))),
const SizedBox(width: 12),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(stop.title,
style: const TextStyle(
fontSize: 17, fontWeight: FontWeight.w900)),
const SizedBox(height: 3),
Text(
l10n.tf(
'learningTourLessons', {'n': '${stop.units.length}'}),
style: const TextStyle(color: AppColors.mutedInk)),
])),
]),
const SizedBox(height: 12),
for (final unit in stop.units)
ListTile(
contentPadding: EdgeInsets.zero,
dense: true,
leading:
const Icon(Icons.translate_rounded, color: AppColors.heartRed),
title: Text(unit.phraseDe,
style: const TextStyle(fontWeight: FontWeight.w800)),
subtitle:
Text(unit.help, maxLines: 2, overflow: TextOverflow.ellipsis),
trailing: const Icon(Icons.chevron_right_rounded),
onTap: () => Navigator.of(context).push(MaterialPageRoute(
builder: (_) => LearningUnitPage(unit: unit))),
),
]),
);
}
}

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%