66 lines
3.9 KiB
Markdown
66 lines
3.9 KiB
Markdown
---
|
|
title: "Tech Patterns Index"
|
|
description: "Recurring technology stacks across Oliver Agency projects"
|
|
tags: [index, tech-patterns]
|
|
created: 2026-04-15
|
|
updated: 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]] | 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]] | React + Vite + TypeScript — standard Oliver SPA frontend | GMAL, Mod Comms, Semblance, Video Accessibility, LUSA, Build-A-Squad, BAIC |
|
|
| [[wiki/tech-patterns/nextjs-fastapi-fullstack\|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-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\|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-worker-queue]] | Redis + Celery for async long-running tasks | Enterprise Nexus, Video Accessibility, PDF Accessibility |
|
|
| [[wiki/tech-patterns/box-api-integration\|box-api-integration]] | Box API for client asset workflows | Ford QC, Ford SFTP, L'Oréal, Ferrero |
|
|
| [[wiki/tech-patterns/one2edit-api\|one2edit-api]] | One2Edit translation platform API | 3M Portal, H&M O2E Tool |
|
|
| [[wiki/tech-patterns/nodejs-vanilla-proxy\|nodejs-vanilla-proxy]] | Node.js + Vanilla JS lightweight proxy tools | 3M Portal, Ferrero, Homepage |
|
|
| [[wiki/tech-patterns/kling-veo-video-api\|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\|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\|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\|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):**
|
|
|
|
```env
|
|
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
|
|
```
|
|
|
|
```python
|
|
# 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|cost-tracker-integration]] for the full 9-step guide.
|