---
auto_generated: true
created: 2026-05-19
manual_updated_at: 2026-05-19
modified: 2026-05-19
name: User_Manual
status: active
tags:
- domain/ai
- tech/azure-ad
- tech/fastapi
- tech/postgresql
- tech/rag
- type/sop
type: sop
---

# Mod Comms User Manual

## What This Tool Does

Mod Comms is an AI-powered proof review tool designed for Barclays marketing materials. It utilizes a multi-agent AI system to analyze uploaded marketing assets for:

*   **Legal Compliance:** Ensures adherence to advertising standards and detects financial promotions.
*   **Brand Adherence:** Checks logo usage, color palettes, and visual identity.
*   **Tone of Voice:** Analyzes clarity and voice consistency.
*   **Channel Suitability:** Verifies platform-specific specifications.

The tool provides a **RAG status** (Red, Amber, Green) for each agent, with detailed feedback, synthesized by a Lead Agent into a final verdict. It also offers real-time feedback via WebSocket streaming, campaign management, and PDF export capabilities.

## Who Uses It

*   **Marketing Teams:** For submitting marketing assets for compliance and brand checks.
*   **Legal & Brand Teams:** For reviewing flagged issues and resolutions.
*   **WIP Reviewers:** For getting early-stage creative feedback on work-in-progress assets.

## How to Access

1.  **Log In:** Access the application via the provided web interface. Authentication is handled via Azure AD. For development, auth can be disabled by setting `DISABLE_AUTH=true`.
2.  **Navigate:** Use the dashboard to view analytics, campaign lists, and audit trails.
3.  **Upload:** Select a campaign or create a new one to upload proof assets (PDFs, images, etc.).

## Main Workflows

### Workflow 1: Submitting a Proof for Analysis

1.  **Navigate to Campaigns:** Go to the "Campaigns" section or create a new campaign.
2.  **Upload Asset:** Click "Add Proof" and upload your marketing asset.
3.  **Initiate Analysis:** The system will automatically start the multi-agent analysis in parallel.
4.  **Monitor Progress:** Watch the real-time WebSocket stream for live updates from the Legal, Brand, Tone, and Channel agents.
5.  **Review Verdict:** Once complete, review the synthesized final verdict and detailed feedback from each agent.
6.  **Export Report:** Click "Export PDF" to generate a professional report of the analysis results.

### Workflow 2: Managing Campaigns and Versions

1.  **Create Campaign:** From the dashboard, click "New Campaign" to organize proofs.
2.  **Upload Versions:** Upload multiple versions of proofs to the same campaign for version history tracking.
3.  **Compare Results:** Use the campaign view to compare analysis results across different versions.

### Workflow 3: Reviewing WIP Assets

1.  **Select WIP:** Identify a work-in-progress asset.
2.  **Request Early Feedback:** Use the WIP Reviewer feature to get preliminary feedback before final submission.

## FAQ

**Q: What file types are supported?**
A: The tool primarily supports PDFs for detailed analysis, but other asset types may be supported depending on the specific agent capabilities.

**Q: How long does the analysis take?**
A: Analysis time varies based on asset complexity and content, but real-time WebSocket updates provide progress indicators.

**Q: Can I override the AI's verdict?**
A: Yes, users can flag items and add resolution notes, contributing to the audit trail. However, the AI provides the initial RAG status and feedback.

**Q: Is my data secure?**
A: Yes, the system integrates with Azure AD for authentication and stores data in a secure PostgreSQL database. File storage is isolated.

**Q: How do I get support?**
A: Contact support at BAICsupport@oliver.agency if you encounter issues.

## Related
- [[01 Projects/modcomms/DEVELOPER_MANUAL.md]]
- [[01 Projects/Barclays-banner-builder/USER_MANUAL.md]]