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/partners/partner_detail_page.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 '../../models/partner.dart';
import '../../services/analytics_service.dart';
import '../../services/external_link_service.dart';
import '../../widgets/media_gallery.dart';
import '../../widgets/opening_hours.dart';
import '../../widgets/remote_image.dart';
import '../../widgets/proximity_label.dart';
class PartnerDetailPage extends StatefulWidget {
const PartnerDetailPage({super.key, required this.partner});
final Partner partner;
@override
State<PartnerDetailPage> createState() => _PartnerDetailPageState();
}
class _PartnerDetailPageState extends State<PartnerDetailPage> {
static const _links = ExternalLinkService();
late Partner _partner;
bool _loadingDetail = true;
@override
void initState() {
super.initState();
_partner = widget.partner;
AnalyticsService.instance.track(
'partner_view',
properties: {'partner_id': widget.partner.id},
);
WidgetsBinding.instance.addPostFrameCallback((_) => _loadDetail());
}
Future<void> _loadDetail() async {
final detail =
await AppDataScope.read(context).partnerDetail(widget.partner.id);
if (!mounted) return;
setState(() {
_partner = detail;
_loadingDetail = false;
});
}
Future<void> _open(String url, {required String action}) async {
final ok = await _links.open(url);
await AnalyticsService.instance.partnerClick(
partnerId: _partner.id,
success: ok,
action: action,
);
}
@override
Widget build(BuildContext context) {
final l10n = AppLocalizations.of(context);
final partner = _partner;
return Scaffold(
appBar: AppBar(),
body: ListView(
padding: const EdgeInsets.fromLTRB(20, 8, 20, 34),
children: [
RemoteImage(
url: partner.imageUrl,
height: 260,
width: double.infinity,
fit: BoxFit.cover,
borderRadius: BorderRadius.circular(28),
fallbackIcon: Icons.restaurant_rounded,
fallbackIconSize: 72,
semanticLabel: partner.title,
),
const SizedBox(height: 18),
Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
OpeningStatusBadge(openingHours: partner.openingHours),
if (partner.openingHours?.trim().isNotEmpty == true)
const SizedBox(height: 8),
if (partner.partnerType?.trim().isNotEmpty == true)
Text(
partner.partnerType!.toUpperCase(),
style: const TextStyle(
color: AppColors.heartRed,
fontWeight: FontWeight.w900,
letterSpacing: 1.1,
),
),
const SizedBox(height: 6),
Text(
partner.title,
style: Theme.of(context)
.textTheme
.headlineSmall
?.copyWith(fontWeight: FontWeight.w900),
),
],
),
),
if (partner.sponsored) const _SponsoredLabel(),
],
),
if (partner.shortDescription?.trim().isNotEmpty == true) ...[
const SizedBox(height: 10),
Text(
partner.shortDescription!,
style: Theme.of(context).textTheme.bodyLarge,
),
],
Builder(
builder: (context) {
final location = LocationScope.of(context);
final meters = location.distanceMetersTo(
partner.latitude,
partner.longitude,
);
if (meters == null) return const SizedBox.shrink();
return Padding(
padding: const EdgeInsets.only(top: 12),
child: ProximityLabel(
distanceMeters: meters,
walkingMinutes: location.walkingMinutesTo(
partner.latitude,
partner.longitude,
),
),
);
},
),
if (_loadingDetail) ...[
const SizedBox(height: 14),
const LinearProgressIndicator(minHeight: 2),
],
if (partner.galleryUrls.isNotEmpty) ...[
const SizedBox(height: 30),
MediaGallery(
urls: partner.galleryUrls,
title: l10n.t('images'),
),
],
if (partner.couponActive &&
partner.couponText?.trim().isNotEmpty == true) ...[
const SizedBox(height: 26),
Container(
padding: const EdgeInsets.all(16),
decoration: BoxDecoration(
color: AppColors.softPink,
borderRadius: BorderRadius.circular(20),
),
child: Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
const Icon(
Icons.local_offer_outlined,
color: AppColors.heartRed,
),
const SizedBox(width: 10),
Expanded(
child: Text(
partner.couponText!,
style: const TextStyle(
color: AppColors.heartRed,
fontWeight: FontWeight.w800,
),
),
),
],
),
),
],
if (partner.description?.trim().isNotEmpty == true) ...[
const SizedBox(height: 28),
Text(
l10n.t('aboutPlace'),
style: Theme.of(context)
.textTheme
.titleLarge
?.copyWith(fontWeight: FontWeight.w900),
),
const SizedBox(height: 10),
Text(
partner.description!,
style:
Theme.of(context).textTheme.bodyLarge?.copyWith(height: 1.55),
),
],
const SizedBox(height: 24),
Wrap(
spacing: 8,
runSpacing: 8,
children: [
if (partner.cuisine?.trim().isNotEmpty == true)
Chip(
avatar: const Icon(Icons.restaurant_menu, size: 17),
label: Text(partner.cuisine!),
),
if (partner.priceLevel?.trim().isNotEmpty == true)
Chip(
avatar: const Icon(Icons.euro, size: 17),
label: Text(l10n.tf('price', {'level': partner.priceLevel!})),
),
],
),
if (partner.openingHours?.trim().isNotEmpty == true) ...[
const SizedBox(height: 20),
OpeningHoursSection(openingHours: partner.openingHours),
],
if (partner.address?.trim().isNotEmpty == true) ...[
const SizedBox(height: 12),
_DetailRow(
icon: Icons.place_outlined,
title: l10n.t('address'),
value: partner.address!,
),
],
if (partner.bookingUrl?.trim().isNotEmpty == true) ...[
const SizedBox(height: 24),
FilledButton.icon(
onPressed: () => _open(partner.bookingUrl!, action: 'booking'),
icon: const Icon(Icons.calendar_month_outlined),
label: Text(l10n.t('reserve')),
),
],
if (partner.websiteUrl?.trim().isNotEmpty == true) ...[
const SizedBox(height: 10),
OutlinedButton.icon(
onPressed: () => _open(partner.websiteUrl!, action: 'website'),
icon: const Icon(Icons.language_rounded),
label: Text(l10n.t('openWebsite')),
),
],
],
),
);
}
}
class _DetailRow extends StatelessWidget {
const _DetailRow({
required this.icon,
required this.title,
required this.value,
});
final IconData icon;
final String title;
final String value;
@override
Widget build(BuildContext context) {
return Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Icon(icon, color: AppColors.heartRed, size: 22),
const SizedBox(width: 10),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
title,
style: const TextStyle(
color: AppColors.mutedInk,
fontWeight: FontWeight.w700,
fontSize: 12,
),
),
const SizedBox(height: 2),
Text(value),
],
),
),
],
);
}
}
class _SponsoredLabel extends StatelessWidget {
const _SponsoredLabel();
@override
Widget build(BuildContext context) {
return Container(
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 5),
decoration: BoxDecoration(
color: AppColors.softPink,
borderRadius: BorderRadius.circular(999),
),
child: Text(
AppLocalizations.of(context).t('sponsoredLabel'),
style: TextStyle(
color: AppColors.heartRed,
fontWeight: FontWeight.w800,
fontSize: 11,
),
),
);
}
}

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%