How smkh4x/chatbit-app-full-stack works
ChatBit is a customer-support chat app: clients register or log in, create conversations, and exchange messages with support agents; agents can claim and close conversations. The mobile app restores JWT sessions, uses REST for account and conversation operations, and Socket.IO for live chat, typing, and presence. The backend separates routes, controllers, authentication/business logic, persistence, and realtime handling. Some mobile and backend capabilities are documented but their implementation files were not excerpted, so those subsystem links are shown as documented rather than inferred from unseen calls.
Main entry points: index.js Socket server · conversation.controller.js Conversation handlers · app.js Express API · chat.tsx Chat screen
Components 25
Mobile app
- App screens
mobile/src/app - Conversation home
mobile/src/app/(app)/home.tsx - Chat screen
mobile/src/app/(app)/chat.tsx - REST client
mobile/src/services/api.ts - Conversation queries
mobile/src/hooks/useConversation.ts - Message queries
mobile/src/hooks/useMessages.ts
Backend API
- Express API
backend/app.js - Conversation routes
backend/routes/conversation.routes.js - Conversation handlers
backend/controllers/conversation.controller.js - HTTP bootstrap
backend/server.js
Realtime chat
- Socket client
mobile/src/services/socket.ts - Socket server
backend/sockets/index.js
Identity
- Session store
mobile/src/store/auth.ts - Auth routes
backend/routes/auth.routes.js - User routes
backend/routes/user.routes.js - Auth handlers
backend/controllers/auth.controller.js - User handler
backend/controllers/user.controller.js - Auth service
backend/services/auth.service.js - JWT middleware
backend/middlewares/auth.middleware.js
Persistence
- PostgreSQL connection
backend/config/database.js - Users
backend/models/user.model.js - Conversations
backend/models/conversation.model.js - Messages
backend/models/message.model.js
Other components
- Client or agent
- PostgreSQL
Connections 36
- Client or agent → App screens: uses
- App screens → Session store: restores session
mobile/src/app/index.tsx - App screens → REST client: calls REST
mobile/src/app/(app)/home.tsx - Conversation home → Conversation queries: queries
mobile/src/app/(app)/home.tsx - Conversation queries → REST client: requests data
mobile/src/hooks/useConversation.ts - Chat screen → Message queries: loads history
mobile/src/app/(app)/chat.tsx - Message queries → REST client: requests history
mobile/src/hooks/useMessages.ts - Chat screen → Socket client: sends live events
mobile/src/app/(app)/chat.tsx - REST client → Express API: calls API
- Socket client → Socket server: connects
- Express API → Auth routes: mounts
backend/app.js - Express API → User routes: mounts
backend/app.js - Express API → Conversation routes: mounts
backend/app.js - Auth routes → Auth handlers: dispatches
backend/routes/auth.routes.js - Conversation routes → JWT middleware: authenticates
backend/routes/conversation.routes.js - Conversation routes → Conversation handlers: dispatches
backend/routes/conversation.routes.js - User routes → JWT middleware: authenticates
backend/routes/user.routes.js - User routes → User handler: dispatches
backend/routes/user.routes.js - Auth handlers → Auth service: delegates
backend/controllers/auth.controller.js - Auth service → Users: reads and creates
backend/services/auth.service.js - JWT middleware → Users: loads user
backend/middlewares/auth.middleware.js - JWT middleware → Session store: validates session
- Conversation handlers → Conversations: reads and updates
backend/controllers/conversation.controller.js - Conversation handlers → Messages: loads history
backend/controllers/conversation.controller.js - Socket server → Users: authenticates and tracks presence
backend/sockets/index.js - Socket server → Conversations: checks access and status
backend/sockets/index.js - Socket server → Messages: persists messages
backend/sockets/index.js - HTTP bootstrap → Express API: serves
backend/server.js - HTTP bootstrap → Socket server: creates
backend/server.js - PostgreSQL connection → PostgreSQL: connects
backend/config/database.js - Users → PostgreSQL connection: defines model on
backend/models/user.model.js - Conversations → PostgreSQL connection: defines model on
backend/models/conversation.model.js - Messages → PostgreSQL connection: defines model on
backend/models/message.model.js - Socket server → Chat screen: broadcasts messages, typing, presence
- Conversation handlers → Conversation home: serves create and list
- Conversation handlers → Chat screen: serves history and status actions