How qf-mj/crm-al-mohtaref works
Al-Muhtaref CRM is a web CRM for coordinating customer records and departmental work. Staff enter through the client, navigate feature routes, and use implemented contacts and user-management screens; the server exposes API controllers that dispatch application requests, with repositories backed by the shared database context. The README also describes lifecycle, campaigns, issues, reminders, reporting, WhatsApp, and Sheets capabilities, but this tree and the sampled source do not establish their runtime wiring. Those documented areas are shown as distinct subsystems without asserted implementation flows.
Main entry points: Contacts Customer records · AppDbContext.cs CRM data context · index.tsx Route map · Campaigns Campaign lifecycle
Components 26
Staff client
- Web client
src/Client/src/app/App.tsx - Route map
src/Client/src/app/router/index.tsx - User management
src/Client/src/features/users/pages - Contact directory
src/Client/src/features/clients/pages/ContactsPage.tsx - Sign-in
src/Client/src/features/auth - Campaign workspace
src/Client/src/features/campaigns - Issue tracking
src/Client/src/features/issues - Follow-up tasks
src/Client/src/features/tasks - Communications
src/Client/src/features/communications - Notifications
src/Client/src/features/notifications - Academic guidance
src/Client/src/features/academic
API boundary
- User endpoints
src/Server/CRM.AlMohtaref.Api/Controllers/UsersController.cs - Authentication endpoint
src/Server/CRM.AlMohtaref.Api/Controllers/AuthController.cs - Contact endpoints
src/Server/CRM.AlMohtaref.Api/Controllers/ContactsController.cs - Campaign endpoints
src/Server/CRM.AlMohtaref.Api/Controllers/CampaignsController.cs
Application logic
- User handlers
src/Server/CRM.AlMohtaref.Application/Features/Users - Contact search
src/Server/CRM.AlMohtaref.Application/Features/Contacts/GetContacts/GetContactsQueryHandler.cs - Lookup queries
src/Server/CRM.AlMohtaref.Application/Features/Lookups/GetLookupsQueryHandler.cs
Persistence
- User repository
src/Server/CRM.AlMohtaref.Infrastructure/Repositories/UserRepository.cs - CRM data context
src/Server/CRM.AlMohtaref.Infrastructure/Data/AppDbContext.cs
CRM capabilities
- Customer records
src/Server/CRM.AlMohtaref.Domain/Entities/Contacts - Campaign lifecycle
src/Server/CRM.AlMohtaref.Domain/Entities/Campaigns - Question configuration
src/Server/CRM.AlMohtaref.Domain/Entities/Questions - WhatsApp and Sheets
Other components
- CRM staff
- WhatsApp / Google Sheets
Connections 21
- CRM staff → Web client: uses
README.md - Web client → Route map: loads routes
src/Client/src/app/App.tsx - Route map → User management: routes users
- Route map → Contact directory: routes contacts
- User endpoints → User handlers: dispatches requests
src/Server/CRM.AlMohtaref.Api/Controllers/UsersController.cs - Authentication endpoint → Sign-in: serves sign-in
- Contact endpoints → Contact search: handles search
- Campaign endpoints → Campaign lifecycle: manages campaigns
- User handlers → User repository: searches users
src/Server/CRM.AlMohtaref.Application/Features/Users/GetUsers/GetUsersQueryHandler.cs - Contact search → Customer records: queries contacts
- Lookup queries → Customer records: loads lookup data
- User repository → CRM data context: queries and updates
src/Server/CRM.AlMohtaref.Infrastructure/Repositories/UserRepository.cs - CRM data context → Customer records: stores CRM entities
src/Server/CRM.AlMohtaref.Infrastructure/Data/AppDbContext.cs - CRM data context → Campaign lifecycle: stores entities
src/Server/CRM.AlMohtaref.Infrastructure/Data/AppDbContext.cs - CRM data context → Question configuration: stores entities
src/Server/CRM.AlMohtaref.Infrastructure/Data/AppDbContext.cs - Follow-up tasks → Notifications: follow-up alerts
README.md - Communications → WhatsApp and Sheets: logs conversations
README.md - WhatsApp and Sheets → WhatsApp / Google Sheets: integrates with
README.md - Issue tracking → Customer records: links customer issues
README.md - Campaign workspace → Campaign lifecycle: tracks effectiveness
README.md - Academic guidance → Customer records: supports guidance
README.md