# samuelscheit/phishing.support architecture

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

- Interactive diagram: https://gitdiagram.com/samuelscheit/phishing.support
- Repository: https://github.com/samuelscheit/phishing.support

## Overview

Phishing Support accepts suspicious email and website submissions, analyzes them, and supports a separate durable abuse-reporting workflow that resolves provider routes, submits reports, and tracks correspondence and outcomes. The graph includes the web/API entry points, legacy analysis intake, the abuse worker and persistence layer, plus documented provider and browser-automation capabilities. Some subsystem internals are unsampled; links to those capabilities rely on README statements or indexed references, not inspection of their implementation.

Main entry points: [`src/lib/abuse/worker.ts`](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/worker.ts) (Abuse Worker), [`src/lib/db/entities.ts`](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/db/entities.ts) (Submission Records), [`src/lib/abuse/repository.ts`](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/repository.ts) (Abuse Repository), [`src/lib/submissions/email.ts`](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/submissions/email.ts) (Email Intake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Submission Intake"]
  node_web["Submission UI<br/>[page.tsx]"]
  node_email_api["Email API<br/>[route.ts]"]
  node_website_api["Website API<br/>[route.ts]"]
  node_mail_intake["Email Intake<br/>[email.ts]"]
  node_website_intake["Website Intake<br/>[website.ts]"]
end

subgraph group_analysis["Analysis and Evidence"]
  node_email_analysis["Email Analysis<br/>[mail_ai.ts]"]
  node_website_analysis["Website Analysis<br/>[website_ai.ts]"]
  node_submission_retry["Analysis Retry<br/>[retry.ts]"]
  node_stream_api["Analysis Stream<br/>[route.ts]"]
end

subgraph group_abuse["Abuse Reporting"]
  node_abuse_api["Abuse Report API<br/>[route.ts]"]
  node_route_contracts["Route Contracts<br/>[route_contracts.ts]"]
  node_abuse_worker["Abuse Worker<br/>[worker.ts]"]
  node_target_resolver["Target Resolver"]
  node_artifact_api["Artifact Access<br/>[route.ts]"]
end

subgraph group_delivery["Provider Delivery"]
  node_provider_routes["Provider Routing"]
  node_provider_registry["Provider Registry<br/>[index.ts]"]
  node_provider_execution["Provider Execution"]
  node_skyvern["Dynamic Provider Forms"]
  node_fabric["Browser Fabric<br/>[session.ts]"]
  node_abuse_mail["Abuse Mail"]
end

subgraph group_platform["Persistence and Messaging"]
  node_submission_store[("Submission Records<br/>[entities.ts]")]
  node_abuse_repository["Abuse Repository<br/>[repository.ts]"]
  node_abuse_store[("Abuse Persistence")]
  node_abuse_schema["Abuse Data Model<br/>[schema.ts]"]
  node_correspondence["Report Correspondence<br/>[correspondence.ts]"]
  node_imap["Inbound Mail Listener<br/>[imap_listener.ts]"]
  node_metadata["Reporter Metadata"]
end

node_reporter(("Reporter"))

node_reporter -->|"submits URL or email"| node_web
node_web -.->|"uploads email"| node_email_api
node_web -.->|"sends URL"| node_website_api
node_email_api -->|"creates submission"| node_mail_intake
node_website_api -->|"creates submission"| node_website_intake
node_email_api -->|"captures metadata"| node_metadata
node_website_api -->|"captures metadata"| node_metadata
node_mail_intake -->|"creates record"| node_submission_store
node_mail_intake -->|"starts analysis"| node_email_analysis
node_website_intake -->|"creates record"| node_submission_store
node_website_intake -.->|"starts analysis"| node_website_analysis
node_submission_retry -->|"retries analysis"| node_email_analysis
node_email_analysis -.->|"stores artifacts"| node_submission_store
node_website_analysis -.->|"stores results"| node_submission_store
node_reporter -->|"files abuse report"| node_abuse_api
node_abuse_api -->|"creates report"| node_abuse_repository
node_abuse_api -->|"captures metadata"| node_metadata
node_abuse_repository -->|"persists lifecycle"| node_abuse_store
node_abuse_repository -->|"uses data model"| node_abuse_schema
node_abuse_repository -->|"exposes route input"| node_route_contracts
node_abuse_worker -->|"loads and settles work"| node_abuse_repository
node_abuse_worker -->|"resolves targets"| node_target_resolver
node_abuse_worker -->|"dispatches submissions"| node_provider_registry
node_target_resolver -.->|"builds routes"| node_provider_routes
node_provider_registry -->|"provides execution"| node_provider_execution
node_abuse_worker -->|"runs dynamic tasks"| node_skyvern
node_skyvern -->|"uses browser sessions"| node_fabric
node_abuse_worker -->|"sends provider mail"| node_abuse_mail
node_imap -->|"routes replies"| node_correspondence
node_imap -->|"ingests forwarded mail"| node_mail_intake
node_artifact_api -->|"reads artifacts"| node_submission_store
node_stream_api -.->|"streams status"| node_submission_store

click node_web "https://github.com/samuelscheit/phishing.support/blob/main/src/app/page.tsx"
click node_email_api "https://github.com/samuelscheit/phishing.support/blob/main/src/app/api/submissions/email/route.ts"
click node_website_api "https://github.com/samuelscheit/phishing.support/blob/main/src/app/api/submissions/website/route.ts"
click node_mail_intake "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/submissions/email.ts"
click node_website_intake "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/submissions/website.ts"
click node_email_analysis "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/mail_ai.ts"
click node_website_analysis "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/website_ai.ts"
click node_submission_store "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/db/entities.ts"
click node_submission_retry "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/submissions/retry.ts"
click node_abuse_api "https://github.com/samuelscheit/phishing.support/blob/main/src/app/api/abuse/reports/route.ts"
click node_abuse_repository "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/repository.ts"
click node_abuse_store "https://github.com/samuelscheit/phishing.support/tree/main/src/lib/abuse/persistence"
click node_abuse_schema "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/schema.ts"
click node_route_contracts "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/route_contracts.ts"
click node_abuse_worker "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/worker.ts"
click node_target_resolver "https://github.com/samuelscheit/phishing.support/tree/main/src/lib/abuse/resolver"
click node_provider_routes "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/providers/submission_routes.ts"
click node_provider_registry "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/providers/index.ts"
click node_provider_execution "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/providers/submission_contracts.ts"
click node_skyvern "https://github.com/samuelscheit/phishing.support/tree/main/src/lib/abuse/skyvern"
click node_fabric "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/fabric/session.ts"
click node_abuse_mail "https://github.com/samuelscheit/phishing.support/tree/main/src/lib/abuse/mail"
click node_correspondence "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/report/correspondence.ts"
click node_imap "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/imap/imap_listener.ts"
click node_metadata "https://github.com/samuelscheit/phishing.support/blob/main/src/lib/request_metadata.ts"
click node_artifact_api "https://github.com/samuelscheit/phishing.support/blob/main/src/app/api/artifacts/%5Bid%5D/route.ts"
click node_stream_api "https://github.com/samuelscheit/phishing.support/blob/main/src/app/api/stream/%5Bid%5D/route.ts"

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_web,node_email_api,node_website_api,node_mail_intake,node_website_intake toneBlue
class node_email_analysis,node_website_analysis,node_submission_retry,node_stream_api toneAmber
class node_abuse_api,node_route_contracts,node_abuse_worker,node_target_resolver,node_artifact_api toneMint
class node_provider_routes,node_provider_registry,node_provider_execution,node_skyvern,node_fabric,node_abuse_mail toneRose
class node_submission_store,node_abuse_repository,node_abuse_store,node_abuse_schema,node_correspondence,node_imap,node_metadata,node_reporter toneIndigo
```

## Components

### Submission Intake

- [Submission UI](https://github.com/samuelscheit/phishing.support/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Email API](https://github.com/samuelscheit/phishing.support/blob/main/src/app/api/submissions/email/route.ts): `src/app/api/submissions/email/route.ts`
- [Website API](https://github.com/samuelscheit/phishing.support/blob/main/src/app/api/submissions/website/route.ts): `src/app/api/submissions/website/route.ts`
- [Email Intake](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/submissions/email.ts): `src/lib/submissions/email.ts`
- [Website Intake](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/submissions/website.ts): `src/lib/submissions/website.ts`

### Analysis and Evidence

- [Email Analysis](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/mail_ai.ts): `src/lib/mail_ai.ts`
- [Website Analysis](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/website_ai.ts): `src/lib/website_ai.ts`
- [Analysis Retry](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/submissions/retry.ts): `src/lib/submissions/retry.ts`
- [Analysis Stream](https://github.com/samuelscheit/phishing.support/blob/main/src/app/api/stream/%5Bid%5D/route.ts): `src/app/api/stream/[id]/route.ts`

### Abuse Reporting

- [Abuse Report API](https://github.com/samuelscheit/phishing.support/blob/main/src/app/api/abuse/reports/route.ts): `src/app/api/abuse/reports/route.ts`
- [Route Contracts](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/route_contracts.ts): `src/lib/abuse/route_contracts.ts`
- [Abuse Worker](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/worker.ts): `src/lib/abuse/worker.ts`
- [Target Resolver](https://github.com/samuelscheit/phishing.support/tree/main/src/lib/abuse/resolver): `src/lib/abuse/resolver`
- [Artifact Access](https://github.com/samuelscheit/phishing.support/blob/main/src/app/api/artifacts/%5Bid%5D/route.ts): `src/app/api/artifacts/[id]/route.ts`

### Provider Delivery

- [Provider Routing](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/providers/submission_routes.ts): `src/lib/abuse/providers/submission_routes.ts`
- [Provider Registry](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/providers/index.ts): `src/lib/abuse/providers/index.ts`
- [Provider Execution](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/providers/submission_contracts.ts): `src/lib/abuse/providers/submission_contracts.ts`
- [Dynamic Provider Forms](https://github.com/samuelscheit/phishing.support/tree/main/src/lib/abuse/skyvern): `src/lib/abuse/skyvern`
- [Browser Fabric](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/fabric/session.ts): `src/lib/fabric/session.ts`
- [Abuse Mail](https://github.com/samuelscheit/phishing.support/tree/main/src/lib/abuse/mail): `src/lib/abuse/mail`

### Persistence and Messaging

- [Submission Records](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/db/entities.ts): `src/lib/db/entities.ts`
- [Abuse Repository](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/repository.ts): `src/lib/abuse/repository.ts`
- [Abuse Persistence](https://github.com/samuelscheit/phishing.support/tree/main/src/lib/abuse/persistence): `src/lib/abuse/persistence`
- [Abuse Data Model](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/abuse/schema.ts): `src/lib/abuse/schema.ts`
- [Report Correspondence](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/report/correspondence.ts): `src/lib/report/correspondence.ts`
- [Inbound Mail Listener](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/imap/imap_listener.ts): `src/lib/imap/imap_listener.ts`
- [Reporter Metadata](https://github.com/samuelscheit/phishing.support/blob/main/src/lib/request_metadata.ts): `src/lib/request_metadata.ts`

### Other components

- **Reporter**

## Connections

- Reporter → Submission UI: submits URL or email
- Submission UI → Email API: uploads email
- Submission UI → Website API: sends URL
- Email API → Email Intake: creates submission (evidence: `src/app/api/submissions/email/route.ts`)
- Website API → Website Intake: creates submission (evidence: `src/app/api/submissions/website/route.ts`)
- Email API → Reporter Metadata: captures metadata (evidence: `src/app/api/submissions/email/route.ts`)
- Website API → Reporter Metadata: captures metadata (evidence: `src/app/api/submissions/website/route.ts`)
- Email Intake → Submission Records: creates record (evidence: `src/lib/submissions/email.ts`)
- Email Intake → Email Analysis: starts analysis (evidence: `src/lib/submissions/email.ts`)
- Website Intake → Submission Records: creates record (evidence: `src/lib/submissions/website.ts`)
- Website Intake → Website Analysis: starts analysis (evidence: `src/lib/submissions/website.ts`)
- Analysis Retry → Email Analysis: retries analysis (evidence: `src/lib/submissions/email.ts`)
- Email Analysis → Submission Records: stores artifacts
- Website Analysis → Submission Records: stores results
- Reporter → Abuse Report API: files abuse report
- Abuse Report API → Abuse Repository: creates report (evidence: `src/app/api/abuse/reports/route.ts`)
- Abuse Report API → Reporter Metadata: captures metadata (evidence: `src/app/api/abuse/reports/route.ts`)
- Abuse Repository → Abuse Persistence: persists lifecycle (evidence: `src/lib/abuse/repository.ts`)
- Abuse Repository → Abuse Data Model: uses data model (evidence: `src/lib/abuse/repository.ts`)
- Abuse Repository → Route Contracts: exposes route input (evidence: `src/lib/abuse/repository.ts`)
- Abuse Worker → Abuse Repository: loads and settles work (evidence: `src/lib/abuse/worker.ts`)
- Abuse Worker → Target Resolver: resolves targets (evidence: `src/lib/abuse/worker.ts`)
- Abuse Worker → Provider Registry: dispatches submissions (evidence: `src/lib/abuse/worker.ts`)
- Target Resolver → Provider Routing: builds routes
- Provider Registry → Provider Execution: provides execution (evidence: `src/lib/abuse/providers/index.ts`)
- Abuse Worker → Dynamic Provider Forms: runs dynamic tasks (evidence: `src/lib/abuse/worker.ts`)
- Dynamic Provider Forms → Browser Fabric: uses browser sessions
- Abuse Worker → Abuse Mail: sends provider mail (evidence: `src/lib/abuse/worker.ts`)
- Inbound Mail Listener → Report Correspondence: routes replies
- Inbound Mail Listener → Email Intake: ingests forwarded mail
- Artifact Access → Submission Records: reads artifacts (evidence: `src/app/api/artifacts/[id]/route.ts`)
- Analysis Stream → Submission Records: streams status
