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/widgets/tour_card.dartDart
import 'package:flutter/material.dart';
import '../core/localization/app_localizations.dart';
import '../core/theme/app_colors.dart';
import '../data/app_data_scope.dart';
import '../data/location_scope.dart';
import '../data/location_store.dart';
import '../models/tour.dart';
import 'proximity_label.dart';
import 'tour_featured_header.dart';
class TourCard extends StatelessWidget {
const TourCard({
super.key,
required this.tour,
required this.languageCode,
required this.onTap,
this.compact = false,
});
final Tour tour;
final String languageCode;
final VoidCallback onTap;
final bool compact;
@override
Widget build(BuildContext context) {
final l10n = AppLocalizations.of(context);
final title = tour.title.get(languageCode);
final subtitle = tour.subtitle.get(languageCode);
final data = AppDataScope.of(context);
final location = LocationScope.of(context);
int? distanceMeters;
int? walkingMinutes;
for (final stop in tour.stops) {
final poi = data.poiById(stop.poiId);
if (!LocationStore.isUsableTarget(poi.latitude, poi.longitude)) {
continue;
}
distanceMeters = location.distanceMetersTo(
poi.latitude,
poi.longitude,
);
walkingMinutes = location.walkingMinutesTo(
poi.latitude,
poi.longitude,
);
break;
}
return InkWell(
onTap: onTap,
borderRadius: BorderRadius.circular(22),
child: Ink(
width: compact ? 275 : double.infinity,
decoration: BoxDecoration(
color: AppColors.surface,
borderRadius: BorderRadius.circular(22),
border: Border.all(color: AppColors.line),
),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
TourFeaturedHeader(
imageUrl: tour.imageUrl,
title: title,
height: compact ? 120 : 150,
compact: true,
borderRadius: const BorderRadius.vertical(
top: Radius.circular(21),
),
),
Padding(
padding: const EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
title,
maxLines: 2,
overflow: TextOverflow.ellipsis,
style: Theme.of(context)
.textTheme
.titleMedium
?.copyWith(fontWeight: FontWeight.w800),
),
const SizedBox(height: 6),
Text(
subtitle,
maxLines: 2,
overflow: TextOverflow.ellipsis,
style: Theme.of(context)
.textTheme
.bodyMedium
?.copyWith(color: AppColors.mutedInk),
),
if (distanceMeters != null) ...[
const SizedBox(height: 9),
ProximityLabel(
distanceMeters: distanceMeters,
walkingMinutes: walkingMinutes,
compact: compact,
),
],
const SizedBox(height: 10),
Wrap(
spacing: 6,
runSpacing: 6,
children: [
if (tour.familyFriendly)
_TourTrait(
icon: Icons.family_restroom_rounded,
label: l10n.t('family')),
if (tour.offlineReady)
_TourTrait(
icon: Icons.offline_pin_rounded,
label: l10n.t('offline')),
_TourTrait(
icon: Icons.pin_drop_outlined,
label: l10n
.tf('tourStopsCount', {'n': tour.stops.length})),
],
),
const SizedBox(height: 13),
Row(
children: [
const Icon(Icons.schedule, size: 17),
const SizedBox(width: 5),
Text('${tour.durationMinutes} ${l10n.t('minutesShort')}'),
const SizedBox(width: 14),
const Icon(Icons.route, size: 17),
const SizedBox(width: 5),
Text('${tour.distanceKm.toStringAsFixed(1)} km'),
const Spacer(),
const Icon(Icons.arrow_forward_rounded),
],
),
],
),
),
],
),
),
);
}
}
class _TourTrait extends StatelessWidget {
const _TourTrait({required this.icon, required this.label});
final IconData icon;
final String label;
@override
Widget build(BuildContext context) => Container(
padding: const EdgeInsets.symmetric(horizontal: 7, vertical: 4),
decoration: BoxDecoration(
color: AppColors.softPink,
borderRadius: BorderRadius.circular(999),
),
child: Row(
mainAxisSize: MainAxisSize.min,
children: [
Icon(icon, size: 13, color: AppColors.heartRed),
const SizedBox(width: 4),
Text(label,
style:
const TextStyle(fontSize: 10, fontWeight: FontWeight.w800)),
],
),
);
}

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%