How shelcia/crm works
Tiny CRM is a role-based customer relationship management app: users sign in, enter the admin workspace, and manage customer and operational records through a React frontend backed by a Go REST API and MongoDB. Its major branches include contacts, support tickets, deals, projects, email campaigns, users, company settings, and dashboard reporting. The README documents the backend stack and scheduled SMTP delivery; sampled frontend excerpts show routing, dashboard data retrieval, and board updates. Most backend handlers and several frontend pages were not sampled, so those links are marked unverified.
Main entry points: Layout.tsx Admin Workspace · api.ts API Client · routes.tsx Routes & Access · main.go Go API Server
Components 22
Frontend
- React App
frontend/src/App.tsx - Routes & Access
frontend/src/routes.tsx - Sign-in & Account
frontend/src/pages/auth/login/index.tsx - Admin Workspace
frontend/src/layout/admin/Layout.tsx - API Client
frontend/src/services/api.ts
CRM Workflows
- Dashboard
frontend/src/pages/admin/dashboard/index.tsx - Contacts
frontend/src/pages/admin/contacts/index.tsx - Support Tickets
frontend/src/pages/admin/tickets/index.tsx - Deal Pipeline
frontend/src/pages/admin/pipeline/index.tsx - Project Boards
frontend/src/pages/admin/projects/index.tsx - Email Campaigns
frontend/src/pages/admin/emails/templates/index.tsx - User Administration
frontend/src/pages/admin/users/index.tsx - Company Profile
frontend/src/pages/admin/add-company/index.tsx
Backend Services
- Go API Server
backend/main.go - Authentication
backend/handlers/auth.go - Resource Handlers
backend/handlers - CRM Models
backend/models - MongoDB
Email Delivery
- Email Scheduler
backend/scheduler/email_scheduler.go - Gmail SMTP
- Email Templates
backend/templates
Other components
- CRM User
Connections 27
- CRM User → React App: uses
- React App → Routes & Access: renders routes
frontend/src/App.tsx - Routes & Access → Sign-in & Account: routes to
frontend/src/routes.tsx - Routes & Access → Admin Workspace: routes to
frontend/src/routes.tsx - Admin Workspace → Dashboard: hosts pages
- Admin Workspace → Contacts: hosts pages
- Admin Workspace → Support Tickets: hosts pages
- Admin Workspace → Deal Pipeline: hosts pages
- Admin Workspace → Project Boards: hosts pages
- Admin Workspace → Email Campaigns: hosts pages
- Admin Workspace → User Administration: hosts pages
- Admin Workspace → Company Profile: hosts pages
- Dashboard → API Client: requests stats
frontend/src/pages/admin/dashboard/index.tsx - Project Boards → API Client: requests board data
frontend/src/pages/admin/projects/index.tsx - Deal Pipeline → API Client: updates deals
- Contacts → API Client: manages records
- Support Tickets → API Client: manages tickets
- Email Campaigns → API Client: manages campaigns
- User Administration → API Client: manages users
- Company Profile → API Client: updates company
- API Client → Go API Server: calls REST API
- Go API Server → Authentication: routes auth
- Go API Server → Resource Handlers: routes requests
- Resource Handlers → CRM Models: uses models
- CRM Models → MongoDB: persists records
- Email Scheduler → Email Templates: uses templates
- Email Scheduler → Gmail SMTP: sends scheduled mail