1.8 KiB
1.8 KiB
| title | description | tags | created | updated | ||
|---|---|---|---|---|---|---|
| Architecture Patterns Index | Cross-cutting architectural decisions across Oliver Agency projects |
|
2026-04-15 | 2026-04-15 |
Architecture Patterns
Cross-cutting architectural decisions that appear in multiple Oliver projects.
Patterns
| Pattern | Description | Projects |
|---|---|---|
| wiki/architecture/docker-compose-fullstack | Standard multi-service Docker Compose deployment | ~20 projects |
| wiki/architecture/multi-agent-ai-systems | Parallel specialist agents + lead synthesizer | Mod Comms, Semblance, Enterprise Nexus |
| wiki/architecture/gcp-deployment-lb-timeout | GCP 30s LB timeout — WebSocket → HTTP polling fix | Mod Comms, Semblance |
| wiki/architecture/rag-architecture | RAG: Firecrawl → AI structuring → Qdrant → LLM synthesis | Enterprise Nexus, Sandbox NotebookLM |
| wiki/architecture/hotfolder-daemon | Box folder monitoring daemon with systemd | Ford QC, Ford SFTP |
Key Architectural Decisions
- Docker Compose — default deployment for all multi-service projects
- HTTP polling over WebSocket — mandatory on GCP (30s LB timeout)
- AI pre-structuring before RAG indexing — improves retrieval quality
- Hotfolder + archive pattern — prevents reprocessing in Box automations
- DEV_AUTH_BYPASS — skip Azure AD in local dev, always use real auth in production
| wiki/architecture/optical-dev-server-deploy | optical-dev GCP server: single-vhost Apache, Include pattern, port table, deploy script cache | Barclays Banner Builder, all Oliver projects |