How goprocker/sathyabamaexpress works
The code describes a household-intelligence application, branded LIVORA in API comments, with a web experience, API, deterministic household-domain logic, agent workflows and integrations. The README contains only the title “Sathyabama Express,” so it does not document product capabilities; the feature routes and API excerpts provide the main capability evidence. The principal workflow is a user entering through the web router, whose pages can use query hooks and the API; the API routes work to domain and agent services backed by shared state. Some feature-to-API wiring is not shown, so those links are omitted.
Main entry points: app.ts HTTP API · index.ts Agent workflows · meal-engine.ts Meal engine · service.ts Life service
Components 25
Web experience
- Web application
apps/web/src/main.tsx - Page router
apps/web/src/router.tsx - Household pages
apps/web/src/features - Mobility
apps/web/src/features/mobility/MobilityPage.tsx - Life features
apps/web/src/features - Query hooks
apps/web/src/hooks/queries.ts - Web API client
apps/web/src/lib/api.ts
API surface
- HTTP API
apps/api/src/app.ts - Life routes
apps/api/src/life-routes.ts
Household logic
- Application state
packages/db/src/index.ts - Inventory engine
packages/domain/src/inventory-engine.ts - Meal engine
packages/domain/src/meal-engine.ts - Ripple engine
packages/domain/src/ripple-engine.ts - Unit normalization
packages/domain/src/unit-normalizer.ts - Forecast engine
packages/domain/src/forecast-engine.ts - Life service
packages/life/src/service.ts - Life intelligence
packages/life/src/engine.ts - Life data
packages/life/src/data.ts
Agent workflows
- Agent workflows
packages/agents/src/index.ts - Voice agent
packages/agents/src/voice-agent.ts
External integrations
- OpenAI adapter
packages/integrations/src/openai-adapter.ts - Sarvam adapter
packages/integrations/src/sarvam-adapter.ts - Snapserve adapter
packages/integrations/src/snapserve-adapter.ts
Other components
- Household user
- Retail vendors
Connections 34
- Household user → Web application: uses
- Web application → Page router: renders routes
apps/web/src/main.tsx - Page router → Household pages: routes to
apps/web/src/router.tsx - Page router → Mobility: routes to
apps/web/src/router.tsx - Household pages → Query hooks: loads data
- Query hooks → Web API client: calls
apps/web/src/hooks/queries.ts - Household user → HTTP API: requests
- HTTP API → Life routes: registers routes
apps/api/src/app.ts - Life routes → Life service: calls
apps/api/src/life-routes.ts - HTTP API → Application state: uses
apps/api/src/app.ts - HTTP API → Agent workflows: runs workflows
apps/api/src/app.ts - HTTP API → Inventory engine: uses
apps/api/src/app.ts - HTTP API → Meal engine: uses
apps/api/src/app.ts - HTTP API → Forecast engine: uses
apps/api/src/app.ts - HTTP API → Ripple engine: uses
apps/api/src/app.ts - HTTP API → Snapserve adapter: checks integration
apps/api/src/app.ts - Life service → Life intelligence: uses
packages/life/src/service.ts - Life service → Life data: loads
packages/life/src/service.ts - Life intelligence → Life data: uses
packages/life/src/engine.ts - Inventory engine → Application state: updates state
packages/domain/src/inventory-engine.ts - Meal engine → Application state: updates state
packages/domain/src/meal-engine.ts - Meal engine → Unit normalization: formats quantities
packages/domain/src/meal-engine.ts - Inventory engine → Unit normalization: normalizes units
packages/domain/src/inventory-engine.ts - Ripple engine → Meal engine: simulates meals
packages/domain/src/ripple-engine.ts - Ripple engine → Unit normalization: formats quantities
packages/domain/src/ripple-engine.ts - Agent workflows → Application state: records workflow
packages/agents/src/index.ts - Agent workflows → OpenAI adapter: parses with
packages/agents/src/index.ts - Agent workflows → Sarvam adapter: transcribes with
packages/agents/src/index.ts - Agent workflows → Snapserve adapter: resolves vendor
packages/agents/src/index.ts - Agent workflows → Meal engine: simulates meals
packages/agents/src/index.ts - Voice agent → Agent workflows: calls workflows
packages/agents/src/voice-agent.ts - Voice agent → OpenAI adapter: parses intent
packages/agents/src/voice-agent.ts - Agent workflows → Retail vendors: proposes calls
- Life features → Life service: uses life package