Architecture

Repo-Aufteilung, Deployment und Datenbanken von AI.

Repos

Repo	Rolle
addxion-ai	App auf addxion.ai — TanStack Start, UUI → shadcn + Neon
addxion-com	Marketing + CMS (keine Plattform-Docs)
addxion-docs	Plattform-Dokumentation (SSOT, addxion.com/docs)
addxion-neon	`@addxion/neon` Design System Meta-Package

Deployment

AI läuft auf Cloudflare Workers (wrangler deploy).

Binding / Secret	Zweck
`AUTH_DB` (D1)	Auth und User (`addxion-auth`)
`AUTH_SECRET`	Better Auth Session-Signing
`DATABASE_URL`	Neon — geplant für App-Tabellen via Hyperdrive
`OPENROUTER_API_KEY`	LLM-Provider für Chat

OAuth-Callbacks: https://addxion.ai/api/auth/callback/google bzw. /github

Packages

Package	Ort	Status
`@addxion/auth`	`addxion-ai/packages/auth`	Live (`app_registry` + `app_grant`)
`@addxion/ai`	`addxion-ai/packages/ai`	Live
`@addxion/shell`	`addxion-ai/packages/shell`	Live (addxion.ai konsumiert)
`@addxion/behavior`	`addxion-ai/packages/behavior`	Live (`useFollowStream` in Chat)
`@addxion/xi`	`addxion-ai/packages/xi`	Live (`protocol`, `nav`; `runtime` Stub)
`@addxion/neon`	`addxion-neon`	Live (Dep + shadcn-Bridge Pilot)

Package-Leitfaden: Ökosystem Package-Leitfaden.

Privacy by Design

Personenbezogene Daten (Auth, Chat, Profile) folgen den übergreifenden Privacy-by-Design-Regeln: Datenminimierung, serverseitige Secrets, bewusste LLM-Datenflüsse.

Neon

Neue UI in addxion.ai nutzt Neon (NeonButton, NeonDialog Pilot erledigt). UUI bleibt auf bestehenden Screens bis Touch-Migration.

Lokal entwickeln

# addxion-ai
bun install
cp .env.example .env   # AUTH_SECRET, DATABASE_URL
bun run db:auth:migrate:dev
bun run dev

Docs SSOT

Technische Plattform-Docs liegen in addxion-docs und werden unter addxion.com/docs ausgeliefert. Produkt-Masterplan: addxion-ai/docs/MASTERPLAN.md.

Truths

ID	Wahrheit
T-PKG-AI	LLM-SSOT in @addxion/ai
T-PKG-AUTH	Identity-SSOT in @addxion/auth
T-PKG-SHELL	Shell = UI-Schicht, nicht bash/zsh

Für Agents

Scope: Architektur der addxion.ai App und Package-Grenzen.

@addxion/ai: Stream-Chunks und Message-Typen
Keine Shell- oder Nav-Logik im AI-Package
Auth über @addxion/auth, UI über @addxion/shell