High-Level Architecture

Document Purpose: This document provides a high-level technical overview of the Cazo system components, technology stack, and data flow. It serves as a roadmap for engineering and deployment.

Overview

Cazo is built on a modern microservices architecture designed for scalability and multi-tenancy. It utilizes a centralized API gateway to manage traffic between client applications and specialized backend services.

System Diagram

(Placeholder for Mermaid Diagram)

[Client Apps] <-> [API Gateway] <-> [Microservices] <-> [Database]

Key Components System Matrix

Layer	Component	Technology	Responsibility
Frontend	Owner Dashboard	Next.js (React)	Admin interface for reporting and configuration.
	Booking Widget	Vanilla JS / React	Embeddable script for client websites.
	Mobile App	React Native (Expo)	Staff-facing app for schedule and checkout.
Backend	API Gateway	Kong / Nginx	Routing, Rate Limiting, and Authentication.
	Core Services	Python FastAPI	Business logic (Bookings, Customers, Inventory).
	AI Engine	LangChain + OpenAI	NLP processing for Chatbot and Nudges.
Data	Primary DB	PostgreSQL	Relational data with tenant isolation.
	Cache	Redis	Session storage and high-speed caching.
	Vector DB	Pincone / pgvector	Semantic search for RAG and Recommendations.