How extim-org/socia-media-assistant works
This repository combines an admin dashboard with a backend for configuring and monitoring a Meta messaging automation product. The principal external workflow is Meta delivering a webhook event to the backend, which delegates event handling to the webhook service; the tree also shows FSM session handling and Meta Graph API integration capabilities. Admin workflows cover login, bot/rule configuration, dashboard statistics and orders, and user management. UI-to-API wiring and the internals of unsampled services are not shown, so those links are omitted.
Main entry points: auth.service.ts Credential and token service · webhook.controller.ts Webhook endpoint · prisma.service.ts Prisma client · auth.controller.ts Authentication routes
Components 24
Admin interface
- Dashboard screens
frontend/src/app/dashboard/page.tsx - Bot settings
frontend/src/app/dashboard/bot-settings/page.tsx - Orders view
frontend/src/app/dashboard/orders/page.tsx - Users view
frontend/src/app/dashboard/users/page.tsx - Login screen
frontend/src/app/login/page.tsx
Admin API
- Authentication routes
backend/src/auth/auth.controller.ts - Credential and token service
backend/src/auth/auth.service.ts - Dashboard routes
backend/src/dashboard/dashboard.controller.ts - Dashboard data service
backend/src/dashboard/dashboard.service.ts - User routes
backend/src/users/users.controller.ts - User service
backend/src/users/users.service.ts - Bot config routes
backend/src/bot-config/bot-config.controller.ts - Bot config service
backend/src/bot-config/bot-config.service.ts
Messaging automation
- Webhook endpoint
backend/src/webhook/webhook.controller.ts - Event processor
backend/src/webhook/webhook.service.ts - Conversation FSM
backend/src/fsm/fsm.service.ts - Meta Graph client
backend/src/meta/meta.service.ts
Persistence and state
- Prisma client
backend/src/prisma/prisma.service.ts - Application database
- In-memory sessions
backend/src/fsm/fsm.service.ts
Other components
- Admin user
- Meta platform
- JWT service
- Meta Graph API
Connections 11
- Webhook endpoint → Event processor: processes events
- Meta platform → Webhook endpoint: delivers events
- Dashboard routes → Dashboard data service: requests dashboard data
- User routes → User service: manages users
- Bot config routes → Bot config service: manages configuration
- Authentication routes → Credential and token service: validates and logs in
- Credential and token service → Prisma client: reads admin
- Credential and token service → JWT service: signs token
- Prisma client → Application database: connects
- Conversation FSM → In-memory sessions: reads and writes
- Meta Graph client → Meta Graph API: sends requests