How kkkkhazix/aihot works
AIHOT is a configurable AI news site: it collects industry sources, screens and independently scores items, writes localized summaries, clusters related coverage into events, ranks their heat, and publishes reports and feeds. The graph follows the documented workflow and sampled API/worker entry points; several backend stages are represented at their exact enclosing paths because their implementation was not sampled. It also preserves the documented admin, model leaderboard, Codex monitor, and Agent-facing interfaces.
Main entry points: db.ts PostgreSQL · main.ts Worker scheduler · content.ts Content jobs · group.ts Cluster and rank
Components 28
Collection
- Source adapters
packages/backend/src/sources/collect.ts - Push ingestion
packages/backend/src/ingest/items.ts - Ingest endpoint
apps/api/src/routes/ingest.ts - Collection jobs
packages/backend/src/jobs/sources.ts - Worker scheduler
apps/worker/src/main.ts
Editorial pipeline
- Content jobs
packages/backend/src/jobs/content.ts - Screen and score
packages/backend/src/editorial/analyze.ts - Translate and write
packages/backend/src/editorial/writing.ts - Language models
packages/backend/src/providers/llm.ts
Events and publishing
- Event jobs
packages/backend/src/jobs/events.ts - Cluster and rank
packages/backend/src/events/group.ts - Vector recall
packages/backend/src/providers/embeddings.ts - Publication jobs
packages/backend/src/jobs/publication.ts - Report composition
packages/backend/src/reports/compose.ts - Public content
packages/backend/src/publication/items.ts
Reader and Agent interfaces
- Website routes
apps/web/app/routes.ts - HTTP API
apps/api/src/app.ts - Agent exports
packages/backend/src/publication/llms.ts
Admin and extensions
- Admin operations
packages/backend/src/admin/content.ts - Model leaderboard
packages/backend/src/leaderboard/fetch/index.ts - Reset monitor
packages/backend/src/monitor/scan.ts
Other components
- PostgreSQL
packages/backend/src/db.ts - Configured sources
- Push clients
- LLM provider
- Embedding provider
- Readers
- Agents
Connections 30
- Worker scheduler → Collection jobs: registers
- Collection jobs → Source adapters: collects from
- Configured sources → Source adapters: provides items
- Push clients → Ingest endpoint: submits items
- Ingest endpoint → Push ingestion: calls
- Worker scheduler → Content jobs: registers
- Content jobs → Screen and score: processes items
- Screen and score → Language models: scores with
- Language models → LLM provider: requests
- Content jobs → Translate and write: processes selected
- Translate and write → Language models: generates with
- Worker scheduler → Event jobs: registers
- Event jobs → Cluster and rank: processes events
- Cluster and rank → Vector recall: recalls candidates
- Vector recall → Embedding provider: embeds text
- Worker scheduler → Publication jobs: registers
- Publication jobs → Report composition: composes reports
- Public content → PostgreSQL: reads content
- Cluster and rank → PostgreSQL: reads and writes
- Report composition → PostgreSQL: writes reports
- Website routes → Public content: serves pages
- HTTP API → Public content: serves endpoints
- Agent exports → PostgreSQL: checks availability
- HTTP API → Agent exports: serves discovery
- Readers → Website routes: browses
- Agents → HTTP API: requests data
- Agents → Agent exports: reads discovery
- Admin operations → PostgreSQL: manages content
- Model leaderboard → PostgreSQL: stores rankings
- Reset monitor → PostgreSQL: records observations