City Gateway: Innovative, Social, and Learning

1. Functional Specification

The platform is designed as an agentic digital gateway focused on the objective: "Sukurti pažangią, gamifikuotą mobiliąją programėlę, kuri taptų pagrindiniu įrankiu įtraukiant socialinės atskirties grupes į aktyvų Rietavo gyvenimą".

Core Functional Modules

• Module 1: Dynamic Edge Profiling (Privacy-First): Utilising Edge AI (e.g., Gemini Nano via Google AI Edge), the app must perform on-device user profiling. Sensitive markers such as disability status or NEET markers remain strictly encrypted in a local sandboxed SQLite database, satisfying GDPR/BDAR Article 25 by ensuring zero network egress of raw personal data.

• Module 2: Gamification Engine & WTA Ledger: A credits system pegged to the WorkTravel Academy (WTA) Point Matrix. Users earn "Academy Credits" for civic engagement, which can be translated into global career tiers (e.g., Explorer → Builder) via a multiplier based on partner tier and user efficiency.

• Module 3: Organisation "Atvirumo" (Openness) Ranking: A dynamic leaderboard for local service providers. Reputation scores are calculated using a weighted formula considering transparency (MCP resources exposed), verified participation volume, and synchronisation latency.

• Module 4: Agentic AI Concierge ("Rietaviškis"): An LLM-driven assistant that queries local event databases via the Model Context Protocol (MCP). It provides 24/7 Lithuanian-language support, filtering opportunities against the user’s encrypted on-device constraints to provide hyper-personalised recommendations.

• Module 5: Proof-of-Participation (PoP) Verification: An offline-first cryptographic pipeline for event check-ins. It uses Ed25519 asymmetric verification of time-sensitive QR codes to guarantee a verification velocity of < 30 seconds even without immediate internet connectivity.

Communication Protocols

• Agent-to-Agent (A2A) v1.2: Facilitates secure, cross-boundary negotiation handshakes between the user agent and organization agents via URL-addressable JSON "Agent Cards".

• Backend for Frontend (BFF): A mandatory architectural layer that centralizes business logic (credits, eligibility) to ensure a single source of truth across all client devices and accelerates Time to Market.

2. UX/UI Design Strategy

The design must adhere to Universal Design principles to ensure a 100% pass rate for seniors and individuals with disabilities.

Accessibility & Visual Design Requirements

• Platform: Mandatory use of Flutter (Dart) to leverage its Skia/Impeller rendering engine for pixel-perfect UI control and deep integration with native accessibility APIs.

• Interaction Model: A voice-to-text semantic interface driven by local Edge AI to assist those with low digital literacy.

• Visual Constraints:

  • Touch-Target Sizing: Minimum of 48×48 logical pixels for all interactive elements to accommodate mobility impairments.

  • Text Scaling: Guaranteed layout stability even when system text scaling is set to 200%.

  • Dynamic Contrast: Strict adherence to WCAG 2.1 AA (4.5:1 ratio for normal text; 3:1 for large text).

• Semantic Integration: Use of Flutter’s Semantics and MergeSemantics widgets to prevent screen-reader focus loops.

Offline Visibility & Feedback (UX Patterns)

• Status Indicators: A header-based Online/Offline indicator that provides reassurance when data is being edited locally without adding clutter.

• Low-Latency Views: All data views must load from the local database (Local-First), ensuring the app remains responsive regardless of Wi-Fi stability.

• Reactive Listeners: Points and rewards must be reflected on the UI in milliseconds following a check-in, even if the backend sync is still queued.

• Gamification Visuals: Use of badges, levels, and progress charts to create momentum and a felt sense of evolving within the "Learning City".

3. Key Milestones for Delivery

• Weeks 1–6: Foundation, Universal Design setup, and Core Ledger architecture.

• Weeks 7–10: Engineering of secure physical QR scanning and speed optimisation.

• Weeks 11–16: Deployment of "Rietaviškis" AI, "Atvirumo" Ranking dashboard, and final accessibility audits.