Skip to content
 
 

Latest commit

 

History

305 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Oreilly' Architectural Katas Q4 2025: AI-Enabled Architecture

This repository documents the end-to-end architecture thinking process for the given kata scenario prepared by Five Nines Team. This solution is the winner of the Kata Q4 2025: AI-Enabled Architecture

Final presentation recording is available under this link.

289752_Katas_Place_Badge_First (1)


Table of Contents


About the Project

This project is intended to help MobilityCorp achieve its business goals and address its biggest business challenges by offering the most optimal technology stack and architectural solution. The company's goals are:

  • increase sales and revenue,
  • expand market coverage,
  • improve user experience and satisfaction,
  • strengthen its market position.

Team

The project was prepared by the team called 'Five Nines' consisting of:

9 Oleh Yermilov

9 . Oleksandra Tytar

9 Dmitry Zinkevich

9 Piotr Zyskowski

9 Bo Connolly

Repository Structure

  • adrs/ → Architecture Decision Records
  • requirements/ → Business & technical requirements
  • hld/ → High Level Design artefacts (diagrams, docs)

Problem Statement

Design from scratch (green field architecture) functionality for:

  • User Dialogue - enhanced sales via user-personalized companionship, adaptive route/experience/pricing/charging advise, and driving compliance guidance;
  • Dynamic Pricing - sales support with more competitive pricing, addresses expansion ambitions and retention goals;
  • Demand Forecasting - uses internal and external data (weather, traffic, events) to forecast demand;
  • Maintenance Optimization (cost reduction) via:
    • Operational efficiency (location/fleet/route supply optimisation, transportation/charge task assignment);
    • Load distribution (even rental/usage among vehicles);
    • Maintenance prediction (sensor data - e.g. battery);

while ensuring continuous and smooth system operation of the existing core rental functionality.


Solution Overview

Our goal is to design a micro-mobility platform for connected scooters, e-bikes, cars, and vans. The value proposition focuses on near-real-time telemetry, fleet state, pricing and demand intelligence, maintenance optimization, and conversational user assistance.

First, we integrated a Trip Copilot AI companion into the MobilityCorp mobile app to recommend routes based on user location and preferences, weather, destination, and riding style, enhancing customer experience and retention.

Second, we used the AI companion to gather customer feedback, which is analyzed to identify improvements and optimal parking bay locations, supporting our expansion strategy.

Next, we focused on vehicle quality and customer satisfaction by ingesting telemetry data into a custom ML model to predict battery replacement timing and prevent ride failures.

Then, we designed an ML-powered system to optimize pricing for customers based on multiple factors.

Lastly, we leveraged historical data and real-time route information to forecast demand and optimize fleet allocation to satisfy it.

Business Capabilities Mapping

