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/partner_repository.dartDart
import '../core/api/meinweimar_api_client.dart';
import '../core/text/wp_text.dart';
import '../models/partner.dart';
class PartnerRepository {
const PartnerRepository(this.api);
final MeinWeimarApiClient api;
Future<List<Partner>> fetchAll({required String languageCode}) async {
final data = await api.getJson(
'/partners',
query: {'lang': languageCode, 'per_page': '100'},
);
return (data['items'] as List? ?? const [])
.whereType<Map<String, dynamic>>()
.map(_fromJson)
.toList();
}
Future<Partner> fetchOne({
required String id,
required String languageCode,
}) async {
final data = await api.getJson(
'/partners/$id',
query: {'lang': languageCode},
);
return _fromJson(data);
}
Partner _fromJson(Map<String, dynamic> j) {
final loc = j['location'] as Map<String, dynamic>? ?? const {};
final address = j['address'] as Map<String, dynamic>? ?? const {};
final contact = j['contact'] as Map<String, dynamic>? ?? const {};
final gastro = j['gastro'] as Map<String, dynamic>? ?? const {};
final coupon = j['coupon'] as Map<String, dynamic>? ?? const {};
final content = j['content'] as Map<String, dynamic>? ?? const {};
final featured = WpText.url((j['image'] as Map<String, dynamic>?)?['url']);
final gallery = (j['gallery'] as List? ?? const [])
.whereType<Map<String, dynamic>>()
.map((image) => WpText.url(image['url']) ?? '')
.where((url) => url.trim().isNotEmpty && url != featured)
.toSet()
.toList(growable: false);
return Partner(
id: j['id'].toString(),
title: content['title']?.toString().trim().isNotEmpty == true
? WpText.plain(content['title'])
: WpText.plain(j['title']),
latitude: (loc['lat'] as num?)?.toDouble() ?? 0,
longitude: (loc['lng'] as num?)?.toDouble() ?? 0,
imageUrl: featured,
galleryUrls: gallery,
partnerType: j['partner_type']?.toString(),
status: j['partner_status']?.toString(),
sponsored: j['sponsored'] == true,
priority: (j['priority'] as num?)?.toInt() ?? 0,
shortDescription:
content['short_text']?.toString().trim().isNotEmpty == true
? WpText.plain(content['short_text'])
: WpText.nullablePlain(j['short_description']),
description:
content['description_text']?.toString().trim().isNotEmpty == true
? WpText.plain(content['description_text'])
: WpText.nullablePlain(j['description_html']),
address: WpText.nullablePlain(address['formatted']),
openingHours: WpText.nullablePlain(j['opening_hours']),
websiteUrl: WpText.url(contact['website_url']),
bookingUrl: WpText.url(contact['booking_url']),
cuisine: WpText.nullablePlain(gastro['cuisine']),
priceLevel: WpText.nullablePlain(gastro['price_level']),
dayparts: (gastro['dayparts'] as List? ?? const [])
.map((e) => e.toString())
.toList(growable: false),
maxDetourMinutes: (gastro['max_detour_minutes'] as num?)?.toInt(),
goodForShortBreak: gastro['good_for_short_break'] == true,
goodForTourEnd: gastro['good_for_tour_end'] == true,
couponActive: coupon['active'] == true,
couponCode: WpText.nullablePlain(coupon['code']),
couponText: WpText.nullablePlain(coupon['text']),
preferredTourIds: (j['preferred_tour_ids'] as List? ?? const [])
.map((e) => e.toString())
.toList(growable: false),
);
}
}

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%