How venkatesh0214/knowaiedge works
knowAIedge is an educational AI publishing site with news, category-aware GitHub rankings, a YouTube watchlist, and an admin Model Radar. Visitors browse the site; editors can publish or refresh content through admin APIs or the stateless MCP editor, with ChatGPT identity and an owner allowlist guarding privileged operations. R2-backed news, activity, and reading history are visible in sampled routes; repository and model data modules provide ranking and radar operations. The README documents YouTube discovery and D1/R2 hosting, but their full runtime wiring is not sampled.
Main entry points: page.tsx Site experience · route.ts MCP editor · repository-data.ts Ranking data · admin-access.ts Admin access
Components 25
Site experience
- Site experience
app/page.tsx
Content features
- News browsing
app/explorer.tsx - Feed controls
app/feed-controls.tsx - Repository rankings
app/repositories.tsx - Ranking data
app/repository-data.ts - Ranking scores
app/repository-scoring.ts - AI watchlist
app/watchlist.tsx - Watchlist data
app/watchlist-data.ts - Model Radar
app/model-radar.tsx - Model data
app/model-data.ts - Activity and opens
app/api/activity/route.ts - Article opening
app/api/open/route.ts - Reading history
app/api/history/route.ts - News API
app/api/news/route.ts
Editor and identity
- MCP editor
app/mcp/route.ts - Model API
app/api/models/route.ts - Repository API
app/api/repositories/route.ts - Admin access
app/admin-access.ts - ChatGPT identity
app/chatgpt-auth.ts
Data and services
- Cloudflare R2
- GitHub API
- YouTube discovery
- Cloudflare hosting
Other components
- Visitor
- Site editor
Connections 35
- Visitor → Site experience: browses
app/page.tsx - Site experience → News browsing: renders
app/page.tsx - Site experience → Repository rankings: renders
app/page.tsx - Site experience → AI watchlist: renders
app/page.tsx - Site experience → Model Radar: renders
app/page.tsx - Site experience → News API: fetches
app/page.tsx - Site experience → Activity and opens: records activity
app/page.tsx - Site experience → Reading history: loads history
app/page.tsx - Site experience → Article opening: opens articles
app/page.tsx - Site experience → Feed controls: uses
app/page.tsx - Repository rankings → Feed controls: uses
app/repositories.tsx - Repository rankings → Ranking scores: uses
app/repositories.tsx - Ranking data → Ranking scores: ranks with
app/repository-data.ts - Repository API → Ranking data: serves
app/api/repositories/route.ts - Ranking data → GitHub API: queries
app/repository-data.ts - AI watchlist → Watchlist data: loads
- Watchlist data → YouTube discovery: discovers
- Model Radar → Model data: loads
app/model-radar.tsx - Model API → Model data: calls
app/api/models/route.ts - News API → Cloudflare R2: reads and writes
app/api/news/route.ts - Activity and opens → Cloudflare R2: records and lists
app/api/activity/route.ts - Article opening → Activity and opens: records opens
app/api/open/route.ts - Article opening → Cloudflare R2: reads history
app/api/open/route.ts - Reading history → Cloudflare R2: reads history
- Site editor → MCP editor: invokes tools
app/mcp/route.ts - MCP editor → Watchlist data: calls
app/mcp/route.ts - MCP editor → Model data: calls
app/mcp/route.ts - MCP editor → Ranking data: calls
app/mcp/route.ts - MCP editor → News API: calls
app/mcp/route.ts - MCP editor → Admin access: checks access
app/mcp/route.ts - Model API → Admin access: checks access
app/api/models/route.ts - Admin access → ChatGPT identity: gets identity
app/admin-access.ts - Admin access → Site editor: authorizes
app/admin-access.ts - Cloudflare hosting → Cloudflare R2: provides binding
- Cloudflare hosting → Cloudflare R2: stores content