How woodysc8/media-list-builder works
Media List Builder is an internal application for maintaining a reporter directory and building client media lists from imported or manually entered coverage. Users enter through the browser UI; the server routes work to parsing, ingestion, persistence, reporting, Google Workspace synchronization/export, and optional reporter enrichment. The README documents the major workflows; some subsystem links below rely on its descriptions and the SOURCE INDEX rather than complete route excerpts.
Main entry points: server.ts Express API · enrichment.ts Reporter enrichment · app.js Builder UI · ingestion.ts Coverage ingestion
Components 18
User experience
- Builder UI
public/app.js - Express API
src/server.ts
Coverage workflow
- File parser
src/parser.ts - Coverage ingestion
src/ingestion.ts - Coverage resolution
src/coverage-resolvers.ts - Canonical taxonomy
public/canonical-beats.js - Coverage projections
src/report-projections.ts
Directory and enrichment
- Reporter directory
src/reporter-directory-source.ts - Reporter diagnostics
src/reporter-preflight.ts - Reporter enrichment
src/enrichment.ts - Article URL resolution
src/url-enrichment.ts
Storage and integrations
- Google Workspace
src/google.ts - Structured store
src/store.ts - Persistence adapter
src/persistent-files.ts - Vercel Blob
Other components
- Operator
- Google Drive and Sheets
- Search and AI providers
Connections 20
- Operator → Builder UI: uses
README.md - Builder UI → Express API: calls API
README.md - Express API → File parser: parses imports
src/server.ts - Express API → Coverage ingestion: ingests coverage
src/server.ts - Coverage ingestion → Coverage resolution: resolves fields
src/ingestion.ts - Coverage ingestion → Structured store: updates records
src/ingestion.ts - Express API → Structured store: loads and saves
src/server.ts - Express API → Coverage projections: builds reports
src/server.ts - Builder UI → Canonical taxonomy: filters by beats
- Express API → Reporter directory: loads directory
src/server.ts - Express API → Reporter diagnostics: runs diagnostics
src/server.ts - Express API → Reporter enrichment: manages proposals
src/server.ts - Reporter enrichment → Article URL resolution: resolves article URLs
src/enrichment.ts - Reporter enrichment → Persistence adapter: reads and writes state
src/enrichment.ts - Structured store → Persistence adapter: reads and writes
src/store.ts - Express API → Google Workspace: routes Workspace operations
src/server.ts - Google Workspace → Google Drive and Sheets: reads and updates
src/google.ts - Article URL resolution → Search and AI providers: searches candidates
- Reporter enrichment → Search and AI providers: researches reporters
- Persistence adapter → Vercel Blob: persists production state
README.md