# sakshee30/acemarketing- architecture

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

- Interactive diagram: https://gitdiagram.com/sakshee30/acemarketing-
- Repository: https://github.com/sakshee30/acemarketing-

## Overview

AceMarketing is a marketing-intelligence and activation platform. Its user-facing workflow captures marketing and offline interaction signals, synchronizes connector data, stitches and grades leads, supports agent-driven operations, attributes outcomes, and returns conversion signals to advertising platforms. The graph combines the documented product workflow and capabilities with relationships visible in the sampled source index and excerpts. Several substantial backend capabilities are represented at their exact source paths, but their internal calls were not sampled, so those links are omitted rather than inferred.

Main entry points: [`backend/src/index.mjs`](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/index.mjs) (Backend API), [`backend/src/attribution-store.mjs`](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/attribution-store.mjs) (Attribution), [`backend/src/ai-runtime.mjs`](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/ai-runtime.mjs) (AI runtime), [`backend/src/lead-ops.mjs`](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/lead-ops.mjs) (Lead operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Product experience"]
  node_workspace["Workspace UI<br/>[main.tsx]"]
  node_api["Backend API<br/>[index.mjs]"]
end

subgraph group_data["Signal and data"]
  node_tracking["Tracking ingestion"]
  node_connectors["Connector ecosystem"]
  node_attribution[("Attribution")]
end

subgraph group_operations["Marketing operations"]
  node_leadops["Lead operations<br/>[lead-ops.mjs]"]
  node_agents["Agent operations"]
  node_audiences["Audience activation"]
  node_activation["Conversion activation"]
  node_ai["AI runtime<br/>[ai-runtime.mjs]"]
  node_ml["ML pipelines<br/>[pipelines.py]"]
end

subgraph group_platform["Runtime platform"]
  node_jobqueue["Durable jobs<br/>[queue.mjs]"]
  node_state[("Application state<br/>[store.mjs]")]
  node_database[("Postgres<br/>[database.mjs]")]
end

node_marketer(("Marketer"))
node_adplatforms["Ad platforms"]
node_offlinechannels["Offline channels"]

node_marketer -->|"uses"| node_workspace
node_workspace -.->|"requests data"| node_api
node_offlinechannels -.->|"send signals"| node_tracking
node_tracking -->|"synchronize"| node_connectors
node_connectors -.->|"inform matching"| node_attribution
node_attribution -.->|"inform lead grading"| node_leadops
node_leadops -.->|"support automation"| node_agents
node_agents -.->|"support activation"| node_audiences
node_attribution -.->|"inform conversion signals"| node_activation
node_api -->|"reconcile"| node_attribution
node_api -->|"read and mutate"| node_state
node_api -->|"check availability"| node_jobqueue
node_ai -->|"enqueue jobs"| node_jobqueue
node_ai -->|"record review"| node_activation
node_ai -.->|"load runtime data"| node_database
node_activation -.->|"return conversion signals"| node_adplatforms
node_ml -.->|"support lead grading"| node_leadops

click node_workspace "https://github.com/sakshee30/acemarketing-/blob/main/frontend/customer-app/src/main.tsx"
click node_api "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/index.mjs"
click node_tracking "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/connector-ingestion.mjs"
click node_connectors "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/connector-ingestion.mjs"
click node_attribution "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/attribution-store.mjs"
click node_leadops "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/lead-ops.mjs"
click node_agents "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/agent-orchestrator.mjs"
click node_audiences "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/audience-scheduler.mjs"
click node_activation "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/ai-activation-proposals.mjs"
click node_ai "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/ai-runtime.mjs"
click node_ml "https://github.com/sakshee30/acemarketing-/blob/main/ml-service/src/acemarketing_ml/pipelines.py"
click node_jobqueue "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/queue.mjs"
click node_state "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/store.mjs"
click node_database "https://github.com/sakshee30/acemarketing-/blob/main/backend/src/database.mjs"

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_workspace,node_api toneBlue
class node_tracking,node_connectors,node_attribution toneAmber
class node_leadops,node_agents,node_audiences,node_activation,node_ai,node_ml toneMint
class node_jobqueue,node_state,node_database toneRose
class node_marketer,node_adplatforms,node_offlinechannels toneIndigo
```

## Components

### Product experience

- [Workspace UI](https://github.com/sakshee30/acemarketing-/blob/main/frontend/customer-app/src/main.tsx): `frontend/customer-app/src/main.tsx`
- [Backend API](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/index.mjs): `backend/src/index.mjs`

### Signal and data

- [Tracking ingestion](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/connector-ingestion.mjs): `backend/src/connector-ingestion.mjs`
- [Connector ecosystem](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/connector-ingestion.mjs): `backend/src/connector-ingestion.mjs`
- [Attribution](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/attribution-store.mjs): `backend/src/attribution-store.mjs`

### Marketing operations

- [Lead operations](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/lead-ops.mjs): `backend/src/lead-ops.mjs`
- [Agent operations](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/agent-orchestrator.mjs): `backend/src/agent-orchestrator.mjs`
- [Audience activation](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/audience-scheduler.mjs): `backend/src/audience-scheduler.mjs`
- [Conversion activation](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/ai-activation-proposals.mjs): `backend/src/ai-activation-proposals.mjs`
- [AI runtime](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/ai-runtime.mjs): `backend/src/ai-runtime.mjs`
- [ML pipelines](https://github.com/sakshee30/acemarketing-/blob/main/ml-service/src/acemarketing_ml/pipelines.py): `ml-service/src/acemarketing_ml/pipelines.py`

### Runtime platform

- [Durable jobs](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/queue.mjs): `backend/src/queue.mjs`
- [Application state](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/store.mjs): `backend/src/store.mjs`
- [Postgres](https://github.com/sakshee30/acemarketing-/blob/main/backend/src/database.mjs): `backend/src/database.mjs`

### Other components

- **Marketer**
- **Ad platforms**
- **Offline channels**

## Connections

- Marketer → Workspace UI: uses (evidence: `README.md`)
- Workspace UI → Backend API: requests data (evidence: `README.md`)
- Offline channels → Tracking ingestion: send signals (evidence: `README.md`)
- Tracking ingestion → Connector ecosystem: synchronize (evidence: `backend/src/connector-ingestion.mjs`)
- Connector ecosystem → Attribution: inform matching (evidence: `README.md`)
- Attribution → Lead operations: inform lead grading (evidence: `README.md`)
- Lead operations → Agent operations: support automation (evidence: `README.md`)
- Agent operations → Audience activation: support activation (evidence: `README.md`)
- Attribution → Conversion activation: inform conversion signals (evidence: `README.md`)
- Backend API → Attribution: reconcile (evidence: `backend/src/index.mjs`)
- Backend API → Application state: read and mutate (evidence: `backend/src/index.mjs`)
- Backend API → Durable jobs: check availability (evidence: `backend/src/index.mjs`)
- AI runtime → Durable jobs: enqueue jobs (evidence: `backend/src/ai-runtime.mjs`)
- AI runtime → Conversion activation: record review (evidence: `backend/src/ai-runtime.mjs`)
- AI runtime → Postgres: load runtime data (evidence: `backend/src/ai-runtime.mjs`)
- Conversion activation → Ad platforms: return conversion signals (evidence: `README.md`)
- ML pipelines → Lead operations: support lead grading (evidence: `README.md`)
