Skip to main content

System architecture

In one sentence​

AimoAssist is the product (app, knowledge, keys, and its Valio-facing door). Inside it, the gateway signs prices, re-checks rules, and records the audit. The kitchen never talks to Valio’s raw systems except through that door.

Four parts​

PartWhat it does
WebsiteWhat people see and sign
AimoAssistTurns an ask into a cart; holds kitchen knowledge
Gateway (internal)Signs prices, re-checks rules, records the audit
Valio APILive price and availability

Website → AimoAssist only. AimoAssist → Valio only via AimoGuard.

Kitchen sideowned by the kitchen: its agent, its knowledge base, its keysValio Aimo sideowned by Valio Aimo: the interface, offers, order book, audittrust boundary · OpenAPI + MCPHuman clientkitchen personGemini + decision modelgoogle-genai · text and typed answersCatalogcatalog.db · FTS5 · 17,546 productsClient appNext.jsEnginethe kitchen's agentAimoGuard gatewayagent interfaceValio Aimo APImock · price, availabilityApprover keysclient server routesKnowledge baseone SQLite file per kitchenOrder book + auditgateway.db · hash chainStatic data filescatalog, reliability, carbonorder confirmedmemory update
12/12Learn. The kitchen's decisions update product memory and quantity factors, with one-tap undo. Diet rules, budgets and the policy never change on their own.

Request path​

More: Principles · Tech stack · Order flow