# Ergo Marketing Agent Integration

This portal borrows the safest public patterns from `bez111/ergo-marketing-agent` without embedding the private operator dashboard, API keys, publishing controls or auto-posting surfaces.

## Source Repository

- Repository: `bez111/ergo-marketing-agent`
- Description: AI-powered CMO agent team for ergoblockchain.org with a Next.js dashboard and FastAPI/CrewAI backend.
- Relevant source surfaces reviewed:
  - `README.md`
  - `COMMUNITY_LAUNCH.md`
  - `apps/dashboard/src/app/ambassadors/page.tsx`
  - `apps/dashboard/src/app/ambassador/dashboard/page.tsx`
  - `apps/dashboard/src/app/community/page.tsx`
  - `apps/dashboard/src/app/campaigns/page.tsx`
  - `apps/dashboard/src/app/admin/ambassadors/page.tsx`
  - `apps/dashboard/src/app/queue/page.tsx`
  - `apps/dashboard/src/app/scout/page.tsx`
  - `apps/dashboard/src/app/calendar/page.tsx`

## What Was Integrated

### Mission Inbox

The portal now includes a public `Missions` section inspired by the Community Missions page:

- mission status: open, doing, needs owner;
- mission kind: amplify, review, scout, campaign, connect, publish;
- source and proof requirement on every mission;
- one clear next best action.

### Ambassador Briefs

The portal includes public-safe ambassador briefs:

- talking points, not scripts;
- source links attached to every brief;
- explicit "what to avoid" guardrails;
- proof URL submission preview.

### Proof and Credits Pattern

The portal adopts the proof flow from the ambassador dashboard:

1. contributor submits a public URL;
2. reviewer verifies source relevance, disclosure, safety and originality;
3. accepted proof can become a contribution receipt and Weekly Pulse recognition.

No account login, wallet flow or automatic posting is included in the static portal.

### Operator Queue Preview

The new `Operator cockpit` section models the private workflow:

- moderation queue;
- review rooms;
- reviewer ownership;
- SLA and decision reason;
- weekly rhythm: Monday triage, Wednesday review, Friday Pulse/demo/retro.

### Work Feed Ranking

The feed no longer mimics interactive voting. It uses a transparent community signal model:

- urgency;
- source quality;
- open help;
- freshness;
- safety severity.

## What Was Deliberately Not Integrated

- API keys or integration setup;
- private admin operations;
- publishing automation;
- personal account posting;
- wallet/payment flows;
- shipping addresses or drop recipient data;
- agent controls that could create spam without human review.

## Next Production Step

When the portal gets a backend, the static mission, proof and queue previews can become real records:

- `missions`
- `briefs`
- `proof_submissions`
- `review_decisions`
- `contribution_receipts`
- `weekly_pulse_items`

Until then, this integration keeps the public portal useful, safe and transparent.