Backend Overview (django-api)
Repo: git@gitlab.com:nova-hc/mwe/v2/django-api.git
Django REST Framework API that powers all business logic, data persistence, async tasks, and third-party integrations for NHC Portals.
Stack
| Layer | Technology |
|---|---|
| Language | Python 3.10+ |
| Framework | Django 4.2 + DRF 3.15 |
| Database | MySQL 8.0 |
| Cache / Broker | Redis 7.2 |
| Task queue | Celery 5.3 + django-celery-beat |
| Auth | dj-rest-auth + simplejwt |
| Schema | drf-spectacular (OpenAPI) |
| SendGrid (django-anymail) | |
| Storage | AWS S3 (django-storages + boto3) |
| WeasyPrint (render) + pyHanko (sign) | |
| Background checks | Clearchecks API |
App Modules
| App | Responsibility |
|---|---|
users | User model (all roles), registration, auth |
organizations | Multi-tenant org model, branding |
referrals | Intake / referral pipeline |
applications | Job application + background checks |
job_forms | Dynamic form assignments |
competency_tests | Skills assessments with PDF templates |
competency_checklists | Checklist-based assessments |
compliance_documents | Document tracking & status |
work_schedules | Employee scheduling |
notifications | In-app notifications |
messages | Internal messaging |
grievances | Employee grievance tracking |
audit_logs | Immutable change history |
notes | Attachable notes with files |
assessments | General assessment engine |
support | Help / support requests |