emealia documentation

The end-to-end reference: business model, actors, an actor/use-case map, every product flow with a diagram and its endpoints, the full AI communication pipeline, cross-cutting compliance, endpoint + data-model reference, and a feature status matrix.

Vision, non-negotiables, markets, pricing, KPIs, kill conditions, business model, open founder actions.

Where emealia sits after the 2026 consolidation (MFP+Cal AI, Apple Health+, the MFP paywall class action, EU AI Act Art. 50), a 21-row feature matrix against the full field, an assessment of the new additions — band contributions, multi-meal logging, weight, mood and activity tracking — plus a 20-rule evidence-backed tip library that needs no AI, and the remaining differentiation openings.

Stack, 21 shipped boundaries, BCE, async contract, AWS topology (Beta: Lambda Function URL + SQS worker + private RDS + NAT instance ~$30-35/mo · Prod: ECS + ALB when traffic justifies fixed cost), real cost breakdown, version pins, open gaps.

The dependency rule, naming conventions per layer, the full boundary↔integration↔feature map (21 boundaries, 13 use cases), and a clearly-marked roadmap section for what's planned vs. shipped.

Every table (15), column, and constraint read directly from models.py/Alembic — the canonical 32-nutrient column convention, the credit-based trial model, and where the older ER diagram has drifted from what's shipped.

Every FastAPI route, the async meal-logging contract (202 + poll + save), the Google-only auth/session sequence, and the Stripe billing flow — verified against the routers, not the design intent.

Tokens, band system, typography, voice & tone, screen inventory, Figma references.

Canonical developer map: where code/config/data/schema live, how backend and frontend flows are wired, mock status, local run notes, diagrams, guardrails.

Step-by-step: accounts & API keys → local dev → AWS bootstrap → Terraform apply → Lambda + CloudFront deploy → verify. Beta infra ~$30-35/mo. Frontend on CloudFront/S3 for app, All-Inkl for public web.