How samuelscheit/phishing.support works
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: worker.ts Abuse Worker · entities.ts Submission Records · repository.ts Abuse Repository · email.ts Email Intake
Components 28
Submission Intake
- Submission UI
src/app/page.tsx - Email API
src/app/api/submissions/email/route.ts - Website API
src/app/api/submissions/website/route.ts - Email Intake
src/lib/submissions/email.ts - Website Intake
src/lib/submissions/website.ts
Analysis and Evidence
- Email Analysis
src/lib/mail_ai.ts - Website Analysis
src/lib/website_ai.ts - Analysis Retry
src/lib/submissions/retry.ts - Analysis Stream
src/app/api/stream/[id]/route.ts
Abuse Reporting
- Abuse Report API
src/app/api/abuse/reports/route.ts - Route Contracts
src/lib/abuse/route_contracts.ts - Abuse Worker
src/lib/abuse/worker.ts - Target Resolver
src/lib/abuse/resolver - Artifact Access
src/app/api/artifacts/[id]/route.ts
Provider Delivery
- Provider Routing
src/lib/abuse/providers/submission_routes.ts - Provider Registry
src/lib/abuse/providers/index.ts - Provider Execution
src/lib/abuse/providers/submission_contracts.ts - Dynamic Provider Forms
src/lib/abuse/skyvern - Browser Fabric
src/lib/fabric/session.ts - Abuse Mail
src/lib/abuse/mail
Persistence and Messaging
- Submission Records
src/lib/db/entities.ts - Abuse Repository
src/lib/abuse/repository.ts - Abuse Persistence
src/lib/abuse/persistence - Abuse Data Model
src/lib/abuse/schema.ts - Report Correspondence
src/lib/report/correspondence.ts - Inbound Mail Listener
src/lib/imap/imap_listener.ts - Reporter Metadata
src/lib/request_metadata.ts
Other components
- Reporter
Connections 32
- 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
src/app/api/submissions/email/route.ts - Website API → Website Intake: creates submission
src/app/api/submissions/website/route.ts - Email API → Reporter Metadata: captures metadata
src/app/api/submissions/email/route.ts - Website API → Reporter Metadata: captures metadata
src/app/api/submissions/website/route.ts - Email Intake → Submission Records: creates record
src/lib/submissions/email.ts - Email Intake → Email Analysis: starts analysis
src/lib/submissions/email.ts - Website Intake → Submission Records: creates record
src/lib/submissions/website.ts - Website Intake → Website Analysis: starts analysis
src/lib/submissions/website.ts - Analysis Retry → Email Analysis: retries analysis
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
src/app/api/abuse/reports/route.ts - Abuse Report API → Reporter Metadata: captures metadata
src/app/api/abuse/reports/route.ts - Abuse Repository → Abuse Persistence: persists lifecycle
src/lib/abuse/repository.ts - Abuse Repository → Abuse Data Model: uses data model
src/lib/abuse/repository.ts - Abuse Repository → Route Contracts: exposes route input
src/lib/abuse/repository.ts - Abuse Worker → Abuse Repository: loads and settles work
src/lib/abuse/worker.ts - Abuse Worker → Target Resolver: resolves targets
src/lib/abuse/worker.ts - Abuse Worker → Provider Registry: dispatches submissions
src/lib/abuse/worker.ts - Target Resolver → Provider Routing: builds routes
- Provider Registry → Provider Execution: provides execution
src/lib/abuse/providers/index.ts - Abuse Worker → Dynamic Provider Forms: runs dynamic tasks
src/lib/abuse/worker.ts - Dynamic Provider Forms → Browser Fabric: uses browser sessions
- Abuse Worker → Abuse Mail: sends provider mail
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
src/app/api/artifacts/[id]/route.ts - Analysis Stream → Submission Records: streams status