Business Capability Related FRs Related ADR / HLD Document
Core User Features
User Registration and Login 1-1 Core Functionality
Vehicle Search and Booking 1-2 Core Functionality
Booking (short-term / long-term) 1-3 Core Functionality
Lock/Unlock Vehicles via Mobile App 1-4 Core Functionality
Real-Time GPS Tracking 1-5 Vehicle Connectivity HLD
ADR-0002 Vehicle telemetry & integration stack
Secure Payment 1-6 Core Functionality
Return Flow (designated parking, proof) 1-7 Core Functionality
Fees and Charges (penalties, late fees) 1-8 Core Functionality
Core Operations Features
Fleet Overview Dashboard 2-1 Core Functionality
ADR-0007 Fleet Service
Vehicle Details and History 2-2 Core Functionality
ADR-0007 Fleet Service
Operational Control (lock/unlock, stop) 2-3 Core Functionality
Vehicle Connectivity HLD
ADR-0002 Vehicle telemetry & integration stack
ADR-0007 Fleet Service
Task Management (battery swap, relocation) 2-4 Core Functionality
ADR-0007 Fleet Service
Fleet Monitoring (status, regulation data) 2-5 Core Functionality
Vehicle Connectivity HLD
ADR-0002 Vehicle telemetry & integration stack
Support and Communication (user ↔ ops) 2-6 Core Functionality
Advanced / AI-Enabled Capabilities
Vehicle Rental & Booking FR#1 ADR-0007 Fleet Service
Conversational Assistance (chatbot) FR#2A, FR#2E Trip Copilot
ADR-0012 Hybrid AI for User-personalized in-app companionship
ADR-0010 Agent Builder
ADR-0008 - Semantic Search on GCP
Adaptive Route & Ride Experience FR#2B, FR#2D Feedback Analysis
ADR-0005 AI-Based Route Optimization
ADR-0004 Gemini for Maps & Search
ADR-0021 — Simple ML model for charging advice to user
Personalized Pricing Advice FR#2C, FR#2F Dynamic Pricing Calculation
ADR-0003 Vertex AI as core AI/GenAI platform
ADR-0005 AI-Based Route Optimization
Dynamic Pricing Engine FR#2F Dynamic Pricing Calculation
ADR-0003 Vertex AI as core AI/GenAI platform
ADR-0005 AI-Based Route Optimization
ADR-0018 — Hybrid AI for Dynamic Pricing calculation
Demand Forecasting FR#2G Demand Forecasting
ADR-0003 Vertex AI as core AI/GenAI platform
ADR-0006 Knowledge Management
ADR-0022 Demand Forecasting Model Selection and Architecture
Fleet Supply & Task Optimization FR#2I Fleet Allocation
ADR-0007 Fleet Service
ADR-0005 AI-Based Route Optimization
Load Distribution Optimization FR#2J Fleet Allocation
ADR-0007 Fleet Service
ADR-0005 AI-Based Route Optimization
Predictive Maintenance & Cost Forecasting FR#2K Battery Replacement
ADR-0003 Vertex AI as core AI/GenAI platform
ADR-0007 Fleet Service
ADR-0019 - Hybrid AI for Maintenance Optimization: Supply Efficiency
ML Operations
AI Knowledge Data Management FR#3 ADR-0009 - GenAI Model Management on GCP
ADR-0010 - Evaluation and Adoption of Vertex AI Agent Builder for AI Service and Orchestration
ADR-0011 - Model Evaluation Flow using Vertex AI
ADR-0013 — Adoption of Managed SaaS Model Control Plane (MoCoP)
ADR-0014 — ML Model Selection for Cleanliness Assessment
MLOps FR#3 MLOps on Vertex AI & Gemini
ADR-0015 — Training Data Strategy and Bias Mitigation for Vision Models
ADR-0016 — Human-in-the-Loop Workflow Design for AI Decisions
Analytics Capabilities
Data And Analytics Architecture FR(Ap.A)2-1 Data and Analytics Technology Architecture

Tech Stack at a Glance

Edge and connectivity

  • Vehicles use MQTT over cellular
  • Clustered MQTT gateway on GKE behind external load balancer
  • Gateway authenticates devices, buffers if offline, and publishes telemetry to Pub/Sub topics by region and vehicle type

Streaming and integration

  • Pub/Sub as event backbone for telemetry and commands
  • Dataflow pipelines for parsing, validation, dedupe, geofencing enrichment, road snapping, and fan-out to storage and APIs

Data and Analytics

  • Ingestion: streaming, micro-batch, and bulk batch modes across transactional sources, vehicle telemetry, files, APIs, and reference data
  • Persistence: multi-layer lakehouse with raw, bronze, silver, gold, feature store, and curated semantic layer
  • Processing: Dataflow (stream/batch), Dataproc/Spark, BigQuery SQL, Vertex AI for feature engineering and ML pipelines; orchestrated with Airflow/Prefect/Dagster
  • Analytics Surfaces: governed semantic layer, BI dashboards in Looker, SQL/Notebook workspaces, ML experiment tracking, curated APIs
  • Reliability: multi-AZ baseline, optional multi-region with RPO 0–5 min (streaming) and RTO ≈15 min for critical services
  • Governance: schema contracts, lineage, RBAC/ABAC, PII tokenization, audit logs ≥400 days
  • FinOps & Ops: unit cost tracking, observability (lag, throughput, error rates), structured logging, OpenTelemetry tracing

AI and GenAI

  • Vertex AI for model lifecycle and evaluation
  • Gemini for map grounded conversational search and ops copilots
  • Matching Engine and BigQuery vector search for retrieval and RAG
  • Agent Builder for tool calling and orchestration of fleet, maps, and pricing tools
  • MLOps for automating full ML model lifecycle

Applications

  • Cloud Run microservices for booking, pricing, ops, maintenance
  • API Gateway for external and mobile access
  • Identity Platform for auth

Geospatial and UX

  • Maps Platform for routing, POI, geocoding, traffic, and ETA
  • Ops UI and mobile client consume APIs and AI assistants

VIDEO presentation

video link Click the link to watch the video.


References:

Note: Portions of this document were developed using AI-assisted tools under human supervision. All final content was proofread, reviewed, and approved by the authors who take full responsibility for it.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors