How souryaneelpal/whistledrop works
WhistleDrop is a confidential reporting API: reporters submit without accounts, receive a one-time case code, and use it to check status and public updates; moderators authenticate, review reports, and advance their workflow. The graph follows the documented API entry points into controllers and services, with persistence, privacy checks, and on-read AI triage as supporting layers. Source excerpts do not show every route or startup detail; documented capabilities are retained, while uncertain connections are omitted.
Main entry points: moderator.routes.ts Moderator routes · report.routes.ts Report routes · report.service.ts Report operations · app.ts App setup
Components 21
API and access
- HTTP server
src/server.ts - App setup
src/app.ts - Report routes
src/routes/report.routes.ts - Moderator routes
src/routes/moderator.routes.ts - API docs
src/routes/docs.routes.ts - Request validation
src/middleware/validate.ts - Rate limits
src/middleware/rateLimit.ts - Error responses
src/middleware/errorHandler.ts
Anonymous reporting
- Report handling
src/controllers/report.controller.ts - Case codes
src/services/caseCode.service.ts - Report operations
src/services/report.service.ts
Moderator workflow
- Moderator auth
src/middleware/auth.ts - Moderator handling
src/controllers/moderator.controller.ts - Login and tokens
src/services/moderator.service.ts
Privacy and triage
- Identity leak check
src/services/leakCheck.service.ts - Category triage
src/services/triage.service.ts - Text embeddings
src/services/embedding.service.ts
Persistence and domain
- Status workflow
src/domain/statusWorkflow.ts - Application database
prisma/schema.prisma
Other components
- Reporter
- Moderator
Connections 24
- HTTP server → App setup: starts
src/server.ts - App setup → Report routes: mounts routes
src/app.ts - App setup → API docs: mounts docs
src/app.ts - Reporter → Report routes: submits and tracks
README.md - Moderator → Moderator routes: logs in and reviews
README.md - Report routes → Request validation: validates requests
src/routes/report.routes.ts - Report routes → Rate limits: limits requests
src/routes/report.routes.ts - Report routes → Report handling: dispatches
src/routes/report.routes.ts - Moderator routes → Request validation: validates requests
src/routes/moderator.routes.ts - Moderator routes → Rate limits: limits login
src/routes/moderator.routes.ts - Moderator routes → Moderator auth: guards routes
src/routes/moderator.routes.ts - Moderator routes → Moderator handling: dispatches
src/routes/moderator.routes.ts - Report handling → Report operations: creates and finds
src/controllers/report.controller.ts - Report handling → Identity leak check: checks text
src/controllers/report.controller.ts - Report operations → Case codes: generates and hashes
src/services/report.service.ts - Report operations → Application database: reads and writes
src/services/report.service.ts - Report operations → Status workflow: checks transitions
src/services/report.service.ts - Moderator handling → Login and tokens: authenticates
src/controllers/moderator.controller.ts - Moderator handling → Report operations: lists and updates
src/controllers/moderator.controller.ts - Moderator handling → Category triage: requests suggestions
src/controllers/moderator.controller.ts - Moderator auth → Login and tokens: verifies tokens
src/middleware/auth.ts - Login and tokens → Application database: reads moderators
src/services/moderator.service.ts - Category triage → Text embeddings: loads and embeds
src/services/triage.service.ts - App setup → Error responses: handles errors
src/app.ts