docs: update system architecture for production deployment 2025-12-13

- Add live production URLs (Vercel + HF Spaces)
- Document cloud infrastructure (Redis, Neo4j, Neon PG)
- List recent deployment fixes (Dockerfile, widgets, package-lock)
- Update AI/LLM provider documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

ARCHITECTURE.md

@@ -1,7 +1,7 @@
 # WidgeTDC - Enterprise AI Platform Architecture
 
-**Last Updated:** 2025-11-26  
-**Status:** ✅ Production Ready - CSS Build Fixed
+**Last Updated:** 2025-12-13
+**Status:** ✅ PRODUCTION LIVE - Cloud Deployment Active
 
 ## System Overview
 
@@ -14,20 +14,67 @@ WidgeTDC is an Enterprise-grade Autonomous Intelligence Platform featuring:
 
 ---
 
-## Recent Updates (2025-11-26)
+## 🚀 Production Deployment (2025-12-13)
 
-### ✅ Frontend Build System Fixed
-- **CSS Architecture Rebuilt**: Complete rewrite of `App.css` with proper structure
-- **Keyframes Fixed**: All `@keyframes` animations now use correct syntax (0%, 50%, 100%)
-- **Tailwind v4 Migration**: All `@apply` directives converted to standard CSS
-- **Build Success**: Frontend builds without errors (`npm run build`)
-- **No Blocking Issues**: All critical CSS syntax errors resolved
+### Live URLs
+| Service | Platform | URL |
+|---------|----------|-----|
+| **Frontend** | Vercel Edge | `https://matrix-frontend-claus-krafts-projects.vercel.app` |
+| **Backend API** | HuggingFace Spaces | `https://kraft102-widgettdc-api.hf.space` |
 
-### ✅ PowerShell Scripts Standardized
-- **Created**: `update_agent.ps1`, `update_agent_github.ps1`, `update_agent_readme.ps1`
-- **Approved Verbs**: Using `Get-NormalizedPath` instead of `Normalize-Path`
-- **No Unused Variables**: Removed `GlobalHooksDir` and other unused assignments
-- **PSScriptAnalyzer Compliant**: All scripts pass linting
+### Cloud Infrastructure
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                     PRODUCTION ARCHITECTURE                              │
+│                      "Headless Ghost" Pattern                           │
+└─────────────────────────────────────────────────────────────────────────┘
+
+   Browser ──▶ Vercel CDN ──▶ HuggingFace Spaces ──▶ Cloud Databases
+                  │                   │                    │
+            React 19 PWA        Node.js 20           ┌────┴────┐
+            185 Widgets         63 MCP Tools         │ Redis   │
+            Zustand State       Express API          │ Neo4j   │
+                                                     │ Neon PG │
+                                                     └─────────┘
+```
+
+### Database Layer
+| Database | Provider | Purpose |
+|----------|----------|---------|
+| **Redis** | Redis Cloud (EU-North-1) | Cache, Sessions, Event Bus |
+| **Neo4j** | AuraDB Cloud | Knowledge Graph (4274 nodes, 5252 rels) |
+| **PostgreSQL** | Neon Serverless | Vector Store (pgvector), Prisma ORM |
+| **SQLite** | sql.js (in-memory) | Fallback for HF Spaces free tier |
+
+### AI/LLM Providers
+| Provider | Use Case |
+|----------|----------|
+| Google Gemini Pro | Primary reasoning |
+| OpenAI GPT-4 | Fallback, embeddings |
+| Anthropic Claude | Analysis tasks |
+| DeepSeek V3 | Code generation |
+
+---
+
+## Recent Updates (2025-12-13)
+
+### ✅ HuggingFace Spaces Deployment Fixed
+- **Dockerfile Optimized**: Skip Puppeteer Chromium download
+- **Memory Limits**: Reduced to 512MB for free tier compatibility
+- **package-lock.json**: Regenerated correct monorepo lockfile
+- **Data Directories**: `/app/data/*` created with proper permissions
+- **Environment Variables**: `HF_SPACE=true`, `DOCKER=true` set
+
+### ✅ Frontend Widgets Fixed
+- **Icon Imports**: Added missing `Target`, `Video` imports
+- **DataSources**: Added `threatIntel` to SourceLink.tsx
+- **useEffect Fix**: Removed undefined `width/height` from dependency array
+- **185 Widgets**: All rendering correctly
+
+### ✅ Previous Updates (2025-11-26)
+- CSS Architecture rebuilt for Tailwind v4
+- PowerShell scripts standardized (PSScriptAnalyzer compliant)
+- Build system fully functional
 
 ---