3.9 KiB
3.9 KiB
| title | description | tags | created | updated | ||
|---|---|---|---|---|---|---|
| Tech Patterns Index | Recurring technology stacks across Oliver Agency projects |
|
2026-04-15 | 2026-04-27 |
Tech Patterns
Recurring technology stacks used across Oliver Agency projects. Each article covers a specific pattern with projects, gotchas, and code examples.
Patterns
| Pattern | Description | Projects |
|---|---|---|
| wiki/tech-patterns/fastapi-python-docker | FastAPI + Python + Docker — dominant backend stack | GMAL, Mod Comms, Video Accessibility, OliVAS, PIMCO, Solventum, Enterprise Nexus |
| wiki/tech-patterns/react-vite-typescript | React + Vite + TypeScript — standard Oliver SPA frontend | GMAL, Mod Comms, Semblance, Video Accessibility, LUSA, Build-A-Squad, BAIC |
| wiki/tech-patterns/nextjs-fastapi-fullstack | Next.js + FastAPI — for complex multi-service AI platforms | Enterprise Nexus, Sandbox NotebookLM, Oliver AI Bot 2.0, DeckForge |
| wiki/tech-patterns/azure-ad-msal-auth | Azure AD / MSAL SSO — Oliver internal auth standard | GMAL, Enterprise Nexus, Cinema Studio Pro, Mod Comms, BAIC, Sandbox |
| wiki/tech-patterns/python-ai-agents | Claude / Gemini / OpenAI / LlamaIndex integration patterns | GMAL, Mod Comms, Semblance, OliVAS, PIMCO, Video Accessibility, Enterprise Nexus |
| wiki/tech-patterns/redis-celery-worker-queue | Redis + Celery for async long-running tasks | Enterprise Nexus, Video Accessibility, PDF Accessibility |
| wiki/tech-patterns/box-api-integration | Box API for client asset workflows | Ford QC, Ford SFTP, L'Oréal, Ferrero |
| wiki/tech-patterns/one2edit-api | One2Edit translation platform API | 3M Portal, H&M O2E Tool |
| wiki/tech-patterns/nodejs-vanilla-proxy | Node.js + Vanilla JS lightweight proxy tools | 3M Portal, Ferrero, Homepage |
| wiki/tech-patterns/kling-veo-video-api | Kling AI + Google Veo 3.1 video generation — camera control, I2V, polling | Cinema Studio Pro |
| wiki/tech-patterns/cost-tracker-integration | Connect any project to ai-cost-tracker: API key → httpx client → preflight/record pattern → budgets. Live at optical-dev.oliver.solutions/cost-tracker/ |
All Oliver projects |
| wiki/tech-patterns/cost-tracker-pricing-sources | Three-layer pricing: LiteLLM auto-sync > YAML (non-LLM) > admin override; historical effective_from/to |
ai-cost-tracker |
| wiki/tech-patterns/cost-tracker-providers | Billing units per provider: Gemini usage_metadata tokens, ElevenLabs/GCP TTS len(text) chars |
All AI projects |
Quick Decision Guide
New project → what stack?
├── Complex AI platform, multi-user → nextjs-fastapi-fullstack
├── Standard tool with UI → fastapi-python-docker + react-vite-typescript
├── Simple client portal / proxy → nodejs-vanilla-proxy
├── Static page, no backend → plain HTML/JS
└── Needs auth? → azure-ad-msal-auth
└── Has AI calls? → always add cost-tracker-integration
Cost Tracker Quick Reference
Every new Oliver project that makes AI API calls should integrate the cost tracker.
Admin UI: https://optical-dev.oliver.solutions/cost-tracker/
Minimum integration (3 env vars + 2 HTTP calls):
COST_TRACKER_BASE_URL=https://optical-dev.oliver.solutions/cost-tracker/v1
COST_TRACKER_API_KEY=ct_live_xxx
COST_TRACKER_SOURCE_APP=my-project
# Before AI call
r = await ct.post("/preflight", json={...})
if not r.json()["allow"]: raise BudgetExceeded()
# After AI call
await ct.post("/usage/record", json={...})
See wiki/tech-patterns/cost-tracker-integration for the full 9-step guide.