How eugene234466/zentrio-crm works
This is a CRM for managing customer relationships and business operations. Users enter through session-based authentication, then work across client/contact records, leads and pipeline stages, invoices and receipts, team settings, messaging, and reporting. The Flask application registers API routes backed by shared ORM models and permission checks; the React application provides the interface and client-side state. The sampled files show authentication wiring and several backend relationships; other route-to-UI connections are omitted where source evidence was unavailable.
Main entry points: app.py Flask application · models.py CRM data models · permissions.py Access control · auth.py Authentication
Components 26
Web application
- Application shell
frontend/src/App.tsx - Session state
frontend/src/hooks/useAuth.tsx - Auth API client
frontend/src/components/Login-register/authApi.ts - CRM state
frontend/src/hooks/useAppState.ts - Authentication UI
frontend/src/pages/AuthPage.tsx - Client workspace
frontend/src/pages/ClientsSection.tsx - Settings workspace
frontend/src/pages/SettingsSection.tsx - Team workspace
frontend/src/pages/TeamSection.tsx
CRM workflows
- Flask application
backend/app.py - Authentication
backend/routes/auth.py - Clients
backend/routes/clients.py - Contacts
backend/routes/contacts.py - Lead management
backend/routes/leads.py - Pipeline stages
backend/routes/pipeline.py - Invoices and receipts
backend/routes/invoices.py - Dashboard
backend/routes/dashboard.py - Message board
backend/routes/messages.py - Business settings
backend/routes/all_settings.py - Audit history
backend/routes/audit_log.py - Cross-record search
backend/search.py - Notifications
backend/notifications.py
Shared platform
- CRM data models
backend/models.py - Access control
backend/permissions.py - Audit writer
backend/audit.py - Shared extensions
backend/extensions.py
Other components
- CRM user
Connections 48
- CRM user → Application shell: uses
- Application shell → Session state: reads session
frontend/src/App.tsx - Application shell → CRM state: loads CRM state
frontend/src/App.tsx - Session state → Auth API client: calls
frontend/src/hooks/useAuth.tsx - Authentication UI → Session state: submits credentials
- Client workspace → CRM state: uses state
- Settings workspace → CRM state: uses state
- Team workspace → CRM state: uses state
- Auth API client → Authentication: requests auth
frontend/src/components/Login-register/authApi.ts - Flask application → Authentication: registers route
backend/app.py - Flask application → Clients: registers route
backend/app.py - Flask application → Contacts: registers route
backend/app.py - Flask application → Lead management: registers route
backend/app.py - Flask application → Pipeline stages: registers route
backend/app.py - Flask application → Invoices and receipts: registers route
backend/app.py - Flask application → Dashboard: registers route
backend/app.py - Flask application → Message board: registers route
backend/app.py - Flask application → Business settings: registers route
backend/app.py - Flask application → Audit history: registers route
backend/app.py - Flask application → Cross-record search: imports search
backend/app.py - Flask application → CRM data models: initializes schema
backend/app.py - Authentication → CRM data models: reads and writes
backend/routes/auth.py - Authentication → Access control: checks access
backend/routes/auth.py - Authentication → Audit writer: records events
backend/routes/auth.py - Clients → CRM data models: reads and writes
backend/routes/clients.py - Clients → Access control: checks access
backend/routes/clients.py - Clients → Audit writer: records events
backend/routes/clients.py - Contacts → CRM data models: uses records
backend/routes/contacts.py - Lead management → CRM data models: uses records
backend/routes/leads.py - Lead management → Access control: checks access
backend/routes/leads.py - Lead management → Audit writer: records events
backend/routes/leads.py - Pipeline stages → CRM data models: updates stages
backend/routes/pipeline.py - Pipeline stages → Access control: checks access
backend/routes/pipeline.py - Invoices and receipts → CRM data models: uses records
backend/routes/invoices.py - Invoices and receipts → Access control: checks access
backend/routes/invoices.py - Invoices and receipts → Audit writer: records events
backend/routes/invoices.py - Dashboard → CRM data models: queries records
backend/routes/dashboard.py - Dashboard → Access control: checks access
backend/routes/dashboard.py - Message board → CRM data models: uses records
backend/routes/messages.py - Message board → Access control: checks access
backend/routes/messages.py - Message board → Audit writer: records events
backend/routes/messages.py - Business settings → CRM data models: uses records
backend/routes/all_settings.py - Business settings → Access control: checks access
backend/routes/all_settings.py - Audit history → CRM data models: queries entries
backend/routes/audit_log.py - Audit history → Access control: checks access
backend/routes/audit_log.py - Cross-record search → CRM data models: searches records
backend/search.py - Cross-record search → Access control: filters results
backend/search.py - Notifications → CRM data models: uses records
backend/notifications.py