Canonical source: the canonical architecture document for this domain is
deep-dive/architecture.md, rendered in the docs center. This file is its operational companion (service topology, APIs, schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).
This document provides comprehensive architecture documentation for the Psyche (Serwaa) AI Virtual Assistant Platform, including system diagrams, service interactions, data flows, and ML pipelines.
Executive Summary#
Psyche is a sophisticated AI-powered platform for creating hyper-realistic digital human avatars capable of participating in video conferences indistinguishably from real humans. The architecture comprises:
- 19+ Python microservices handling specialized domains
- 60+ TypeScript libraries providing shared functionality
- Multi-protocol communication (REST, WebSocket, gRPC, Redis)
- Advanced ML pipelines for 3D rendering, voice synthesis, facial analysis
- Real-time processing targeting <500ms end-to-end latency
1. System Architecture Overview#
1.1 High-Level Architecture Diagram#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ EXTERNAL CLIENTS │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ Web App │ │ Mobile App │ │ REST API │ │ Video Conferencing │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ (Zoom/Teams/Meet) │ │
│ │ │ │ └──────────┬──────────┘ │
└─────────┼────────────────┼────────────────┼────────────────────┼────────────┘
│ │ │ │
▼ ▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ API GATEWAY (Port 8000) │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ Authentication │ Rate Limiting │ Request Routing │ Session Management │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────┬───────────────────────────────────────┘
│
┌───────────────────────────┼───────────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────────┐
│ ORCHESTRATOR │ │ PERSONA SERVICE │ │ KNOWLEDGE BASE │
│ (Port 8007) │ │ (Port 8009) │ │ (Port 8008) │
│ ┌───────────────┐ │ │ ┌───────────────┐ │ │ ┌─────────────────────┐│
│ │Session State │ │ │ │Identity Mgmt │ │ │ │Document Ingestion ││
│ │Pipeline Coord │ │ │ │Personality │ │ │ │Vector Embeddings ││
│ │Resource Alloc │ │ │ │Voice Config │ │ │ │Semantic Search ││
│ └───────────────┘ │ │ └───────────────┘ │ │ └─────────────────────┘│
└──────────┬──────────┘ └───────────────────┘ └───────────────────────────┘
│
│ Session Coordination
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ REAL-TIME PROCESSING LAYER │
│ │
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │
│ │ AVATAR ENGINE │ │ VOICE ENGINE │ │ BEHAVIOR ENGINE │ │
│ │ (Port 8001) │ │ (Port 8002) │ │ (Port 8003) │ │
│ │ [GPU: 8GB] │ │ [GPU: 6GB] │ │ [CPU only] │ │
│ │ │ │ │ │ │ │
│ │ 3D Gaussian │ │ TTS (XTTS v2) │ │ FACS Express. │ │
│ │ Splatting │ │ STT (Whisper) │ │ Micro-Express. │ │
│ │ FLAME Model │ │ Voice Cloning │ │ Gaze Control │ │
│ │ Lip Sync │ │ Lip Sync Gen │ │ Head Movement │ │
│ └────────┬────────┘ └────────┬────────┘ └────────┬────────┘ │
│ │ │ │ │
│ └────────────────────┼────────────────────┘ │
│ │ │
│ ┌─────────────────┐ ┌───────┴─────────┐ ┌─────────────────┐ │
│ │PERCEPTION ENGINE│ │ CONFERENCING │ │ COMPUTER USE │ │
│ │ (Port 8004) │ │ (Port 8006) │ │ (Port 8005) │ │
│ │ [GPU: 4GB] │ │ │ │ │ │
│ │ │ │ Zoom SDK │ │ Browser Auto │ │
│ │ Face Detection │ │ Teams SDK │ │ Screen Analysis│ │
│ │ Emotion Recog. │ │ Meet WebRTC │ │ Sandboxed Exec │ │
│ │ Gaze Tracking │ │ Webex SDK │ │ Tool Framework │ │
│ └─────────────────┘ └─────────────────┘ └─────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ DATA LAYER │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ PostgreSQL │ │ Redis │ │ Qdrant │ │ MinIO (S3) │ │
│ │ (pgvector) │ │ │ │ │ │ │ │
│ │ │ │ Session │ │ Knowledge │ │ ML Models │ │
│ │ Personas │ │ Cache │ │ Embeddings │ │ Avatars │ │
│ │ Sessions │ │ Pub/Sub │ │ Semantic │ │ Voice Files │ │
│ │ Knowledge │ │ Queues │ │ Search │ │ Documents │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
1.2 Service Port Allocation#
| Service | Port | Protocol | GPU Required |
|---|---|---|---|
| API Gateway | 8000 | REST/WebSocket | No |
| Avatar Engine | 8001 | REST/gRPC | Yes (8 GB) |
| Voice Engine | 8002 | REST/gRPC | Yes (6 GB) |
| Behavior Engine | 8003 | REST | No |
| Perception Engine | 8004 | REST/gRPC | Yes (4 GB) |
| Computer Use | 8005 | REST | No |
| Conferencing | 8006 | REST/WebSocket | No |
| Orchestrator | 8007 | REST | No |
| Knowledge Base | 8008 | REST | No |
| Persona Service | 8009 | REST | No |
| Learning System | 8010 | REST | Optional |
| Admin Dashboard | 3000 | HTTP | No |
| Mock External APIs | 4010 | REST | No |
2. Service Interactions#
2.1 Communication Protocol Matrix#
text
┌─────────┬─────────┬─────────┬─────────┬─────────┐
│ REST │WebSocket│ gRPC │ Pub/Sub │ Streams │
┌───────────────────┼─────────┼─────────┼─────────┼─────────┼─────────┤
│ Client → Gateway │ ● │ ● │ │ │ │
│ Gateway → Services│ ● │ │ ● │ │ │
│ Service ↔ Service │ ● │ │ ● │ ● │ ● │
│ Real-time Events │ │ ● │ │ ● │ ● │
│ Audio/Video Stream│ │ │ ● │ │ ● │
│ State Sync │ │ │ │ ● │ │
└───────────────────┴─────────┴─────────┴─────────┴─────────┴─────────┘
2.2 Session Lifecycle Flow#
text
┌──────────────────────────────────────────────────────────────────────────┐
│ SESSION LIFECYCLE │
└──────────────────────────────────────────────────────────────────────────┘
[Client] [API Gateway] [Orchestrator]
│ │ │
│ POST /sessions │ │
│ ──────────────────────────>│ │
│ │ Create session record │
│ │ ──────────────────────────>│
│ │ │
│ │ Allocate resources │
│ │<───────────────────────────│
│ session_id, status=PENDING│ │
│<───────────────────────────│ │
│ │ │
│ POST /sessions/{id}/join │ │
│ ──────────────────────────>│ │
│ │ │
│ │ [Conferencing] │
│ │ │ │
│ │ Connect to meeting │
│ │ ─────────>│ │
│ │ │ │
│ │ [Avatar Engine] │
│ │ │ │
│ │ Load 3DGS model │
│ │ ─────────>│ │
│ │ │ │
│ │ [Voice Engine] │
│ │ │ │
│ │ Warm up TTS │
│ │ ─────────>│ │
│ │ │
│ status=ACTIVE │ │
│<───────────────────────────│ │
│ │ │
▼ ▼ ▼
═══════════════════════════════════════════════════
ACTIVE SESSION PROCESSING
═══════════════════════════════════════════════════
2.3 Real-Time Processing Flow#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ ACTIVE SESSION: REAL-TIME LOOP │
│ (Target: <500ms end-to-end) │
└─────────────────────────────────────────────────────────────────────────────┘
[Video Conference] [AI Avatar]
│ ▲
│ User Video/Audio │
▼ │
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ CONFERENCING │─────>│ PERCEPTION │─────>│ ORCHESTRATOR │ │
│ Gateway │ │ Engine │ │ │ │
│ │ │ │ │ Analyze │ │
│ Capture │ │ Face Detect │ │ engagement │ │
│ video/audio │ │ Emotion │ │ Route to │ │
│ 30 FPS │ │ Head Pose │ │ dialogue │ │
└──────────────┘ └──────────────┘ └──────┬───────┘ │
│ │
▼ │
┌──────────────┐ │
│ VOICE │ │
│ Engine │ │
│ │ │
│ STT(Whisper)│ │
│ Claude LLM │ │
│ TTS(XTTS) │ │
│ Visemes │ │
└──────┬───────┘ │
│ │
┌────────────────────────────┼─────────────────┤
│ │ │
▼ ▼ │
┌──────────────┐ ┌──────────────┐ │
│ BEHAVIOR │ │ AVATAR │────────┘
│ Engine │────────────>│ Engine │
│ │ │ │
│ FACS │ Expressions│ 3DGS Render │
│ Gestures │ + Params │ FLAME Model │
│ Gaze │ │ Compositing │
│ Head Motion │ │ 1080p@30FPS │
└──────────────┘ └──────────────┘
TIMING BREAKDOWN
┌─────────────────────────────────────────────────────────────────────────────┐
│ Component │ Target Latency │ Description │
├────────────────────┼────────────────┼───────────────────────────────────────┤
│ Perception │ <20ms │ Face detection + emotion recognition │
│ Voice STT │ <100ms │ Speech-to-text transcription │
│ LLM Response │ <200ms │ Claude response generation │
│ Voice TTS │ <100ms │ Text-to-speech synthesis │
│ Behavior Compute │ <10ms │ FACS + gesture computation │
│ Avatar Render │ <33ms │ 3DGS rasterization (30 FPS) │
├────────────────────┼────────────────┼───────────────────────────────────────┤
│ TOTAL │ <500ms │ End-to-end user-perceived latency │
└─────────────────────────────────────────────────────────────────────────────┘
2.4 Inter-Service Communication Patterns#
REST API Pattern#
python
# Service-to-service HTTP communication
async def get_persona_config(persona_id: str) -> PersonaConfig:
async with httpx.AsyncClient() as client:
response = await client.get(
f"{PERSONA_SERVICE_URL}/api/v1/personas/{persona_id}"
)
response.raise_for_status()
return PersonaConfig(**response.json())
Redis Pub/Sub Pattern#
python
# Real-time event broadcasting
async def publish_avatar_state(session_id: str, state: AvatarState):
await redis.publish(
f"avatar:{session_id}:state",
state.model_dump_json()
)
# Subscriber (in another service)
async def subscribe_avatar_updates(session_id: str):
pubsub = redis.pubsub()
await pubsub.subscribe(f"avatar:{session_id}:state")
async for message in pubsub.listen():
if message["type"] == "message":
yield AvatarState.model_validate_json(message["data"])
gRPC Streaming Pattern#
protobuf
// Audio/video streaming between services
service AvatarService {
rpc StreamFrames(stream RenderRequest) returns (stream VideoFrame);
rpc StreamAudio(stream AudioChunk) returns (stream AudioChunk);
}
3. Data Flows#
3.1 Data Architecture Diagram#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ DATA ARCHITECTURE │
└─────────────────────────────────────────────────────────────────────────────┘
┌──────────────┐
│ Clients │
└──────┬───────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ APPLICATION LAYER │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐│
│ │ API Gateway │ │ Orchestrator│ │ Avatar │ │ Other Microservices ││
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ └────────────┬────────────┘│
└─────────┼───────────────┼───────────────┼────────────────────┼──────────────┘
│ │ │ │
▼ ▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ CACHING LAYER │
│ │
│ ┌────────────────────────────────┐ ┌────────────────────────────────────┐ │
│ │ L1: In-Memory Cache │ │ L2: Redis Distributed │ │
│ │ (Application-level, <1ms) │ │ (Cluster, <5ms) │ │
│ │ │ │ │ │
│ │ • Hot config data │ │ • Session state (TTL: 1hr) │ │
│ │ • Recent embeddings │ │ • Persona config (TTL: 30min) │ │
│ │ • Model weights (pinned) │ │ • Avatar state (TTL: 1min) │ │
│ └────────────────────────────────┘ │ • Voice state (TTL: 30sec) │ │
│ │ • Embedding cache (TTL: 1hr) │ │
│ └────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
│ │ │ │
▼ ▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ PERSISTENCE LAYER │
│ │
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────────────┐ │
│ │ PostgreSQL │ │ Qdrant │ │ MinIO (S3) │ │
│ │ (pgvector) │ │ Vector Store │ │ Object Storage │ │
│ │ │ │ │ │ │ │
│ │ SCHEMAS: │ │ COLLECTIONS: │ │ BUCKETS: │ │
│ │ • personas │ │ • documents │ │ • serwaa-models │ │
│ │ • sessions │ │ • voices │ │ • serwaa-avatars │ │
│ │ • knowledge │ │ • users │ │ • serwaa-voices │ │
│ │ • conversations│ │ • conversations│ │ • serwaa-knowledge │ │
│ │ • audit │ │ │ │ • serwaa-uploads │ │
│ │ • analytics │ │ │ │ │ │
│ └─────────────────┘ └─────────────────┘ └─────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
3.2 Database Schema Overview#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ POSTGRESQL DATABASE SCHEMAS │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
│ personas │ │ sessions │ │ knowledge │
├─────────────────────┤ ├─────────────────────┤ ├─────────────────────┤
│ id (UUID, PK) │ │ id (UUID, PK) │ │ id (UUID, PK) │
│ name │◄────│ persona_id (FK) │ │ title │
│ display_name │ │ meeting_url │ │ content │
│ personality (JSONB) │ │ platform │ │ source_type │
│ voice_config (JSONB)│ │ status │ │ metadata (JSONB) │
│ avatar_config(JSONB)│ │ started_at │ │ embedding (vector) │
│ expertise (TEXT[]) │ │ ended_at │ │ persona_id (FK) │
│ created_at │ │ metadata (JSONB) │ │ created_at │
│ updated_at │ │ created_at │ │ updated_at │
└─────────────────────┘ └──────────┬──────────┘ └─────────────────────┘
│
│
▼
┌─────────────────────┐
│ conversations │
├─────────────────────┤
│ id (UUID, PK) │
│ session_id (FK) │
│ messages (JSONB[]) │
│ summary │
│ created_at │
│ updated_at │
└─────────────────────┘
EXTENSIONS REQUIRED:
• uuid-ossp - UUID generation
• pgcrypto - Encryption functions
• vector - pgvector for embeddings
• pg_trgm - Text similarity
• btree_gin - GIN index support
3.3 Vector Store Collections#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ QDRANT VECTOR COLLECTIONS │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ Collection: serwaa_documents │
├─────────────────────────────────────────────────────────────────────────────┤
│ Vector Dimension: 1536 (OpenAI text-embedding-3-small) │
│ Distance Metric: Cosine │
│ │
│ Payload Fields: │
│ • document_id: string │
│ • chunk_index: integer │
│ • content: string │
│ • source: string (pdf, docx, web, etc.) │
│ • persona_id: string │
│ • tags: string[] │
│ • created_at: datetime │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ Collection: serwaa_conversations │
├─────────────────────────────────────────────────────────────────────────────┤
│ Vector Dimension: 1536 │
│ Distance Metric: Cosine │
│ │
│ Payload Fields: │
│ • session_id: string │
│ • message_index: integer │
│ • role: string (user, assistant) │
│ • content: string │
│ • timestamp: datetime │
└─────────────────────────────────────────────────────────────────────────────┘
3.4 Object Storage Structure#
text
s3://serwaa-models/
├── registry/
│ └── index.json # Model registry index
├── avatar/
│ └── 3dgs/
│ ├── v1.2.0/
│ │ ├── gaussians.pt # Gaussian parameters
│ │ ├── appearance.pt # Appearance model
│ │ └── metadata.json
│ └── v1.1.0/
├── flame/
│ ├── flame2023.pkl # FLAME 2023 model
│ ├── FLAME_masks.pkl
│ └── flame_static_embedding.pkl
└── perception/
├── retinaface/
│ └── v1.0.0/
└── fer-plus/
└── v1.1.0/
s3://serwaa-avatars/
├── personas/
│ └── {persona_id}/
│ ├── base_model.pt
│ ├── textures/
│ └── metadata.json
└── templates/
└── {template_id}/
s3://serwaa-voices/
├── tts_models/
│ ├── xtts-v2/
│ └── elevenlabs/
└── voice_samples/
└── {persona_id}/
├── sample_001.wav
└── speaker_embedding.pt
s3://serwaa-knowledge/
└── documents/
└── {persona_id}/
└── {document_id}/
├── original.pdf
├── chunks.json
└── embeddings.npy
4. ML Pipelines#
4.1 Avatar Generation Pipeline (3D Gaussian Splatting)#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ 3D GAUSSIAN SPLATTING PIPELINE │
│ (Target: <33ms per frame, 30+ FPS) │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────┐
│ INPUT: Identity Data │
│ (Reference images/video of face) │
└──────────────────┬──────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ 3DGS ENCODER │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ INPUT: Face images (512×512) │ │
│ │ │ │
│ │ OUTPUT (per Gaussian, N = 50,000-200,000): │ │
│ │ • Positions: N × 3 (3D center coordinates) │ │
│ │ • Rotations: N × 4 (Quaternions for orientation) │ │
│ │ • Scales: N × 3 (Anisotropic scaling factors) │ │
│ │ • Opacities: N × 1 (Alpha transparency) │ │
│ │ • SH Coefficients: N × 48 (Spherical harmonics, degree 0-3) │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────┬───────────────────────────────────────┘
│
┌─────────────────┴─────────────────┐
│ │
▼ ▼
┌───────────────────────────┐ ┌───────────────────────────┐
│ BEHAVIOR ENGINE │ │ VOICE ENGINE │
│ │ │ │
│ FACS Action Units: │ │ Viseme Generation: │
│ • AU1: Inner brow raise │ │ • aa (open mouth) │
│ • AU2: Outer brow raise │ │ • E (teeth visible) │
│ • AU4: Brow lowerer │ │ • I (smile) │
│ • AU6: Cheek raiser │ │ • O (round lips) │
│ • AU12: Lip corner pull │ │ • U (pursed lips) │
│ • ... (46 total AUs) │ │ • ... (15 total) │
│ │ │ │
│ + Head pose (pitch/yaw) │ │ + Timing data (ms) │
│ + Eye gaze (x, y) │ │ │
└─────────────┬─────────────┘ └─────────────┬─────────────┘
│ │
└───────────────┬───────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ FLAME DEFORMATION │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ FLAME Model Parameters: │ │
│ │ • Shape (β): 100 principal components │ │
│ │ • Expression (ψ): 50 expression blendshapes │ │
│ │ • Pose (θ): 15 joints (jaw, neck, eyes) │ │
│ │ │ │
│ │ OUTPUT: Deformed mesh vertices (5,023 vertices) │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────┬───────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ 3DGS RASTERIZER (CUDA) │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ 1. Transform Gaussians to camera space │ │
│ │ 2. Compute 2D covariance matrices │ │
│ │ 3. Sort by depth (front-to-back) │ │
│ │ 4. Tile-based rendering (16×16 tiles) │ │
│ │ 5. Alpha blending with learned opacities │ │
│ │ 6. Spherical harmonics evaluation for view-dependent color │ │
│ │ │ │
│ │ OUTPUT: 1080p RGB frame + depth buffer │ │
│ │ LATENCY: ~15-20ms (RTX 3080+) │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────┬───────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ POST-PROCESSING │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ • Temporal anti-aliasing (TAA) │ │
│ │ • Tone mapping (HDR → SDR) │ │
│ │ • Background compositing │ │
│ │ • Video encoding (H.264/H.265) │ │
│ │ │ │
│ │ OUTPUT: Video frame ready for conferencing │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
4.2 Voice Synthesis Pipeline#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ VOICE SYNTHESIS PIPELINE │
│ (Target: <100ms TTS latency) │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ SPEECH-TO-TEXT (STT) │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Whisper Large v3 │ │
│ │ │ │
│ │ Model: openai/whisper-large-v3 │ │
│ │ Size: 3 GB │ │
│ │ Languages: 99 │ │
│ │ WER: 4.2% │ │
│ │ Latency: ~50ms per utterance │ │
│ │ │ │
│ │ Input: Audio (48kHz, 16-bit PCM) │ │
│ │ Output: Transcribed text + word-level timestamps │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ Audio Chunk (1-5s) ──► Mel Spectrogram ──► Transformer ──► Text │
└─────────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ DIALOGUE MANAGER │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Components: │ │
│ │ • Intent detection (classify user intent) │ │
│ │ • Context retrieval (RAG from knowledge base) │ │
│ │ • Conversation state machine │ │
│ │ • Tool invocation (computer use, search, etc.) │ │
│ │ │ │
│ │ LLM: Claude claude-sonnet-4-20250514 (or configured model) │ │
│ │ Max tokens: 4096 │ │
│ │ Latency: ~200ms │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ [User Text] + [Context] + [Persona] ──► Claude ──► [Response Text] │
└─────────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ TEXT-TO-SPEECH (TTS) │
│ │
│ ┌───────────────────────────────────┐ ┌─────────────────────────────────┐ │
│ │ XTTS v2 (Local) │ │ ElevenLabs (Cloud API) │ │
│ │ │ │ │ │
│ │ Model: coqui/XTTS-v2 │ │ Voices: 95+ pre-made │ │
│ │ Size: 2 GB │ │ Voice cloning: Yes │ │
│ │ Languages: 19 │ │ Latency: <100ms │ │
│ │ RTF: 0.05 │ │ Quality: Premium │ │
│ │ Latency: ~80ms │ │ │ │
│ │ Voice cloning: Yes │ │ │ │
│ └───────────────────────────────────┘ └─────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ SYNTHESIS STAGES │ │
│ │ │ │
│ │ 1. Text Normalization │ │
│ │ "Dr. Smith's 3rd appointment at 2pm" → │ │
│ │ "Doctor Smith's third appointment at two p.m." │ │
│ │ │ │
│ │ 2. Phoneme Conversion (G2P) │ │
│ │ Text → IPA phonemes → Phoneme IDs │ │
│ │ │ │
│ │ 3. Duration Prediction │ │
│ │ Predict duration per phoneme (ms) │ │
│ │ │ │
│ │ 4. Acoustic Feature Generation │ │
│ │ Generate mel-spectrogram (80 mel bins) │ │
│ │ │ │
│ │ 5. Neural Vocoder │ │
│ │ Mel → Waveform (HiFi-GAN / BigVGAN) │ │
│ │ │ │
│ │ 6. Post-processing │ │
│ │ Resampling, normalization, prosody preservation │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ VISEME GENERATION │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Phoneme-to-Viseme Mapping: │ │
│ │ │ │
│ │ Phoneme │ Viseme │ Mouth Shape │ │
│ │ ────────────────────────────────────── │ │
│ │ /a/, /æ/ │ AA │ Jaw open, mouth wide │ │
│ │ /i/, /ɪ/ │ IY │ Lips spread, teeth close │ │
│ │ /o/, /ɔ/ │ OW │ Lips rounded, medium open │ │
│ │ /u/, /ʊ/ │ UW │ Lips pursed, small opening │ │
│ │ /m/, /b/ │ MBP │ Lips closed │ │
│ │ /f/, /v/ │ FV │ Bottom lip under top teeth │ │
│ │ /θ/, /ð/ │ TH │ Tongue between teeth │ │
│ │ /s/, /z/ │ SS │ Teeth together, lips slightly parted │ │
│ │ /ʃ/, /ʒ/ │ SH │ Lips protruded, teeth together │ │
│ │ │ │
│ │ Output: Timed sequence of visemes for lip sync │ │
│ │ [(0ms, "silence"), (50ms, "AA"), (120ms, "IY"), ...] │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ OUTPUT: Audio waveform (48kHz) + Viseme timeline → Avatar Engine │
└─────────────────────────────────────────────────────────────────────────────┘
4.3 Perception Pipeline#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ PERCEPTION PIPELINE │
│ (Target: <20ms per frame) │
└─────────────────────────────────────────────────────────────────────────────┘
Video Frame (1080p, 30 FPS)
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ FACE DETECTION (RetinaFace) │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Model: RetinaFace (ResNet-50 backbone) │ │
│ │ Size: 100 MB │ │
│ │ mAP: 0.91 (WIDER FACE) │ │
│ │ Latency: ~8ms │ │
│ │ │ │
│ │ Output per face: │ │
│ │ • Bounding box: [x1, y1, x2, y2] │ │
│ │ • Confidence: 0.0 - 1.0 │ │
│ │ • 5-point landmarks: [left_eye, right_eye, nose, left_mouth, │ │
│ │ right_mouth] │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────┬───────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ FACE ALIGNMENT (MediaPipe) │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Model: MediaPipe Face Mesh │ │
│ │ Size: 4 MB │ │
│ │ Landmarks: 468 points │ │
│ │ Latency: ~2ms │ │
│ │ │ │
│ │ Output: Dense facial landmarks for: │ │
│ │ • Face contour (17 points) │ │
│ │ • Eyebrows (10 points each) │ │
│ │ • Eyes (16 points each) │ │
│ │ • Nose (9 points) │ │
│ │ • Lips (40 points) │ │
│ │ • Full mesh (468 points) │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────┬───────────────────────────────────────┘
│
┌─────────────────────────────┼─────────────────────────────┐
│ │ │
▼ ▼ ▼
┌───────────────────┐ ┌───────────────────┐ ┌───────────────────────────┐
│ EMOTION RECOGN. │ │ HEAD POSE │ │ GAZE ESTIMATION │
│ (FER+) │ │ ESTIMATION │ │ │
│ │ │ │ │ Model: GazeNet │
│ Model: FER+ │ │ From landmarks │ │ Size: 40 MB │
│ Size: 50 MB │ │ or deep model │ │ Latency: ~3ms │
│ Latency: ~10ms │ │ Latency: ~5ms │ │ │
│ │ │ │ │ Output: │
│ Emotions: │ │ Output: │ │ • Gaze direction (x, y) │
│ • Neutral │ │ • Pitch (°) │ │ • Eye openness │
│ • Happiness │ │ • Yaw (°) │ │ • Pupil position │
│ • Surprise │ │ • Roll (°) │ │ │
│ • Sadness │ │ │ │ │
│ • Anger │ │ │ │ │
│ • Disgust │ │ │ │ │
│ • Fear │ │ │ │ │
│ • Contempt │ │ │ │ │
└─────────┬─────────┘ └─────────┬─────────┘ └─────────────┬─────────────┘
│ │ │
└───────────────────────┼───────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ ENGAGEMENT DETECTOR │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Combines signals to compute engagement score (0.0 - 1.0): │ │
│ │ │ │
│ │ Factors: │ │
│ │ • Eye contact duration (gaze toward camera) │ │
│ │ • Facial expressiveness (variance in expressions) │ │
│ │ • Head movement (active listening indicators) │ │
│ │ • Emotional valence (positive vs neutral vs negative) │ │
│ │ │ │
│ │ Output: │ │
│ │ { │ │
│ │ "engagement_score": 0.85, │ │
│ │ "attention_level": "high", │ │
│ │ "eye_contact_percentage": 0.72, │ │
│ │ "dominant_emotion": "interested" │ │
│ │ } │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
COMBINED OUTPUT → Orchestrator
┌─────────────────────────────────────────────────────────────────────────────┐
│ { │
│ "faces": [{ │
│ "bbox": [120, 80, 380, 420], │
│ "confidence": 0.97, │
│ "landmarks": [[...468 points...]], │
│ "emotion": "happiness", │
│ "emotion_confidence": 0.89, │
│ "head_pose": {"pitch": -5.2, "yaw": 12.1, "roll": 1.8}, │
│ "gaze": {"x": 0.15, "y": -0.08}, │
│ "eye_contact": true, │
│ "engagement_score": 0.91 │
│ }], │
│ "processing_time_ms": 18, │
│ "frame_id": 12847 │
│ } │
└─────────────────────────────────────────────────────────────────────────────┘
4.4 Model Registry & Versioning#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ MODEL REGISTRY ARCHITECTURE │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ PROMOTION WORKFLOW │
│ │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ │
│ │DEVELOPMENT │ ──────► │ STAGING │ ──────► │ PRODUCTION │ │
│ │ │ Validate│ │ Approve │ │ │
│ │ Unrestricted│ + Test │ 24hr min │ + Sign │ Immutable │ │
│ └────────────┘ └────────────┘ └────────────┘ │
│ │
│ Tests Required: │
│ Development: None │
│ Staging: Unit + Integration │
│ Production: Unit + Integration + Performance + Regression │
│ │
│ Approvers: ml-team, platform-team │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ MODEL INVENTORY │
├─────────────────────────────────────────────────────────────────────────────┤
│ Category │ Model │ Version │ Size │ GPU Mem │ Status │
├───────────┼───────────────┼─────────┼────────┼─────────┼───────────────────┤
│ Avatar │ FLAME 2023 │ 2023.1.0│ 500 MB │ 4 GB │ Production │
│ Avatar │ 3DGS Avatar │ 1.2.0 │ 1.5 GB │ 8 GB │ Production │
│ Voice │ Whisper Lg v3 │ 3.0.0 │ 3 GB │ 6 GB │ Production │
│ Voice │ XTTS v2 │ 2.0.3 │ 2 GB │ 4 GB │ Production │
│ Perception│ RetinaFace │ 1.0.0 │ 100 MB │ 2 GB │ Production │
│ Perception│ FER+ │ 1.1.0 │ 50 MB │ 2 GB │ Production │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ HOT-SWAP CONFIGURATION │
│ │
│ Strategy: Rolling Update │
│ Health Check Timeout: 60 seconds │
│ Retries: 3 │
│ Rollback on Failure: Enabled │
│ Previous Versions Kept: 3 │
│ │
│ Deployment Strategies Supported: │
│ • Rolling: Gradual replacement of instances │
│ • Blue-Green: Full parallel deployment, instant switch │
│ • Canary: Percentage-based traffic shifting │
└─────────────────────────────────────────────────────────────────────────────┘
5. Infrastructure Architecture#
5.1 Kubernetes Deployment Topology#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ KUBERNETES CLUSTER TOPOLOGY │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ NAMESPACE: serwaa │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ INGRESS (ALB/NGINX) │ │
│ │ api.serwaa.ai → API Gateway │ │
│ │ admin.serwaa.ai → Admin Dashboard │ │
│ └──────────────────────────────┬──────────────────────────────────────┘ │
│ │ │
│ ┌──────────────────────────────┼──────────────────────────────────────┐ │
│ │ CPU NODE POOL │ │
│ │ (c5.2xlarge × 3-10 nodes, auto-scaling) │ │
│ │ │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
│ │ │ api-gateway │ │ orchestrator │ │persona-service│ │ │
│ │ │ replicas: 3 │ │ replicas: 2 │ │ replicas: 2 │ │ │
│ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │
│ │ │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
│ │ │behavior-engine│ │ conferencing │ │ computer-use │ │ │
│ │ │ replicas: 2 │ │ replicas: 2 │ │ replicas: 2 │ │ │
│ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │
│ │ │ │
│ │ ┌──────────────┐ ┌──────────────┐ │ │
│ │ │knowledge-base│ │admin-dashboard│ │ │
│ │ │ replicas: 2 │ │ replicas: 2 │ │ │
│ │ └──────────────┘ └──────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ GPU NODE POOL (Karpenter) │ │
│ │ (g5.xlarge / p4d.24xlarge, on-demand scaling) │ │
│ │ │ │
│ │ ┌──────────────────────────────────────────────────────────────┐ │ │
│ │ │ avatar-engine │ │ │
│ │ │ replicas: 2-10 (HPA on GPU utilization) │ │ │
│ │ │ resources: 1 GPU (8GB VRAM), 4 CPU, 16GB RAM │ │ │
│ │ └──────────────────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ┌──────────────────────────────────────────────────────────────┐ │ │
│ │ │ voice-engine │ │ │
│ │ │ replicas: 2-8 (HPA on request rate) │ │ │
│ │ │ resources: 1 GPU (6GB VRAM), 4 CPU, 12GB RAM │ │ │
│ │ └──────────────────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ┌──────────────────────────────────────────────────────────────┐ │ │
│ │ │ perception-engine │ │ │
│ │ │ replicas: 2-6 (HPA on request rate) │ │ │
│ │ │ resources: 1 GPU (4GB VRAM), 2 CPU, 8GB RAM │ │ │
│ │ └──────────────────────────────────────────────────────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ MANAGED SERVICES │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ RDS Aurora │ │ ElastiCache │ │ S3 │ │ Qdrant │ │
│ │ PostgreSQL │ │ Redis │ │ Buckets │ │ Cloud │ │
│ │ │ │ │ │ │ │ │ │
│ │ db.r6g.xlarge│ │ cache.r6g.lg │ │ Multi-region │ │ Dedicated │ │
│ │ Multi-AZ │ │ Cluster mode │ │ replication │ │ cluster │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
5.2 Observability Stack#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ OBSERVABILITY ARCHITECTURE │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ METRICS │
│ │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ │
│ │ Services │──────│ Prometheus │──────│ Grafana │ │
│ │ /metrics │ pull │ Server │query │ Dashboards │ │
│ └────────────┘ └────────────┘ └────────────┘ │
│ │
│ Key Metrics: │
│ • model_inference_latency (histogram, by model/version/env) │
│ • model_request_count (counter, by model/status) │
│ • model_gpu_memory_usage (gauge, by model) │
│ • session_active_count (gauge) │
│ • api_request_duration_seconds (histogram) │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ TRACING │
│ │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ │
│ │ Services │──────│ Jaeger │──────│ Jaeger │ │
│ │ OTel SDK │ push │ Collector │store │ UI │ │
│ └────────────┘ └────────────┘ └────────────┘ │
│ │
│ Trace Context Propagation: │
│ • W3C Trace Context headers │
│ • Baggage for session_id, persona_id │
│ • Sampling: 10% production, 100% staging │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ LOGGING │
│ │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ │
│ │ Services │──────│Fluent Bit │──────│ ELK / │ │
│ │ stdout │ tail │ / Vector │ship │ CloudWatch │ │
│ └────────────┘ └────────────┘ └────────────┘ │
│ │
│ Log Format: Structured JSON │
│ Required Fields: timestamp, level, service, trace_id, message │
│ PII Scrubbing: Enabled (email, phone, IP addresses) │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ ALERTING │
│ │
│ Alert Rules: │
│ • high_inference_latency: model_inference_latency > 100ms (warning) │
│ • model_load_failure: load_time > 300s OR error (critical) │
│ • gpu_memory_exhausted: gpu_memory_usage > 90% (warning) │
│ • session_error_rate: error_rate > 5% (critical) │
│ • api_latency_high: p99 > 500ms (warning) │
│ │
│ Notification Channels: │
│ • Slack: #serwaa-alerts │
│ • PagerDuty: Critical alerts │
│ • Email: Daily digest │
└─────────────────────────────────────────────────────────────────────────────┘
6. Security Architecture#
6.1 Security Layers#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ SECURITY ARCHITECTURE │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ NETWORK SECURITY │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ WAF (Web Application Firewall) │ │
│ │ • Rate limiting (100 req/min per IP) │ │
│ │ • SQL injection prevention │ │
│ │ • XSS protection │ │
│ │ • Bot detection │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Network Policies (Kubernetes) │ │
│ │ • Default deny ingress │ │
│ │ • Explicit allow between services │ │
│ │ • Egress restrictions (allowlist external APIs) │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ TLS Everywhere │ │
│ │ • TLS 1.3 for external traffic │ │
│ │ • mTLS for service-to-service (via service mesh) │ │
│ │ • Certificate rotation: 90 days │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ AUTHENTICATION & AUTHORIZATION │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Authentication │ │
│ │ • JWT tokens (RS256 signed) │ │
│ │ • OAuth 2.0 / OIDC integration │ │
│ │ • API key authentication for service accounts │ │
│ │ • Token expiry: 1 hour (refresh: 7 days) │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Authorization │ │
│ │ • Role-Based Access Control (RBAC) │ │
│ │ • Roles: admin, operator, user, service │ │
│ │ • Resource-level permissions │ │
│ │ • Persona isolation (multi-tenant) │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ DATA SECURITY │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Encryption │ │
│ │ • At rest: AES-256 (database, S3) │ │
│ │ • In transit: TLS 1.3 │ │
│ │ • Application-level: Sensitive fields encrypted │ │
│ │ • Key management: AWS KMS / HashiCorp Vault │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Data Handling │ │
│ │ • PII scrubbed from logs │ │
│ │ • Audio/video not persisted (streaming only) │ │
│ │ • Conversation history: opt-in, encrypted │ │
│ │ • Data retention: 90 days (configurable) │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ COMPUTER USE SANDBOX │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Isolation │ │
│ │ • Each session runs in isolated container │ │
│ │ • Network namespace isolation │ │
│ │ • Read-only root filesystem │ │
│ │ • No privileged capabilities │ │
│ │ • Resource limits (CPU, memory, disk) │ │
│ │ • Session timeout: 30 minutes │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Action Validation │ │
│ │ • URL allowlisting │ │
│ │ • File access restrictions │ │
│ │ • Command execution audit log │ │
│ │ • Dangerous action confirmation │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
7. Performance Optimization#
7.1 Resource Requirements Summary#
| Component | CPU Cores | Memory (GB) | GPU VRAM (GB) | Storage |
|---|---|---|---|---|
| Avatar Engine | 4 | 16 | 8 | 10 GB |
| Voice Engine | 4 | 12 | 6 | 5 GB |
| Perception Engine | 2 | 8 | 4 | 2 GB |
| Behavior Engine | 2 | 4 | - | 1 GB |
| Orchestrator | 2 | 4 | - | 1 GB |
| API Gateway | 2 | 4 | - | 1 GB |
| Knowledge Base | 2 | 8 | - | 50 GB |
| Persona Service | 1 | 2 | - | 1 GB |
| Total/Session | 19+ | 58+ GB | 18 GB | 71 GB |
7.2 Optimization Strategies#
text
┌─────────────────────────────────────────────────────────────────────────────┐
│ OPTIMIZATION STRATEGIES │
└─────────────────────────────────────────────────────────────────────────────┘
GPU OPTIMIZATION:
• TensorRT model optimization (2-4x speedup)
• Mixed precision (FP16/BF16) inference
• CUDA kernel fusion
• Batch processing where possible
• Model quantization (INT8 for inference)
CACHING:
• L1: In-memory LRU cache (hot data, <1ms)
• L2: Redis distributed cache (warm data, <5ms)
• Embedding cache: Reduce redundant vector computations
• Model weight caching: Pin frequently used models
NETWORK:
• gRPC streaming for audio/video (lower overhead than HTTP)
• Connection pooling for service-to-service calls
• HTTP/2 multiplexing
• Regional edge caching (CDN for static assets)
COMPUTE:
• Horizontal auto-scaling (HPA on CPU/GPU utilization)
• Preemptible/Spot instances for non-critical workloads
• Resource quotas to prevent noisy neighbors
• Pod affinity for co-located services
8. Related Documentation#
- Service Inventory - Detailed service specifications
- Communication Architecture - Protocol details
- Data Models - Database schemas and data structures
- ML Model Dependencies - ML model catalog
- External Integrations - Third-party services
- Security Audit - Security assessment
- Performance Baseline - Performance metrics
Revision History#
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0.0 | 2026-01-31 | Claude Opus | Initial architecture docs |