Vadym/obsidian
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
obsidian/01 Projects/modcomms/Mod Comms.md
Vadym Samoilenko 7251967b64 Initial vault commit: second brain for Oliver projects 
- 35 project notes (PARA structure, 1:1 disk mapping)
- CLAUDE.md session protocol
- Projects Index MOC
- Templates: Daily, Meeting, Project
- 03 Resources, 02 Areas structure
- .gitignore excludes credentials, workspace files, smart-env

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-14 18:44:21 +01:00

3.3 KiB
Raw Blame History

name client status tech local_path deploy url server tags created last_commit commits
Mod Comms Barclays active
Python
FastAPI
React
Vite
TypeScript
PostgreSQL
Gemini
Docker
/Volumes/SSD/Projects/Oliver/modcomms docker compose up --build GCP (Google Cloud Platform)
barclays
ai
compliance
proof-review
multi-agent
gcp
2026-04-14 2026-04-14 201

Overview

AI-powered proof review tool for Barclays marketing materials. Multi-agent system analyzes uploaded proofs (images/PDFs) for:

  • Legal compliance
  • Brand adherence
  • Tone of voice
  • Channel suitability

4 specialist AI agents run in parallel, lead agent synthesizes the final verdict. Real-time WebSocket streaming (switched to REST polling due to GCP LB 30s timeout).

Backup: modcomms_backup/

Tech Stack

  • Frontend: React 18 + Vite + TypeScript (port 3000)
  • Backend: Python + FastAPI + Uvicorn (port 8000)
  • Database: PostgreSQL 16 (Alembic migrations)
  • AI: Google Gemini Pro (primary) + Flash (fallback)
  • Auth: Azure AD (MSAL)
  • Infrastructure: Docker + docker-compose
  • Deployed on: GCP (Google Cloud Platform)

Architecture

Frontend (React/Vite :3000)
    ↓ REST polling (switched from WebSocket due to GCP 30s LB timeout)
Backend (FastAPI :8000)
    ↓
4 AI Agents (Gemini) → Lead Agent → Final Verdict
    ↓
PostgreSQL + File Storage

Deployment

  • Run: docker compose up --build
  • Local: Frontend :3000, Backend :8000
  • Server: GCP (Google Cloud Platform)
  • Local path: /Volumes/SSD/Projects/Oliver/modcomms

Environment Variables

Frontend (frontend/.env.local)

GEMINI_API_KEY=
VITE_BACKEND_WS_URL=ws://localhost:8000/ws/analyze
VITE_BACKEND_URL=http://localhost:8000

Backend (backend/.env)

GEMINI_API_KEY=
DATABASE_URL=postgresql+asyncpg://user:pass@localhost:5432/modcomms
AZURE_TENANT_ID=
AZURE_CLIENT_ID=
CORS_ORIGINS=http://localhost:3000
DISABLE_AUTH=true  # local dev only

Dev Commands

# Frontend
cd frontend && npm install && npm run dev

# Backend
cd backend && uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

# Database migrations
cd backend && alembic upgrade head

Timeline / Git History

Date Change
2026-04-14 Replace logo with v6 SVG across Sidebar and PDF Report
2026-03-19 Add CSV export of campaign data for super_admin and oversight_admin
2026-03-18 Critical: Switch WebSocket → REST polling (GCP LB 30s timeout fix)
2026-03-18 Switch AI model: Pro primary, Flash fallback
2026-03-18 Fix WebSocket keepalive + 25s→10s heartbeat
2026-03-16 Fix PDF logo URL with Vite base path in production
2026-03-16 Fix LlamaParse 401 + update logo to v5

Sessions

2026-04-14 – Project catalogued

Done: Added to Obsidian second brain with full details from CLAUDE.md and git history.

Change Log

Date Requested Changed Files
2026-04-14 Logo update Replace logo with v6 SVG Sidebar, PDF Report
2026-03-18 Fix dropped connections on GCP WebSocket → REST polling backend, frontend

Related