Service Map
This page documents all deployable services in the SMACKZ platform, their relationships, and communication patterns.
Service Inventory
| Service | Repo | Runtime | Deployment |
|---|---|---|---|
| Yum Backend API | yum |
Node.js / Fastify | Control Plane |
| Smackz-Admin | Smackz-Admin |
React SPA | Cloudflare Pages |
| Smackz-Websites | Smackz-Websites |
React SPA | Cloudflare Pages |
| SMACKZ-MOBILE | SMACKZ-MOBILE |
React Native | App Store / Google Play |
| Page Renderer | page-renderer |
React (npm package) | Bundled into Websites |
| POS Adapters | Smackz-POS-Adapters |
Node.js / Fastify | Control Plane |
| MCP Server | Smackz-MCP |
Python / FastMCP | Control Plane |
| MCP Gateway | Smackz-MCP-Gateway |
Node.js | Control Plane |
| KDS-Web | KDS-Web |
React SPA | Control Plane |
| Lakehouse Writer | smackz-lakehouse |
Python / FastAPI | Control Plane (1 replica) |
| Lakehouse Query API | smackz-lakehouse |
Python / FastAPI + DuckDB | Control Plane (1-5 replicas) |
| Metabase | smackz-lakehouse |
Java (Metabase OSS) | Control Plane |
| Yum-Ensemble-Apps | Yum-Ensemble-Apps |
EnsembleUI (YAML/Flutter) | EnsembleUI platform |
| Shared Core | shared-core |
npm package | GitHub Packages |
| Shared UI | shared-ui |
npm package | GitHub Packages |
Service Communication
+------------------+ HTTPS +------------------+
| Smackz-Admin | -----------------> | |
+------------------+ | |
| Yum Backend |
+------------------+ HTTPS | API |
| Smackz-Websites | -----------------> | (Fastify) |
+------------------+ | |
| |
+------------------+ HTTPS | |
| SMACKZ-MOBILE | -----------------> | |
+------------------+ +--------+---------+
|
+------------------+------------------+
| | |
v v v
PostgreSQL Redis Cloudflare R2
|
Redis Streams
|
v
Lakehouse Writer
|
Parquet / R2
|
v
Query API + Metabase
+------------------+ HTTPS +------------------+
| MCP Gateway | -----------------> | MCP Server |
+------------------+ | (Python) |
+------------------+
|
HTTPS to Yum API
+------------------+ HTTPS +------------------+
| POS Adapters | <----------------> | Clover API |
| (Clover) | -----------------> | (external) |
+------------------+ +------------------+
|
v
Yum Backend API
Service Groups
Customer-Facing
- Smackz-Websites -- Restaurant websites rendered with dynamic pages and sections
- SMACKZ-MOBILE -- Native mobile app for ordering (React Native)
- Page Renderer -- Shared React package that renders dynamic page sections
Restaurant Operations
- Smackz-Admin -- Dashboard for restaurant owners to manage menus, orders, pages, and settings
- KDS-Web -- Kitchen display system showing incoming orders in real time
- POS Adapters -- Bridges between SMACKZ orders and POS systems (currently Clover)
Platform Infrastructure
- Yum Backend API -- Central REST API; all clients depend on it
- Shared Core / UI -- Shared npm packages consumed by all frontend apps
- MCP Server + Gateway -- AI/LLM integration layer using Model Context Protocol
Analytics
- Lakehouse Writer -- Consumes events from Redis Streams, writes Parquet to R2
- Lakehouse Query API -- FastAPI + DuckDB for analytics endpoints
- Metabase -- Self-service dashboards and SQL exploration
Key Files
CLAUDE.md-- Project structure table with repos and tech stacksdocs/CI-CD-Workflows.md-- How shared packages are published and consumed