Initial MobilityOps build pack (docs, contracts, scaffold)

2026-08-01 20:34:43 +02:00
commit 24188d9b10
71 changed files with 3412 additions and 0 deletions
@@ -0,0 +1,51 @@
+# MobilityOps
+
+**Connected operations for vehicle rental and service teams.**
+
+MobilityOps is a working proof of concept for a fictitious mobility company. It combines vehicle and booking operations, a controlled vehicle-return workflow, data-quality review, RAGcore-backed internal knowledge, n8n orchestration and read-only tools published through ITWorx MCP Hub.
+
+All people, companies, vehicles, bookings and documents are synthetic. The workflows, validation, integrations, audit logging and access boundaries are intended to be real.
+
+## Scope
+
+The PoC implements:
+
+- operations dashboard;
+- vehicle and booking views;
+- one complete vehicle-return workflow;
+- five deterministic data-quality checks;
+- human review and customer merge;
+- audit trail;
+- RAGcore-backed knowledge assistant with citations;
+- one n8n return-processing workflow;
+- four read-only MCP tools through ITWorx MCP Hub;
+- deterministic demo reset and five-minute showcase.
+
+It is not an ERP, CRM, accounting package, public booking site, payment system or autonomous agent.
+
+## Repository map
+
+- `CLAUDE.md` — binding implementation rules.
+- `MASTER_BUILD_PROMPT.md` — prompt to start an autonomous Claude run.
+- `PROJECT_STATE.md` — short persistent project memory.
+- `docs/` — product, architecture, UX and acceptance specification.
+- `contracts/` — OpenAPI, event and MCP contracts.
+- `knowledge/` — fictitious source documents for the MobilityOps RAGcore workspace.
+- `seed/` — deterministic synthetic dataset and generator.
+- `n8n/` — importable workflow definitions.
+- `backend/` and `frontend/` — minimal bootable scaffold, not the finished application.
+
+## Local scaffold
+
+```bash
+cp .env.example .env
+docker compose up --build
+```
+
+Expected scaffold endpoints:
+
+- Web: `http://localhost:1228`
+- API health: `http://localhost:8128/health`
+- n8n: `http://localhost:5678`
+
+The finished project must keep these defaults configurable.