# mahender-reddy85/repairnow architecture

> Architecture diagram of the GitHub repository mahender-reddy85/repairnow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mahender-reddy85/repairnow
- Repository: https://github.com/mahender-reddy85/repairnow

## Overview

RepairNow is a Django platform for customers to find local repair technicians and manage jobs through completion and review. The principal workflow is: a customer submits a request; the platform ranks eligible technicians; the customer selects one; the technician accepts and progresses the job; the customer reviews the completed work. Separate portals support technician profiles, availability, and job management, while admins verify technicians and manage platform activity. The graph reflects README capabilities and sampled source; unsampled views and routing details are not inferred.

Main entry points: [`repairnow/admin_views.py`](https://github.com/mahender-reddy85/repairnow/blob/main/repairnow/admin_views.py) (Admin Portal), [`repairs/views.py`](https://github.com/mahender-reddy85/repairnow/blob/main/repairs/views.py) (Customer Repair Portal), [`technicians/models.py`](https://github.com/mahender-reddy85/repairnow/blob/main/technicians/models.py) (Technician Profiles), [`notifications/models.py`](https://github.com/mahender-reddy85/repairnow/blob/main/notifications/models.py) (Notifications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts &amp; Roles"]
  node_account_views["Account Portal<br/>[views.py]"]
  node_account_forms["Account Forms<br/>[forms.py]"]
  node_account_models[("User Profiles<br/>[models.py]")]
  node_role_access["Role Access<br/>[decorators.py]"]
end

subgraph group_discovery["Services &amp; Matching"]
  node_service_catalog[("Service Catalog<br/>[models.py]")]
  node_technician_views["Technician Portal<br/>[views.py]"]
  node_technician_profiles[("Technician Profiles<br/>[models.py]")]
  node_matching["Technician Matching<br/>[matching.py]"]
end

subgraph group_jobs["Repair Lifecycle"]
  node_repair_views["Customer Repair Portal<br/>[views.py]"]
  node_repair_forms["Repair Request Form<br/>[forms.py]"]
  node_repair_records[("Requests &amp; Jobs<br/>[models.py]")]
end

subgraph group_engagement["Reviews &amp; Notifications"]
  node_reviews_portal["Review &amp; Complaint Portal<br/>[views.py]"]
  node_review_records[("Reviews &amp; Complaints<br/>[models.py]")]
  node_notifications_portal["Notification Portal<br/>[views.py]"]
  node_notification_records[("Notifications<br/>[models.py]")]
end

subgraph group_admin["Administration"]
  node_admin_portal["Admin Portal<br/>[admin_views.py]"]
end

node_customer(("Customer"))
node_technician_actor(("Technician"))
node_admin_actor(("Admin"))

node_customer -->|"registers or logs in"| node_account_views
node_customer -->|"requests repair"| node_repair_views
node_technician_actor -->|"manages jobs"| node_technician_views
node_admin_actor -->|"manages platform"| node_admin_portal
node_account_views -->|"uses"| node_account_forms
node_account_views -->|"creates"| node_notification_records
node_account_forms -->|"creates profiles"| node_account_models
node_account_forms -->|"creates profiles"| node_technician_profiles
node_account_forms -->|"selects skills"| node_service_catalog
node_repair_views -->|"validates requests"| node_repair_forms
node_repair_views -->|"creates and reads"| node_repair_records
node_repair_views -->|"requests ranking"| node_matching
node_matching -->|"stores matches"| node_repair_records
node_matching -->|"scores candidates"| node_technician_profiles
node_repair_views -->|"selects technician"| node_technician_profiles
node_repair_views -->|"sends updates"| node_notification_records
node_technician_views -->|"updates availability"| node_technician_profiles
node_technician_views -->|"manages jobs"| node_repair_records
node_technician_views -.->|"sends updates"| node_notification_records
node_reviews_portal -->|"creates reviews"| node_review_records
node_reviews_portal -->|"checks job"| node_repair_records
node_reviews_portal -->|"sends updates"| node_notification_records
node_review_records -->|"updates ratings"| node_technician_profiles
node_notifications_portal -->|"reads notifications"| node_notification_records
node_admin_portal -->|"checks role"| node_role_access
node_admin_portal -->|"manages users"| node_account_models
node_admin_portal -->|"verifies technicians"| node_technician_profiles
node_admin_portal -->|"manages categories"| node_service_catalog
node_admin_portal -->|"manages requests"| node_repair_records
node_admin_portal -->|"manages reviews"| node_review_records
node_admin_portal -->|"uses notifications"| node_notification_records

click node_account_views "https://github.com/mahender-reddy85/repairnow/blob/main/accounts/views.py"
click node_account_forms "https://github.com/mahender-reddy85/repairnow/blob/main/accounts/forms.py"
click node_account_models "https://github.com/mahender-reddy85/repairnow/blob/main/accounts/models.py"
click node_role_access "https://github.com/mahender-reddy85/repairnow/blob/main/accounts/decorators.py"
click node_service_catalog "https://github.com/mahender-reddy85/repairnow/blob/main/services/models.py"
click node_technician_views "https://github.com/mahender-reddy85/repairnow/blob/main/technicians/views.py"
click node_technician_profiles "https://github.com/mahender-reddy85/repairnow/blob/main/technicians/models.py"
click node_repair_views "https://github.com/mahender-reddy85/repairnow/blob/main/repairs/views.py"
click node_repair_forms "https://github.com/mahender-reddy85/repairnow/blob/main/repairs/forms.py"
click node_matching "https://github.com/mahender-reddy85/repairnow/blob/main/repairs/matching.py"
click node_repair_records "https://github.com/mahender-reddy85/repairnow/blob/main/repairs/models.py"
click node_reviews_portal "https://github.com/mahender-reddy85/repairnow/blob/main/reviews/views.py"
click node_review_records "https://github.com/mahender-reddy85/repairnow/blob/main/reviews/models.py"
click node_notifications_portal "https://github.com/mahender-reddy85/repairnow/blob/main/notifications/views.py"
click node_notification_records "https://github.com/mahender-reddy85/repairnow/blob/main/notifications/models.py"
click node_admin_portal "https://github.com/mahender-reddy85/repairnow/blob/main/repairnow/admin_views.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_account_views,node_account_forms,node_account_models,node_role_access toneBlue
class node_service_catalog,node_technician_views,node_technician_profiles,node_matching toneAmber
class node_repair_views,node_repair_forms,node_repair_records toneMint
class node_reviews_portal,node_review_records,node_notifications_portal,node_notification_records toneRose
class node_admin_portal,node_customer,node_technician_actor,node_admin_actor toneIndigo
```

## Components

### Accounts & Roles

- [Account Portal](https://github.com/mahender-reddy85/repairnow/blob/main/accounts/views.py): `accounts/views.py`
- [Account Forms](https://github.com/mahender-reddy85/repairnow/blob/main/accounts/forms.py): `accounts/forms.py`
- [User Profiles](https://github.com/mahender-reddy85/repairnow/blob/main/accounts/models.py): `accounts/models.py`
- [Role Access](https://github.com/mahender-reddy85/repairnow/blob/main/accounts/decorators.py): `accounts/decorators.py`

### Services & Matching

- [Service Catalog](https://github.com/mahender-reddy85/repairnow/blob/main/services/models.py): `services/models.py`
- [Technician Portal](https://github.com/mahender-reddy85/repairnow/blob/main/technicians/views.py): `technicians/views.py`
- [Technician Profiles](https://github.com/mahender-reddy85/repairnow/blob/main/technicians/models.py): `technicians/models.py`
- [Technician Matching](https://github.com/mahender-reddy85/repairnow/blob/main/repairs/matching.py): `repairs/matching.py`

### Repair Lifecycle

- [Customer Repair Portal](https://github.com/mahender-reddy85/repairnow/blob/main/repairs/views.py): `repairs/views.py`
- [Repair Request Form](https://github.com/mahender-reddy85/repairnow/blob/main/repairs/forms.py): `repairs/forms.py`
- [Requests & Jobs](https://github.com/mahender-reddy85/repairnow/blob/main/repairs/models.py): `repairs/models.py`

### Reviews & Notifications

- [Review & Complaint Portal](https://github.com/mahender-reddy85/repairnow/blob/main/reviews/views.py): `reviews/views.py`
- [Reviews & Complaints](https://github.com/mahender-reddy85/repairnow/blob/main/reviews/models.py): `reviews/models.py`
- [Notification Portal](https://github.com/mahender-reddy85/repairnow/blob/main/notifications/views.py): `notifications/views.py`
- [Notifications](https://github.com/mahender-reddy85/repairnow/blob/main/notifications/models.py): `notifications/models.py`

### Administration

- [Admin Portal](https://github.com/mahender-reddy85/repairnow/blob/main/repairnow/admin_views.py): `repairnow/admin_views.py`

### Other components

- **Customer**
- **Technician**
- **Admin**

## Connections

- Customer → Account Portal: registers or logs in
- Customer → Customer Repair Portal: requests repair
- Technician → Technician Portal: manages jobs
- Admin → Admin Portal: manages platform
- Account Portal → Account Forms: uses (evidence: `accounts/views.py`)
- Account Portal → Notifications: creates (evidence: `accounts/views.py`)
- Account Forms → User Profiles: creates profiles (evidence: `accounts/forms.py`)
- Account Forms → Technician Profiles: creates profiles (evidence: `accounts/forms.py`)
- Account Forms → Service Catalog: selects skills (evidence: `accounts/forms.py`)
- Customer Repair Portal → Repair Request Form: validates requests (evidence: `repairs/views.py`)
- Customer Repair Portal → Requests & Jobs: creates and reads (evidence: `repairs/views.py`)
- Customer Repair Portal → Technician Matching: requests ranking (evidence: `repairs/views.py`)
- Technician Matching → Requests & Jobs: stores matches (evidence: `repairs/matching.py`)
- Technician Matching → Technician Profiles: scores candidates (evidence: `repairs/matching.py`)
- Customer Repair Portal → Technician Profiles: selects technician (evidence: `repairs/views.py`)
- Customer Repair Portal → Notifications: sends updates (evidence: `repairs/views.py`)
- Technician Portal → Technician Profiles: updates availability (evidence: `technicians/views.py`)
- Technician Portal → Requests & Jobs: manages jobs (evidence: `technicians/views.py`)
- Technician Portal → Notifications: sends updates (evidence: `technicians/views.py`)
- Review & Complaint Portal → Reviews & Complaints: creates reviews (evidence: `reviews/views.py`)
- Review & Complaint Portal → Requests & Jobs: checks job (evidence: `reviews/views.py`)
- Review & Complaint Portal → Notifications: sends updates (evidence: `reviews/views.py`)
- Reviews & Complaints → Technician Profiles: updates ratings (evidence: `reviews/models.py`)
- Notification Portal → Notifications: reads notifications (evidence: `notifications/views.py`)
- Admin Portal → Role Access: checks role (evidence: `repairnow/admin_views.py`)
- Admin Portal → User Profiles: manages users (evidence: `repairnow/admin_views.py`)
- Admin Portal → Technician Profiles: verifies technicians (evidence: `repairnow/admin_views.py`)
- Admin Portal → Service Catalog: manages categories (evidence: `repairnow/admin_views.py`)
- Admin Portal → Requests & Jobs: manages requests (evidence: `repairnow/admin_views.py`)
- Admin Portal → Reviews & Complaints: manages reviews (evidence: `repairnow/admin_views.py`)
- Admin Portal → Notifications: uses notifications (evidence: `repairnow/admin_views.py`)
