# okeson453/lcc architecture

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

- Interactive diagram: https://gitdiagram.com/okeson453/lcc
- Repository: https://github.com/okeson453/lcc

## Overview

OKESON-LCC is a LinkedIn management platform with a Next.js dashboard and browser extension, a Rust safety-critical core, and a Python intelligence engine. Its intended outbound workflow is user request and approval, Compliance Governor permit issuance, Integration Gateway verification and execution, then LinkedIn; the gateway is documented as the sole credential holder. Other documented capabilities include grounded drafting, lead discovery, and realtime dashboard updates. The README notes that routes remain scaffolds and no API endpoint is implemented end-to-end, so these links describe documented architecture rather than a verified deployed flow.

Main entry points: [`Frontend/apps/web-dashboard/src`](https://github.com/okeson453/lcc/tree/main/Frontend/apps/web-dashboard/src) (Web dashboard), [`Backend/engine/core/services/integration-gateway/src`](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/integration-gateway/src) (Integration Gateway), [`Backend/engine/core/services/api-gateway/src`](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/api-gateway/src) (API gateway), [`Backend/engine/core/services/approval-svc/src`](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/approval-svc/src) (Approval service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_surfaces["User surfaces"]
  node_dashboard["Web dashboard"]
  node_extension["Browser extension"]
  node_realtime["Realtime client<br/>[client.ts]"]
end

subgraph group_safety["Safety and access"]
  node_api_gateway["API gateway"]
  node_identity["Identity service"]
  node_governor["Compliance Governor"]
  node_integration["Integration Gateway"]
end

subgraph group_domain["Core product services"]
  node_approval["Approval service"]
  node_content["Content service"]
  node_outreach["Outreach service"]
  node_opportunity["Opportunity service"]
  node_network_crm["Network CRM"]
  node_orchestrator["Workflow orchestrator"]
end

subgraph group_intelligence["Intelligence engine"]
  node_ai_worker["Drafting and RAG"]
  node_kb_intel["Knowledge intelligence"]
  node_opportunity_intel["Opportunity intelligence"]
  node_scoring_intel["Scoring intelligence"]
end

subgraph group_shared["Shared runtime"]
  node_kb_store[("Knowledge repository<br/>[repository.py]")]
  node_track_a["Track A clients<br/>[share_client.rs]"]
end

node_user(("Member"))
node_linkedin["LinkedIn"]

node_user -->|"uses"| node_dashboard
node_user -->|"uses"| node_extension
node_dashboard -->|"requests services"| node_api_gateway
node_extension -->|"requests services"| node_api_gateway
node_dashboard -->|"reviews actions"| node_approval
node_api_gateway -.->|"authenticates"| node_identity
node_approval -.->|"requests evaluation"| node_governor
node_governor -->|"issues permit"| node_integration
node_integration -->|"executes actions"| node_linkedin
node_integration -->|"uses official API"| node_track_a
node_content -.->|"requests drafts"| node_ai_worker
node_ai_worker -.->|"retrieves knowledge"| node_kb_intel
node_kb_intel -.->|"reads and writes"| node_kb_store
node_opportunity -.->|"requests discovery"| node_opportunity_intel
node_opportunity_intel -.->|"requests scores"| node_scoring_intel
node_network_crm -.->|"surfaces leads"| node_opportunity
node_dashboard -->|"subscribes updates"| node_realtime
node_orchestrator -.->|"coordinates workflow"| node_approval

click node_dashboard "https://github.com/okeson453/lcc/tree/main/Frontend/apps/web-dashboard/src"
click node_extension "https://github.com/okeson453/lcc/tree/main/Frontend/apps/browser-extension/src"
click node_realtime "https://github.com/okeson453/lcc/blob/main/Frontend/packages/realtime/src/client.ts"
click node_api_gateway "https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/api-gateway/src"
click node_identity "https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/identity-svc/src"
click node_governor "https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/compliance-governor/src"
click node_integration "https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/integration-gateway/src"
click node_approval "https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/approval-svc/src"
click node_content "https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/content-svc/src"
click node_outreach "https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/outreach-svc/src"
click node_opportunity "https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/opportunity-svc/src"
click node_network_crm "https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/network-crm-svc/src"
click node_orchestrator "https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/orchestrator/src"
click node_ai_worker "https://github.com/okeson453/lcc/tree/main/Backend/engine/intelligence/services/ai-worker/src/ai_worker"
click node_kb_intel "https://github.com/okeson453/lcc/tree/main/Backend/engine/intelligence/services/kb-intel/src/kb_intel"
click node_opportunity_intel "https://github.com/okeson453/lcc/tree/main/Backend/engine/intelligence/services/opportunity-intel/src/opportunity_intel"
click node_scoring_intel "https://github.com/okeson453/lcc/tree/main/Backend/engine/intelligence/services/scoring-intel/src/scoring_intel"
click node_kb_store "https://github.com/okeson453/lcc/blob/main/Backend/packages/kb-client/src/kb_client/repository.py"
click node_track_a "https://github.com/okeson453/lcc/blob/main/Backend/crates/integrations/src/track_a/share_client.rs"

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,node_extension,node_realtime toneBlue
class node_api_gateway,node_identity,node_governor,node_integration toneAmber
class node_approval,node_content,node_outreach,node_opportunity,node_network_crm,node_orchestrator toneMint
class node_ai_worker,node_kb_intel,node_opportunity_intel,node_scoring_intel toneRose
class node_kb_store,node_track_a,node_user,node_linkedin toneIndigo
```

## Components

### User surfaces

- [Web dashboard](https://github.com/okeson453/lcc/tree/main/Frontend/apps/web-dashboard/src): `Frontend/apps/web-dashboard/src`
- [Browser extension](https://github.com/okeson453/lcc/tree/main/Frontend/apps/browser-extension/src): `Frontend/apps/browser-extension/src`
- [Realtime client](https://github.com/okeson453/lcc/blob/main/Frontend/packages/realtime/src/client.ts): `Frontend/packages/realtime/src/client.ts`

### Safety and access

- [API gateway](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/api-gateway/src): `Backend/engine/core/services/api-gateway/src`
- [Identity service](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/identity-svc/src): `Backend/engine/core/services/identity-svc/src`
- [Compliance Governor](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/compliance-governor/src): `Backend/engine/core/services/compliance-governor/src`
- [Integration Gateway](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/integration-gateway/src): `Backend/engine/core/services/integration-gateway/src`

### Core product services

- [Approval service](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/approval-svc/src): `Backend/engine/core/services/approval-svc/src`
- [Content service](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/content-svc/src): `Backend/engine/core/services/content-svc/src`
- [Outreach service](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/outreach-svc/src): `Backend/engine/core/services/outreach-svc/src`
- [Opportunity service](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/opportunity-svc/src): `Backend/engine/core/services/opportunity-svc/src`
- [Network CRM](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/network-crm-svc/src): `Backend/engine/core/services/network-crm-svc/src`
- [Workflow orchestrator](https://github.com/okeson453/lcc/tree/main/Backend/engine/core/services/orchestrator/src): `Backend/engine/core/services/orchestrator/src`

### Intelligence engine

- [Drafting and RAG](https://github.com/okeson453/lcc/tree/main/Backend/engine/intelligence/services/ai-worker/src/ai_worker): `Backend/engine/intelligence/services/ai-worker/src/ai_worker`
- [Knowledge intelligence](https://github.com/okeson453/lcc/tree/main/Backend/engine/intelligence/services/kb-intel/src/kb_intel): `Backend/engine/intelligence/services/kb-intel/src/kb_intel`
- [Opportunity intelligence](https://github.com/okeson453/lcc/tree/main/Backend/engine/intelligence/services/opportunity-intel/src/opportunity_intel): `Backend/engine/intelligence/services/opportunity-intel/src/opportunity_intel`
- [Scoring intelligence](https://github.com/okeson453/lcc/tree/main/Backend/engine/intelligence/services/scoring-intel/src/scoring_intel): `Backend/engine/intelligence/services/scoring-intel/src/scoring_intel`

### Shared runtime

- [Knowledge repository](https://github.com/okeson453/lcc/blob/main/Backend/packages/kb-client/src/kb_client/repository.py): `Backend/packages/kb-client/src/kb_client/repository.py`
- [Track A clients](https://github.com/okeson453/lcc/blob/main/Backend/crates/integrations/src/track_a/share_client.rs): `Backend/crates/integrations/src/track_a/share_client.rs`

### Other components

- **Member**
- **LinkedIn**

## Connections

- Member → Web dashboard: uses (evidence: `README.md`)
- Member → Browser extension: uses (evidence: `README.md`)
- Web dashboard → API gateway: requests services (evidence: `README.md`)
- Browser extension → API gateway: requests services (evidence: `README.md`)
- Web dashboard → Approval service: reviews actions (evidence: `README.md`)
- API gateway → Identity service: authenticates
- Approval service → Compliance Governor: requests evaluation
- Compliance Governor → Integration Gateway: issues permit (evidence: `README.md`)
- Integration Gateway → LinkedIn: executes actions (evidence: `README.md`)
- Integration Gateway → Track A clients: uses official API (evidence: `Backend/engine/core/services/integration-gateway/src/track_a.rs`)
- Content service → Drafting and RAG: requests drafts
- Drafting and RAG → Knowledge intelligence: retrieves knowledge
- Knowledge intelligence → Knowledge repository: reads and writes
- Opportunity service → Opportunity intelligence: requests discovery
- Opportunity intelligence → Scoring intelligence: requests scores
- Network CRM → Opportunity service: surfaces leads
- Web dashboard → Realtime client: subscribes updates (evidence: `README.md`)
- Workflow orchestrator → Approval service: coordinates workflow
