NuklearRabbit
108b5d04fc
Automated migrations on container startup (backend/entrypoint.sh), scripted n8n workflow activation (make n8n-setup), Playwright E2E test covering the full 9-step demo script (verified passing against the live stack, including the previously-unverified 360px responsive layout), evidence screenshots of all main pages, architecture diagram, and artifacts/evidence/final-summary.md with commit/commands/test counts/RAGcore and n8n evidence/MCP sample calls/known limitations/portfolio wording. Verified the complete clean-checkout path from a genuinely wiped-volumes state: automatic migrations, seed, 66 backend tests passing, and a live S1 return round-tripped through a freshly-activated n8n instance. Added .gitattributes to force LF line endings on shell scripts, preventing a real cross-platform breakage of entrypoint.sh's shebang.
58 lines
2.3 KiB
Markdown
58 lines
2.3 KiB
Markdown
# 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/` — FastAPI/SQLAlchemy/Alembic API.
|
|
- `frontend/` — React/TypeScript/Vite web app, including the Playwright end-to-end suite (`frontend/e2e/`).
|
|
- `artifacts/evidence/` — final acceptance evidence (screenshots, architecture, `final-summary.md`).
|
|
|
|
## Quickstart
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
make demo
|
|
```
|
|
|
|
This builds and starts the full stack (migrations run automatically) and loads the
|
|
deterministic demo dataset. See `docs/17-runbook.md` for the one-time n8n workflow setup
|
|
required for the automation demo, and the full operational runbook.
|
|
|
|
Endpoints:
|
|
|
|
- Web: `http://localhost:1228`
|
|
- API health: `http://localhost:8128/health`
|
|
- n8n: `http://localhost:5678`
|
|
|
|
All defaults are configurable via `.env` (see `.env.example`).
|