How honoured-1-byte/the_akashic_records works
The Akashic Records is a server-rendered social blogging platform. Readers browse ranked and recent posts, search or autocomplete, and open articles to view and comment; signed-in authors manage posts and profiles, while users can like, bookmark, and follow. A separate bot writer generates AI-authored posts and cover art and saves them to the same blog store. The README documents reading-time discovery, Markdown/XSS-safe rendering, and Cloudinary support, but their implementation paths were not sampled; those capabilities are represented only where the tree supports a subsystem path. Edges reflect excerpts or README statements; unsampled wiring is omitted.
Main entry points: app.js Express app · blog.js Blog routes · user.js User routes · bot_writer.js Bot writer
Components 20
Web application
- Express app
app.js - Server-rendered views
views - Browser assets
public
Content and social
- Blog routes
routes/blog.js - Blog records
models/blog.js - Comments
models/comments.js - IMGCDN upload
services/imgcdn.js
Identity
- User routes
routes/user.js - User records
models/user.js - Cookie auth
middlewares/authentication.js - JWT service
services/authentication.js
Discovery
- Autocomplete index
services/trie.js
AI publishing
- Bot writer
scripts/bot_writer.js
Other components
- Reader / author
- IMGCDN
- MongoDB
- Gemini generation
- Pollinations imagery
- Picsum fallback
- Cloudinary media
Connections 27
- Reader / author → Express app: sends requests
README.md - Express app → Cookie auth: checks cookies
app.js - Cookie auth → JWT service: validates token
middlewares/authentication.js - Express app → Blog routes: routes /blog
app.js - Express app → User routes: routes /user
app.js - Express app → Blog records: queries homepage
app.js - Express app → Autocomplete index: rebuilds and searches
app.js - Express app → Server-rendered views: renders pages
app.js - Express app → Browser assets: serves static files
app.js - Blog routes → Blog records: creates and queries
routes/blog.js - Blog routes → Comments: queries and creates
routes/blog.js - Blog routes → User records: loads acting user
routes/blog.js - Blog routes → Server-rendered views: renders post pages
routes/blog.js - User routes → User records: manages accounts
routes/user.js - User routes → Blog records: loads profile posts
routes/user.js - User routes → JWT service: issues signup token
routes/user.js - User routes → IMGCDN upload: uploads profile image
routes/user.js - User routes → Server-rendered views: renders account pages
routes/user.js - User records → JWT service: creates login token
models/user.js - IMGCDN upload → IMGCDN: uploads image
services/imgcdn.js - Bot writer → Blog records: saves generated post
scripts/bot_writer.js - Bot writer → Gemini generation: generates article
scripts/bot_writer.js - Bot writer → Pollinations imagery: requests cover art
scripts/bot_writer.js - Bot writer → Picsum fallback: uses fallback image
scripts/bot_writer.js - Blog routes → Cloudinary media: uploads cover image
README.md - Bot writer → MongoDB: connects for publishing
scripts/bot_writer.js - Express app → MongoDB: connects for application
app.js