Vadym/obsidian
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
obsidian/wiki/architecture/_index.md
Vadym Samoilenko d7af8d73a7 vault backup: 2026-04-29 21:58:01
2026-04-29 21:58:01 +01:00

3.2 KiB
Raw Blame History

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

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
wiki/architecture/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 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 Step-by-step Oliver project setup — repo, Docker Compose, Azure AD, cost tracker, optical-dev deploy All new projects
wiki/architecture/troubleshooting-playbooks Failure → diagnosis → fix for FastAPI, Docker, React/Vite, Azure AD, Apache, PostgreSQL All Oliver projects
wiki/architecture/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 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
  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