2ffe3783d2
Create a comprehensive 25-slide PowerPoint presentation showcasing all Mod Comms features, including multi-agent AI system, campaign management, real-time analysis, feedback reports, knowledge base, analytics, auditing, user roles, and technical architecture. Includes a Python generator script for reproducible builds and a companion features markdown document. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
244 lines
9.2 KiB
Markdown
244 lines
9.2 KiB
Markdown
# Mod Comms — Features Overview
|
|
|
|
## Product Overview
|
|
|
|
**Mod Comms** is an AI-powered proof review tool built for Barclays by OLIVER Agency. It automates the review of marketing materials (proofs) for legal compliance, brand adherence, tone of voice, and channel suitability — replacing slow, inconsistent manual review processes with fast, structured AI analysis.
|
|
|
|
### The Problem
|
|
|
|
Marketing teams at Barclays produce hundreds of proofs across social, display, email, and print channels. Each proof must be checked against:
|
|
|
|
- Legal and regulatory requirements (FCA, ASA/CAP)
|
|
- Barclays or Barclaycard brand guidelines
|
|
- Channel-specific best practices
|
|
- Platform technical specifications
|
|
|
|
Manual review is time-consuming, error-prone, and creates bottlenecks that delay campaign launches.
|
|
|
|
### The Solution
|
|
|
|
Mod Comms deploys four specialist AI agents that analyse every proof in parallel, delivering structured feedback in seconds rather than days. A Lead Agent synthesises the results into an overall pass/fail status with clear, actionable recommendations.
|
|
|
|
---
|
|
|
|
## Multi-Agent AI System
|
|
|
|
Mod Comms uses a multi-agent architecture powered by Google Gemini 2.5 Flash. Four specialist agents run in parallel, each with deep domain knowledge loaded from a managed Knowledge Base.
|
|
|
|
### Legal Agent
|
|
|
|
- Detects financial promotions (interest rates, APR, credit products)
|
|
- Checks advertising standards compliance (ASA/CAP code)
|
|
- Verifies required disclaimers are present and legible
|
|
- Assesses FCA regulatory compliance
|
|
- Reviews terms and conditions placement
|
|
- Checks third-party content permissions and disclosures
|
|
|
|
### Brand Agent
|
|
|
|
- Validates logo usage, minimum size, clear space, and placement
|
|
- Checks colour palette against approved masterbrand colours
|
|
- Verifies typography (Barclays Effra / Arial fallback, correct weights)
|
|
- Assesses adherence to design principles and sacred assets
|
|
- Dynamically loads Barclays or Barclaycard brand specifications based on campaign settings
|
|
|
|
### Channel Best Practices Agent
|
|
|
|
- Evaluates content strategy and messaging clarity for the target platform
|
|
- Checks creative best practices (visual hierarchy, layout, engagement patterns)
|
|
- Assesses platform optimisation (algorithm, safe zones, text-to-image ratios)
|
|
- Reviews mobile-first design (legibility, touch targets, thumb-zone navigation)
|
|
|
|
### Channel Tech Specs Agent
|
|
|
|
- Verifies dimensions, resolution, and aspect ratios against platform requirements
|
|
- Checks file format, size limits, and compression
|
|
- Validates typography specifications (minimum font sizes, character counts)
|
|
- Confirms digital grid system compliance (12-column desktop, 6-column mobile)
|
|
- Checks WCAG accessibility requirements (colour contrast, legibility)
|
|
|
|
### Lead Agent
|
|
|
|
The Lead Agent synthesises all specialist reviews into a final overall status and a professional summary. It does not analyse the proof directly — it interprets and consolidates the specialist results.
|
|
|
|
---
|
|
|
|
## RAG Status System
|
|
|
|
Every agent returns a RAG (Red / Amber / Green) status:
|
|
|
|
| Status | Meaning |
|
|
|--------|---------|
|
|
| **Green** | Fully compliant, no issues found |
|
|
| **Amber** | Minor issues that should be addressed |
|
|
| **Red** | Significant issues that must be resolved |
|
|
| **Error** | Agent could not analyse with confidence |
|
|
|
|
### Overall Status Decision Logic
|
|
|
|
The Lead Agent determines the overall proof status:
|
|
|
|
1. **Requires Manual Legal Review** — Financial promotion detected
|
|
2. **Analysis Error** — Any agent returned an Error status
|
|
3. **Failed** — Any agent returned Red
|
|
4. **Passed** — All agents returned Green or Amber
|
|
|
|
---
|
|
|
|
## Campaign Management
|
|
|
|
### Campaigns
|
|
|
|
- Campaign table with name, proof count, status, creator, owning agency, and last modified date
|
|
- Create campaigns with: name, brand guidelines (Barclays / Barclaycard), campaign ID, client lead
|
|
- Agency and agency lead are pre-filled from the user's profile
|
|
- Manual status toggle between "In Progress" and "Completed"
|
|
- Show/Hide Completed toggle and "My Campaigns Only" filter
|
|
- Sortable and filterable columns
|
|
|
|
### Proofs
|
|
|
|
- Upload proofs with: name, channel, sub-channel (dependent), proof type (dependent), file
|
|
- Supported channels: Social (Meta, YouTube — 12 formats), Display (Google, Barclays.co.uk — 10 formats), Copy (AD Copy)
|
|
- Version management with full version history
|
|
- Download, delete, and re-upload capabilities
|
|
- Real-time analysis progress with agent-by-agent status updates
|
|
|
|
---
|
|
|
|
## Real-Time Analysis
|
|
|
|
Mod Comms uses WebSocket connections for live analysis:
|
|
|
|
1. User uploads a proof (image or multi-page PDF)
|
|
2. File is sent via WebSocket with campaign metadata
|
|
3. Backend rasterises PDFs to PNG images (up to 10 pages)
|
|
4. All four agents analyse in parallel via `asyncio.gather()`
|
|
5. Real-time callbacks show each agent starting and completing
|
|
6. Lead Agent synthesises results into overall status and summary
|
|
7. Complete result returned to the frontend
|
|
|
|
### Revision-Aware Analysis
|
|
|
|
When uploading a new version, the system provides previous review context to each agent. Agents can then report:
|
|
|
|
- **Resolved Issues** — Previously flagged issues that have been fixed
|
|
- **Outstanding Issues** — Issues from the previous version that remain
|
|
- **New Issues** — Issues not present in the previous version
|
|
|
|
---
|
|
|
|
## Feedback Reports & PDF Export
|
|
|
|
### Asset Detail View
|
|
|
|
- Two-column layout: proof preview (left) and agent feedback (right)
|
|
- Each agent's feedback includes RAG status badge, detailed text feedback, and actionable issues
|
|
- Issues can be marked as resolved with a resolution note (visual strikethrough)
|
|
- Issues can be flagged as incorrect feedback for audit tracking
|
|
|
|
### PDF Export
|
|
|
|
- **Single Proof Export**: Cover page with branding, proof details, preview, Lead Agent summary, and all agent feedback with RAG status
|
|
- **Campaign Export**: Consolidated report for all proofs in a campaign
|
|
|
|
---
|
|
|
|
## Knowledge Base Management
|
|
|
|
Admins can manage the reference documentation that powers each agent:
|
|
|
|
1. **Upload Source Documents** — Upload PDF/markdown brand guidelines, legal specs, or channel documentation
|
|
2. **Document Parsing** — System converts uploaded documents to structured markdown
|
|
3. **Spec Generation** — AI processes parsed documents into a unified specification
|
|
4. **Version Control** — Each processing run creates a new spec version with diff comparison
|
|
5. **Activation** — Admins can activate any spec version, which agents then use for analysis
|
|
|
|
Five knowledge bases correspond to the five agent contexts:
|
|
- Legal
|
|
- Brand (Barclays)
|
|
- Brand (Barclaycard)
|
|
- Channel Best Practices
|
|
- Channel Tech Specs
|
|
|
|
---
|
|
|
|
## Analytics Dashboard
|
|
|
|
Admin-only dashboard with key performance indicators:
|
|
|
|
- **Proofs Uploaded** — Total count
|
|
- **Pass Rate** — Percentage of proofs that passed
|
|
- **Issues Found** — Total issues across all agents
|
|
- **Time Saved** — Estimated hours saved (based on versions created from AI feedback)
|
|
- **AI Performance Summary** — AI-generated weekly trends and insights
|
|
- **Agent Performance Table** — Per-agent pass rate and average issues per proof
|
|
|
|
---
|
|
|
|
## Auditing Dashboard
|
|
|
|
Admin-only audit trail with three tabs:
|
|
|
|
- **Flags** — User-reported incorrect agent feedback (proof, agent, user comments, timestamp)
|
|
- **Resolutions** — User-resolved issues (proof, agent, original issue, resolution note, timestamp)
|
|
- **Errors** — Analysis errors (proof, error summary, timestamp)
|
|
|
|
Each audit entry links back to the specific proof and version for investigation.
|
|
|
|
---
|
|
|
|
## User Roles & Access Control
|
|
|
|
| Role | Write Access | Analytics | Auditing | Knowledge Base | Settings | User Management | Agency Filter |
|
|
|------|-------------|-----------|----------|----------------|----------|-----------------|---------------|
|
|
| Super Admin | Yes | Yes | Yes | Yes | Full | Yes | Yes |
|
|
| Oversight Admin | No | Yes | Yes | No | Read-only | No | Yes |
|
|
| Agency Admin | Yes | Yes | No | No | Full | No | No |
|
|
| Basic User | Yes | No | No | No | No | No | No |
|
|
|
|
- Azure AD / O365 SSO authentication (MSAL)
|
|
- Users without an assigned agency see a message to contact their administrator
|
|
|
|
---
|
|
|
|
## Settings & Configuration
|
|
|
|
Admin-accessible settings for managing dropdown options used across the application:
|
|
|
|
- **Channels** — Add/remove marketing channels (Social, Display, Copy)
|
|
- **Sub-Channels** — Platform-specific sub-channels dependent on parent channel
|
|
- **Proof Types** — Format types dependent on sub-channel selection
|
|
- Changes propagate immediately to all user dropdowns
|
|
|
|
---
|
|
|
|
## Technical Architecture
|
|
|
|
### Frontend
|
|
- React + TypeScript + Vite
|
|
- Tailwind CSS with Barclays design system
|
|
- MSAL (Azure AD) authentication
|
|
- WebSocket client for real-time analysis
|
|
- REST API client for CRUD operations
|
|
- localStorage persistence with versioned keys
|
|
|
|
### Backend
|
|
- FastAPI (Python) with async support
|
|
- Google Gemini 2.5 Flash API for AI analysis
|
|
- SQLAlchemy async ORM + asyncpg
|
|
- Alembic database migrations
|
|
- WebSocket endpoint for real-time analysis
|
|
- PDF rasterisation service
|
|
|
|
### Database
|
|
- PostgreSQL
|
|
- Core tables: Agencies, Users, Campaigns, Proofs, ProofVersions
|
|
- Audit tables: FlaggedItems, ResolvedItems, ErrorItems
|
|
- Configuration: DropdownOptions
|
|
- Knowledge Base: KnowledgeBases, SourceDocuments, SpecVersions, ProcessingJobs
|
|
|
|
### Infrastructure
|
|
- Azure AD for authentication
|
|
- File storage with unique keys
|
|
- CORS-configured for frontend-backend communication
|