---
title: "Architecture Patterns Index"
description: "Cross-cutting architectural decisions across Oliver Agency projects"
tags: [index, architecture]
created: 2026-04-15
updated: 2026-04-29
---

# Architecture Patterns

Cross-cutting architectural decisions that appear in multiple Oliver projects.

## Patterns

| Pattern | Description | Projects |
|---------|-------------|---------|
| [[wiki/architecture/docker-compose-fullstack\|docker-compose-fullstack]] | Standard multi-service Docker Compose deployment | ~20 projects |
| [[wiki/architecture/multi-agent-ai-systems\|multi-agent-ai-systems]] | Parallel specialist agents + lead synthesizer | Mod Comms, Semblance, Enterprise Nexus |
| [[wiki/architecture/gcp-deployment-lb-timeout\|gcp-deployment-lb-timeout]] | GCP 30s LB timeout — WebSocket → HTTP polling fix | Mod Comms, Semblance |
| [[wiki/architecture/rag-architecture\|rag-architecture]] | RAG: Firecrawl → AI structuring → Qdrant → LLM synthesis | Enterprise Nexus, Sandbox NotebookLM |
| [[wiki/architecture/hotfolder-daemon\|hotfolder-daemon]] | Box folder monitoring daemon with systemd | Ford QC, Ford SFTP |
| [[wiki/architecture/optical-dev-server-deploy\|optical-dev-server-deploy]] | optical-dev Apache subpath pattern: single vhost, Include conf, port table, deploy script | All Oliver projects |
| [[wiki/architecture/ai-cost-tracker\|ai-cost-tracker]] | Shared AI cost tracker: Docker Compose, Workspace→Team→Project, preflight/record HTTP API, LiteLLM pricing, hard budget limits | All Oliver projects |
| [[wiki/architecture/new-project-checklist\|new-project-checklist]] | Step-by-step Oliver project setup — repo, Docker Compose, Azure AD, cost tracker, optical-dev deploy | All new projects |
| [[wiki/architecture/troubleshooting-playbooks\|troubleshooting-playbooks]] | Failure → diagnosis → fix for FastAPI, Docker, React/Vite, Azure AD, Apache, PostgreSQL | All Oliver projects |
| [[wiki/architecture/adr-log\|adr-log]] | Architecture Decision Records — why HTTP polling, Docker Compose, FastAPI, Azure AD, cost tracker were chosen | All Oliver projects |
| [[wiki/architecture/cloud-run-jobs-celery\|cloud-run-jobs-celery]] | Moving heavy Celery tasks (ffmpeg, TTS, Whisper) to Cloud Run Jobs — finite execution, pay-per-use, env-specific compose, chain dispatch pattern | Video Accessibility |

## Key Architectural Decisions

1. **Docker Compose** — default deployment for all multi-service projects on optical-dev
2. **HTTP polling over WebSocket** — mandatory on GCP (30s LB timeout) — see [[wiki/architecture/adr-log|ADR-001]]
3. **AI pre-structuring before RAG indexing** — improves retrieval quality
4. **Hotfolder + archive pattern** — prevents reprocessing in Box automations
5. **DEV_AUTH_BYPASS / dev login** — skip Azure AD in local/dev environment, real auth in production
6. **Cost tracking as cross-cutting concern** — every AI call preflight+record via ai-cost-tracker

## Quick Links

- Starting a new project? → [[wiki/architecture/new-project-checklist|new-project-checklist]]
- Something broken? → [[wiki/architecture/troubleshooting-playbooks|troubleshooting-playbooks]]
- Why was X chosen? → [[wiki/architecture/adr-log|adr-log]]
