presentation mode · current system + roadmap

AAC Analytics — a living architecture

child speaks → data explains → adults understand
currentfuture deployment
A child uses an AAC communication board. Events flow through a Next.js backend into PostgreSQL, a deterministic analytics pipeline creates explainable findings, and a scoped dashboard chatbot uses the shared MCP tool seam with cloud or future locally deployed models. EXPERIENCES APP SERVER + DATA GROUNDED AI events valid only scoped insights the question read-only outbound accounts · settings components/kid/board-app.tsx · lib/kid/log.ts (IndexedDB queue) · lib/kid/speech.ts KID APP / the communication board 🍎 💧 🚻 ➕ 🙂 ❌ 🎨 🔤 🍎 ➕ 🔊 📦 IndexedDB queue · offline-safe 🧒 👆 tap 🗣 speak 🧭 nav 🔤 spell app/dashboard/* · lib/metrics.ts · lib/baseline.ts · components/insight-card.tsx · components/chat/* DASHBOARD /dashboard teacher · SLT · parent I4 I1 I8 baseline: 14d+40u 💬 Ask about Mia… ➤ 🧑‍🏫 app/api/* · lib/ingest.ts (grid-coord gate) · lib/access.ts (role + consent scoping) NEXT.JS SERVER one app · two surfaces /api/events → ingest ✅✋ /api/chat → ask agent /api/mcp → HTTP door 🛡 role + consent are filtered in the query layer — never in a component db/schema.sql · db/views_metrics.sql · db/views_insights.sql · lib/db.ts (4-statement WRITABLE whitelist) · tools/rollup.py · tools/run_rules.py · tools/verify.py DATA CORE aac_app.db accounts · passcodes · overrides aac.db analytics · PostgreSQL · WAL ✍ app writes: 4 statements only ⚙️ PIPELINE rollup → SQL rules → fired_rules verify: 42 ✓ lib/chat/ — agent · guard (forbidden actions) · tool bridge · settings 🤖 ASK AGENT runs inside the server 🛡 guard: no move / resize advice 🔧 tool bridge → MCP tools answers must cite real numbers lib/chat/vertex · openai · anthropic · gemini — switch at /dashboard/settings MODEL PROVIDERS choose at /dashboard/settings ☁️ Vertex Gemini 3 ⭐ ☁️ OpenAI ☁️ Anthropic ☁️ AI-Studio Gemini 🔑 keys stay server-side only mcp/ — server (JSON-RPC/stdio) · tools.ts (14 tools) · db.ts (query_only + deny-ATTACH) · app/api/mcp 🔌 MCP SERVER one read-only tool surface · 14 tools doors: bridge · stdio · HTTP 🔒 query_only + deny-ATTACH 🚫 utterance text unreadable insights must cite a fired_rule_id Future: Gemma 3 4B on a separate device — outbound MCP client (docs/mcp-clients.md) 💻 GEMMA 3 4B local model · its own device connects outbound as an MCP client — reads metrics, writes rule-backed insights FUTURE