Urmi

Phase-one CPaaS console skeleton with independently deployable frontend, API, and data infrastructure.

Modules

frontend/ — Vite, React, TypeScript console
backend/ — FastAPI control-plane API
database/ — PostgreSQL bootstrap schema and seed data
docker-compose.yml — local modular development stack

Run locally

docker compose up --build

Console: http://localhost:5173
API docs: http://localhost:8000/docs
API health: http://localhost:8000/health

Environment configuration

Urmi uses separate env templates for each layer:

Template	Copy to	When
`.env.example`	`.env`	Docker Compose (backend auth + Google OAuth)
`backend/.env.example`	`backend/.env`	Running FastAPI on the host
`frontend/.env.example`	`frontend/.env`	Running Vite on the host

Full variable reference, flows, and troubleshooting: docs/ENVIRONMENT.md

Quick start for Compose:

cp .env.example .env
docker compose up --build

Email/password auth works without Google vars. Set AUTH_SECRET before any non-local deploy.

Authentication

Google sign-in requires GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and this redirect URI in Google Cloud Console:

http://localhost:8000/api/v1/auth/google/callback

The canonical user_accounts table is separate from password_credentials and oidc_identities. A verified Google identity is linked to an existing user by normalized email, preventing duplicate accounts. Google-first users can add a password from Console → profile → Sign-in & security.

Core development starts PostgreSQL, Redis, the backend, and frontend. Optional phase-one infrastructure is isolated behind Compose profiles:

docker compose --profile data-plane --profile analytics --profile object-storage up --build

This additionally starts Kafka, ClickHouse, and MinIO (a local S3-compatible store).

Architectural boundary

The frontend never accesses a database directly. The FastAPI service owns transactional PostgreSQL access. Kafka, ClickHouse, and object storage are available as separate infrastructure modules for data-plane events, analytics, and files as those features are implemented.

2.2 KiB Raw Permalink Blame History