How imluckyluke/luckyroom works
Chatroom is a Node.js backend for Persian-language group and direct messaging, with real-time synchronization and an administrative dashboard. Users register or sign in, then join rooms or converse privately; REST routes persist chat and account state, while Socket.IO handles live messaging and presence. Separate branches provide secure uploads, stickers, and administration, including RBAC, notifications, logs, and database backup/restore. The README documents capabilities beyond the sampled code; those are represented at subsystem level where the tree supports a path. Some route internals were not sampled, so their detailed call relationships are omitted.
Main entry points: server.js HTTP server · index.js SQLite database · auth.js Account routes · groups.js Group rooms
Components 21
HTTP Entry
- HTTP server
server.js
Accounts & Access
- Account routes
routes/auth.js - Token authentication
middleware/auth.js - Device sessions
helpers/sessions.js
Chat & Rooms
- Group rooms
routes/groups.js - Direct messages
routes/conversations.js
Realtime Events
- Live chat
sockets/index.js - Presence
sockets/presence.js - Socket emitter
sockets/emitter.js - Event bus
events/bus.js - Event listeners
events/listeners.js
Administration
- Admin APIs
routes/admin.js - Superadmin console API
routes/superadmin.js - RBAC permissions
helpers/permissions.js - Database backup
helpers/backup.js - Runtime settings
helpers/settings.js
Files & Stickers
- Upload endpoints
routes/uploads.js - Encrypted uploads
helpers/upload.js - Sticker import
helpers/stickerImport.js
Other components
- Chat user
- SQLite database
db/index.js
Connections 32
- Chat user → HTTP server: uses chat
- HTTP server → Account routes: mounts routes
server.js - HTTP server → Group rooms: mounts routes
server.js - HTTP server → Direct messages: mounts routes
server.js - HTTP server → Admin APIs: mounts routes
server.js - HTTP server → Superadmin console API: mounts routes
server.js - HTTP server → Upload endpoints: mounts routes
server.js - HTTP server → Live chat: starts sockets
server.js - HTTP server → Event listeners: registers listeners
server.js - Account routes → SQLite database: reads/writes
routes/auth.js - Account routes → Device sessions: issues sessions
routes/auth.js - Token authentication → Device sessions: checks sessions
middleware/auth.js - Account routes → Event bus: emits events
routes/auth.js - Group rooms → SQLite database: reads/writes
routes/groups.js - Group rooms → Event bus: emits events
routes/groups.js - Group rooms → Socket emitter: broadcasts updates
routes/groups.js - Direct messages → SQLite database: reads/writes
routes/conversations.js - Live chat → SQLite database: reads/writes
sockets/index.js - Live chat → Presence: tracks presence
sockets/index.js - Socket emitter → Live chat: broadcasts via
sockets/emitter.js - Event listeners → Event bus: subscribes to
events/listeners.js - Event listeners → SQLite database: logs events
events/listeners.js - Admin APIs → RBAC permissions: checks access
routes/admin.js - Admin APIs → Runtime settings: updates settings
routes/admin.js - Superadmin console API → RBAC permissions: checks access
routes/superadmin.js - Superadmin console API → Database backup: manages backups
routes/superadmin.js - Database backup → SQLite database: backs up
helpers/backup.js - Upload endpoints → Encrypted uploads: handles uploads
routes/uploads.js - Upload endpoints → SQLite database: records uploads
routes/uploads.js - Upload endpoints → Runtime settings: reads limits
routes/uploads.js - Sticker import → SQLite database: stores pack metadata
- Sticker import → Chat user: imports Telegram packs