How octa-devs/octadevscrm works
OCTA DEVS CRM is an employee portal combining role-based access, CRM records, visitor and team chat, and website administration. The main workflow is an employee signing in, entering the dashboard, and using permission-guarded features whose API routes read or update Supabase-backed data. The graph preserves the README’s major product areas; several UI-to-API links and unsampled route behaviors are not shown because their wiring was not in the excerpts.
Main entry points: auth.ts Session and permissions · admin.ts Supabase admin client · chat/page.tsx Chat workspace · website/page.tsx Website admin
Components 24
Access and roles
- Sign in
app/login/page.tsx - Session endpoint
app/api/session/route.ts - Session and permissions
lib/auth.ts - Role management API
app/api/roles/route.ts
CRM workspace
- CRM records views
app/dashboard/crm - CRM resource UI
components/CrudResource.tsx - CRM entity API
app/api/crm/[entity]/route.ts
Chat
- Chat workspace
app/dashboard/chat/page.tsx - Visitor conversations API
app/api/chat/conversations/route.ts - Conversation thread API
app/api/chat/conversations/[id]/route.ts - Team chat API
app/api/chat/team/route.ts - Chat team directory
app/api/chat/team/members/route.ts
Administration
- Website admin
app/dashboard/website/page.tsx - Website projects API
app/api/website/projects/route.ts - Website team API
app/api/website/team/route.ts - Launch settings API
app/api/website/launch/route.ts - People management UI
app/dashboard/users/page.tsx - User management API
app/api/users/route.ts
Shared platform
- Dashboard shell
app/dashboard/layout.tsx - CRM storage helpers
lib/crm.ts - Supabase
- Supabase admin client
lib/supabase/admin.ts - Supabase browser client
lib/supabase/client.ts
Other components
- Employee
Connections 28
- Employee → Sign in: signs in
app/login/page.tsx - Sign in → Supabase browser client: authenticates with
app/login/page.tsx - Employee → Dashboard shell: uses portal
README.md - Dashboard shell → Session endpoint: loads identity
- Session endpoint → Session and permissions: verifies session
app/api/session/route.ts - Session and permissions → Supabase admin client: loads role permissions
lib/auth.ts - Role management API → Session and permissions: checks permissions
app/api/roles/route.ts - Role management API → Supabase admin client: manages roles
app/api/roles/route.ts - CRM records views → CRM resource UI: renders resources
app/dashboard/crm/leads/page.tsx - CRM resource UI → CRM entity API: requests records
- CRM entity API → Session and permissions: checks access
app/api/crm/[entity]/route.ts - CRM entity API → CRM storage helpers: reads and writes
app/api/crm/[entity]/route.ts - Employee → CRM records views: manages CRM
README.md - Chat workspace → Visitor conversations API: loads inbox
- Chat workspace → Conversation thread API: manages threads
- Chat workspace → Team chat API: sends team messages
- Team chat API → Session and permissions: checks permission
app/api/chat/team/route.ts - Team chat API → Supabase admin client: reads and writes
app/api/chat/team/route.ts - Employee → Chat workspace: uses chat
README.md - Website admin → Website projects API: manages projects
- Website admin → Website team API: manages team
- Website admin → Launch settings API: updates launch settings
- Employee → Website admin: administers website
README.md - People management UI → User management API: manages accounts
- User management API → Session and permissions: checks permission
app/api/users/route.ts - User management API → Supabase admin client: manages accounts
app/api/users/route.ts - Supabase admin client → Supabase: accesses backend
- Employee → People management UI: manages people
README.md