# frankbria/saas-marketing-engine architecture

> Architecture diagram of the GitHub repository frankbria/saas-marketing-engine, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/frankbria/saas-marketing-engine
- Repository: https://github.com/frankbria/saas-marketing-engine

## Overview

SME turns a finished SaaS product into an operated marketing and monetization system. An operator creates and configures a product, reviews AI-generated strategy, completes setup and pre-launch QA, then the engine builds its site and generates, publishes, and measures marketing content. The dashboard exposes the private operator workflow; public funnel endpoints support customer conversion. The graph includes documented but unsampled capabilities at their existing module paths. Relationships for those branches are limited to README statements; source excerpts and the index provide stronger evidence for the API mounting, job execution, strategy review, and media dispatch paths.

Main entry points: [`backend/app/api/private`](https://github.com/frankbria/saas-marketing-engine/tree/main/backend/app/api/private) (Private dashboard API), [`backend/app/main.py`](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/main.py) (FastAPI app), [`backend/app/modules/crank/crank.py`](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/crank/crank.py) (Content orchestration), [`dashboard/app/products/[id]/page.tsx`](https://github.com/frankbria/saas-marketing-engine/blob/main/dashboard/app/products/%5Bid%5D/page.tsx) (Product workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Operator dashboard"]
  node_dashboard_ui["Product workspace<br/>[page.tsx]"]
  node_strategy_ui["Strategy review"]
  node_dashboard_api["Dashboard API client<br/>[api.ts]"]
end

subgraph group_api["API and orchestration"]
  node_app["FastAPI app<br/>[main.py]"]
  node_private_api["Private dashboard API"]
  node_public_api["Public funnel API"]
  node_job_worker["Job worker<br/>[worker.py]"]
  node_scheduler["Job scheduler<br/>[scheduler.py]"]
end

subgraph group_marketing["Strategy and launch"]
  node_strategy["Product strategy"]
  node_ai["AI generation<br/>[client.py]"]
  node_site_setup["Landing site setup<br/>[site.py]"]
  node_channel_setup["Channel setup<br/>[channels.py]"]
  node_stripe_setup["Payment setup<br/>[stripe_setup.py]"]
  node_qa["Launch QA<br/>[checklist.py]"]
  node_public_funnel["Conversion funnel<br/>[funnel.py]"]
end

subgraph group_content["Content operations"]
  node_crank["Content orchestration<br/>[crank.py]"]
  node_generation["Content generation<br/>[generate.py]"]
  node_channel_publish["Publishing channels<br/>[base.py]"]
  node_media_pipeline["Media rendering<br/>[tasks.py]"]
  node_metrics["Funnel and reach metrics"]
  node_heartbeat["Operations alerts<br/>[heartbeat.py]"]
end

subgraph group_state["State and integrations"]
  node_database[("Application database<br/>[db.py]")]
  node_models["Domain records"]
  node_media_queue["Celery media queue<br/>[celery_app.py]"]
end

node_operator(("Operator"))
node_customer(("Funnel visitor"))
node_stripe["Stripe"]
node_email["Email service"]

node_operator -->|"operates"| node_dashboard_ui
node_dashboard_ui -->|"loads product data"| node_dashboard_api
node_strategy_ui -->|"saves and approves"| node_dashboard_api
node_dashboard_ui -->|"renders"| node_strategy_ui
node_dashboard_api -->|"calls"| node_private_api
node_app -->|"mounts"| node_private_api
node_app -->|"mounts"| node_public_api
node_scheduler -.->|"runs jobs"| node_job_worker
node_app -->|"starts"| node_scheduler
node_private_api -.->|"requests strategy"| node_strategy
node_strategy -.->|"generates briefs"| node_ai
node_private_api -.->|"requests site setup"| node_site_setup
node_private_api -.->|"requests channel setup"| node_channel_setup
node_private_api -.->|"requests payment setup"| node_stripe_setup
node_private_api -.->|"manages QA"| node_qa
node_customer -->|"visits"| node_public_funnel
node_public_funnel -.->|"supports payment"| node_stripe
node_job_worker -->|"dispatches registered handler"| node_crank
node_crank -.->|"generates content"| node_generation
node_crank -.->|"publishes content"| node_channel_publish
node_crank -->|"dispatches renders"| node_media_pipeline
node_media_pipeline -->|"submits media tasks"| node_media_queue
node_public_funnel -.->|"records funnel activity"| node_metrics
node_heartbeat -->|"sends alerts"| node_email
node_job_worker -->|"reads and updates jobs"| node_models
node_app -->|"initializes"| node_database
node_models -.->|"persists records"| node_database

click node_dashboard_ui "https://github.com/frankbria/saas-marketing-engine/blob/main/dashboard/app/products/%5Bid%5D/page.tsx"
click node_strategy_ui "https://github.com/frankbria/saas-marketing-engine/blob/main/dashboard/app/products/%5Bid%5D/strategy-review.tsx"
click node_dashboard_api "https://github.com/frankbria/saas-marketing-engine/blob/main/dashboard/lib/api.ts"
click node_app "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/main.py"
click node_private_api "https://github.com/frankbria/saas-marketing-engine/tree/main/backend/app/api/private"
click node_public_api "https://github.com/frankbria/saas-marketing-engine/tree/main/backend/app/api/public"
click node_job_worker "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/worker.py"
click node_scheduler "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/scheduler.py"
click node_strategy "https://github.com/frankbria/saas-marketing-engine/tree/main/backend/app/modules/strategy"
click node_ai "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/ai/client.py"
click node_site_setup "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/setup/site.py"
click node_channel_setup "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/setup/channels.py"
click node_stripe_setup "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/setup/stripe_setup.py"
click node_qa "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/qa/checklist.py"
click node_public_funnel "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/api/public/funnel.py"
click node_crank "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/crank/crank.py"
click node_generation "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/crank/generate.py"
click node_channel_publish "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/channels/base.py"
click node_media_pipeline "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/media/tasks.py"
click node_metrics "https://github.com/frankbria/saas-marketing-engine/tree/main/backend/app/modules/metrics"
click node_heartbeat "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/heartbeat.py"
click node_database "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/db.py"
click node_models "https://github.com/frankbria/saas-marketing-engine/tree/main/backend/app/models"
click node_media_queue "https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/celery_app.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard_ui,node_strategy_ui,node_dashboard_api toneBlue
class node_app,node_private_api,node_public_api,node_job_worker,node_scheduler toneAmber
class node_strategy,node_ai,node_site_setup,node_channel_setup,node_stripe_setup,node_qa,node_public_funnel toneMint
class node_crank,node_generation,node_channel_publish,node_media_pipeline,node_metrics,node_heartbeat toneRose
class node_database,node_models,node_media_queue,node_operator,node_customer,node_stripe,node_email toneIndigo
```

## Components

### Operator dashboard

- [Product workspace](https://github.com/frankbria/saas-marketing-engine/blob/main/dashboard/app/products/%5Bid%5D/page.tsx): `dashboard/app/products/[id]/page.tsx`
- [Strategy review](https://github.com/frankbria/saas-marketing-engine/blob/main/dashboard/app/products/%5Bid%5D/strategy-review.tsx): `dashboard/app/products/[id]/strategy-review.tsx`
- [Dashboard API client](https://github.com/frankbria/saas-marketing-engine/blob/main/dashboard/lib/api.ts): `dashboard/lib/api.ts`

### API and orchestration

- [FastAPI app](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/main.py): `backend/app/main.py`
- [Private dashboard API](https://github.com/frankbria/saas-marketing-engine/tree/main/backend/app/api/private): `backend/app/api/private`
- [Public funnel API](https://github.com/frankbria/saas-marketing-engine/tree/main/backend/app/api/public): `backend/app/api/public`
- [Job worker](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/worker.py): `backend/app/worker.py`
- [Job scheduler](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/scheduler.py): `backend/app/scheduler.py`

### Strategy and launch

- [Product strategy](https://github.com/frankbria/saas-marketing-engine/tree/main/backend/app/modules/strategy): `backend/app/modules/strategy`
- [AI generation](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/ai/client.py): `backend/app/ai/client.py`
- [Landing site setup](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/setup/site.py): `backend/app/modules/setup/site.py`
- [Channel setup](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/setup/channels.py): `backend/app/modules/setup/channels.py`
- [Payment setup](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/setup/stripe_setup.py): `backend/app/modules/setup/stripe_setup.py`
- [Launch QA](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/qa/checklist.py): `backend/app/modules/qa/checklist.py`
- [Conversion funnel](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/api/public/funnel.py): `backend/app/api/public/funnel.py`

### Content operations

- [Content orchestration](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/crank/crank.py): `backend/app/modules/crank/crank.py`
- [Content generation](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/crank/generate.py): `backend/app/modules/crank/generate.py`
- [Publishing channels](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/channels/base.py): `backend/app/channels/base.py`
- [Media rendering](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/media/tasks.py): `backend/app/modules/media/tasks.py`
- [Funnel and reach metrics](https://github.com/frankbria/saas-marketing-engine/tree/main/backend/app/modules/metrics): `backend/app/modules/metrics`
- [Operations alerts](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/modules/heartbeat.py): `backend/app/modules/heartbeat.py`

### State and integrations

- [Application database](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/db.py): `backend/app/db.py`
- [Domain records](https://github.com/frankbria/saas-marketing-engine/tree/main/backend/app/models): `backend/app/models`
- [Celery media queue](https://github.com/frankbria/saas-marketing-engine/blob/main/backend/app/celery_app.py): `backend/app/celery_app.py`

### Other components

- **Operator**
- **Funnel visitor**
- **Stripe**
- **Email service**

## Connections

- Operator → Product workspace: operates (evidence: `README.md`)
- Product workspace → Dashboard API client: loads product data (evidence: `dashboard/app/products/[id]/page.tsx`)
- Strategy review → Dashboard API client: saves and approves (evidence: `dashboard/app/products/[id]/strategy-review.tsx`)
- Product workspace → Strategy review: renders (evidence: `dashboard/app/products/[id]/page.tsx`)
- Dashboard API client → Private dashboard API: calls (evidence: `README.md`)
- FastAPI app → Private dashboard API: mounts (evidence: `backend/app/main.py`)
- FastAPI app → Public funnel API: mounts (evidence: `backend/app/main.py`)
- Job scheduler → Job worker: runs jobs
- FastAPI app → Job scheduler: starts (evidence: `backend/app/main.py`)
- Private dashboard API → Product strategy: requests strategy
- Product strategy → AI generation: generates briefs
- Private dashboard API → Landing site setup: requests site setup
- Private dashboard API → Channel setup: requests channel setup
- Private dashboard API → Payment setup: requests payment setup
- Private dashboard API → Launch QA: manages QA
- Funnel visitor → Conversion funnel: visits (evidence: `README.md`)
- Conversion funnel → Stripe: supports payment
- Job worker → Content orchestration: dispatches registered handler (evidence: `backend/app/modules/crank/crank.py`)
- Content orchestration → Content generation: generates content
- Content orchestration → Publishing channels: publishes content
- Content orchestration → Media rendering: dispatches renders
- Media rendering → Celery media queue: submits media tasks (evidence: `backend/app/modules/media/tasks.py`)
- Conversion funnel → Funnel and reach metrics: records funnel activity
- Operations alerts → Email service: sends alerts
- Job worker → Domain records: reads and updates jobs (evidence: `backend/app/worker.py`)
- FastAPI app → Application database: initializes (evidence: `backend/app/main.py`)
- Domain records → Application database: persists records
