# omverma1810/ironman architecture

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

- Interactive diagram: https://gitdiagram.com/omverma1810/ironman
- Repository: https://github.com/omverma1810/ironman

## Overview

IronMan is a doorstep clothes-pressing operations platform: customers book service, staff execute pickup and delivery, and operations manage custody, billing, inventory, and growth. The README frames weekly per-apartment, per-channel economics as the goal and describes customer, operations, and field surfaces. Although the README calls this an architecture plan, the tree and sampled sources contain substantial application code. Edges below follow explicit README claims or SOURCE INDEX references; unsampled modules are included where they represent major product capabilities, but their internal interactions are not inferred.

Main entry points: [`apps/api/ordering/services.py`](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/ordering/services.py) (Booking and orders), [`apps/api/billing/services.py`](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/billing/services.py) (Invoices and payments), [`apps/api/fulfilment/services.py`](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/fulfilment/services.py) (Route and job execution), [`apps/api/privacy/services.py`](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/privacy/services.py) (Privacy and retention)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_surfaces["Product surfaces"]
  node_web["Web app"]
  node_mobile["Customer mobile"]
  node_field["Field app"]
  node_field_offline["Offline field sync<br/>[engine.tsx]"]
end

subgraph group_orders["Order operations"]
  node_ordering[("Booking and orders<br/>[services.py]")]
  node_catalog[("Services and pricing<br/>[services.py]")]
  node_territory[("Territories and slots<br/>[services.py]")]
  node_fulfilment[("Route and job execution<br/>[services.py]")]
  node_custody[("Garment custody<br/>[services.py]")]
end

subgraph group_business["Business operations"]
  node_customers[("Customer records<br/>[models.py]")]
  node_billing[("Invoices and payments<br/>[services.py]")]
  node_supplies[("Inventory supplies<br/>[services.py]")]
  node_growth[("Referrals and commissions<br/>[commission.py]")]
  node_analytics["Reports and metrics<br/>[reports.py]"]
end

subgraph group_platform["Shared platform"]
  node_api["Django API<br/>[urls.py]"]
  node_identity[("Identity and access<br/>[models.py]")]
  node_common["Shared domain utilities<br/>[models.py]"]
  node_notifications[("Customer and staff messaging<br/>[services.py]")]
  node_privacy[("Privacy and retention<br/>[services.py]")]
end

node_customer(("Customer"))
node_staff(("Operations staff"))
node_rider(("Field rider"))

node_customer -->|"uses booking"| node_web
node_customer -->|"uses booking"| node_mobile
node_staff -->|"uses console"| node_web
node_rider -->|"uses field app"| node_field
node_field -->|"runs offline workflow"| node_field_offline
node_field_offline -->|"posts and fetches"| node_api
node_ordering -->|"requests quotes"| node_catalog
node_ordering -->|"books capacity"| node_territory
node_ordering -->|"updates on delivery"| node_customers
node_ordering -->|"uses referral services"| node_growth
node_ordering -->|"sends lifecycle events"| node_notifications
node_fulfilment -->|"updates order state"| node_ordering
node_fulfilment -->|"calls billing services"| node_billing
node_fulfilment -->|"calls custody services"| node_custody
node_fulfilment -->|"calls commission and referral logic"| node_growth
node_fulfilment -->|"pushes job alerts"| node_notifications
node_billing -->|"reads order data"| node_ordering
node_billing -->|"reads custody data"| node_custody
node_billing -->|"reads staff identity"| node_identity
node_billing -->|"reads territory data"| node_territory
node_billing -->|"reads fulfilment data"| node_fulfilment
node_billing -->|"uses money and errors"| node_common
node_growth -->|"records attribution"| node_customers
node_growth -->|"associates referrals"| node_ordering
node_notifications -->|"targets user devices"| node_identity
node_privacy -->|"uses billing records"| node_billing
node_privacy -->|"anonymizes customer data"| node_customers
node_privacy -->|"preserves order records"| node_ordering
node_privacy -->|"removes device data"| node_notifications
node_api -.->|"exposes order operations"| node_ordering
node_api -.->|"exposes billing operations"| node_billing
node_api -.->|"exposes reporting"| node_analytics

click node_web "https://github.com/omverma1810/ironman/tree/claude/iron-man-software-architecture-vpjwha/apps/web/app"
click node_mobile "https://github.com/omverma1810/ironman/tree/claude/iron-man-software-architecture-vpjwha/apps/mobile/app"
click node_field "https://github.com/omverma1810/ironman/tree/claude/iron-man-software-architecture-vpjwha/apps/field/app"
click node_field_offline "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/field/lib/offline/engine.tsx"
click node_api "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/config/urls.py"
click node_identity "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/identity/models.py"
click node_common "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/common/models.py"
click node_ordering "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/ordering/services.py"
click node_catalog "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/catalog/services.py"
click node_territory "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/territory/services.py"
click node_fulfilment "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/fulfilment/services.py"
click node_custody "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/custody/services.py"
click node_customers "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/customers/models.py"
click node_billing "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/billing/services.py"
click node_supplies "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/supplies/services.py"
click node_growth "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/growth/commission.py"
click node_analytics "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/analytics/reports.py"
click node_notifications "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/notifications/services.py"
click node_privacy "https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/privacy/services.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_web,node_mobile,node_field,node_field_offline toneBlue
class node_ordering,node_catalog,node_territory,node_fulfilment,node_custody toneAmber
class node_customers,node_billing,node_supplies,node_growth,node_analytics toneMint
class node_api,node_identity,node_common,node_notifications,node_privacy toneRose
class node_customer,node_staff,node_rider toneIndigo
```

## Components

### Product surfaces

- [Web app](https://github.com/omverma1810/ironman/tree/claude/iron-man-software-architecture-vpjwha/apps/web/app): `apps/web/app`
- [Customer mobile](https://github.com/omverma1810/ironman/tree/claude/iron-man-software-architecture-vpjwha/apps/mobile/app): `apps/mobile/app`
- [Field app](https://github.com/omverma1810/ironman/tree/claude/iron-man-software-architecture-vpjwha/apps/field/app): `apps/field/app`
- [Offline field sync](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/field/lib/offline/engine.tsx): `apps/field/lib/offline/engine.tsx`

### Order operations

- [Booking and orders](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/ordering/services.py): `apps/api/ordering/services.py`
- [Services and pricing](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/catalog/services.py): `apps/api/catalog/services.py`
- [Territories and slots](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/territory/services.py): `apps/api/territory/services.py`
- [Route and job execution](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/fulfilment/services.py): `apps/api/fulfilment/services.py`
- [Garment custody](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/custody/services.py): `apps/api/custody/services.py`

### Business operations

- [Customer records](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/customers/models.py): `apps/api/customers/models.py`
- [Invoices and payments](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/billing/services.py): `apps/api/billing/services.py`
- [Inventory supplies](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/supplies/services.py): `apps/api/supplies/services.py`
- [Referrals and commissions](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/growth/commission.py): `apps/api/growth/commission.py`
- [Reports and metrics](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/analytics/reports.py): `apps/api/analytics/reports.py`

### Shared platform

- [Django API](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/config/urls.py): `apps/api/config/urls.py`
- [Identity and access](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/identity/models.py): `apps/api/identity/models.py`
- [Shared domain utilities](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/common/models.py): `apps/api/common/models.py`
- [Customer and staff messaging](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/notifications/services.py): `apps/api/notifications/services.py`
- [Privacy and retention](https://github.com/omverma1810/ironman/blob/claude/iron-man-software-architecture-vpjwha/apps/api/privacy/services.py): `apps/api/privacy/services.py`

### Other components

- **Customer**
- **Operations staff**
- **Field rider**

## Connections

- Customer → Web app: uses booking
- Customer → Customer mobile: uses booking
- Operations staff → Web app: uses console
- Field rider → Field app: uses field app
- Field app → Offline field sync: runs offline workflow (evidence: `apps/field/lib/offline/engine.tsx`)
- Offline field sync → Django API: posts and fetches (evidence: `apps/field/lib/offline/engine.tsx`)
- Booking and orders → Services and pricing: requests quotes (evidence: `apps/api/ordering/services.py`)
- Booking and orders → Territories and slots: books capacity (evidence: `apps/api/ordering/services.py`)
- Booking and orders → Customer records: updates on delivery (evidence: `apps/api/customers/models.py`)
- Booking and orders → Referrals and commissions: uses referral services (evidence: `apps/api/ordering/services.py`)
- Booking and orders → Customer and staff messaging: sends lifecycle events (evidence: `apps/api/ordering/services.py`)
- Route and job execution → Booking and orders: updates order state (evidence: `apps/api/fulfilment/services.py`)
- Route and job execution → Invoices and payments: calls billing services (evidence: `apps/api/fulfilment/services.py`)
- Route and job execution → Garment custody: calls custody services (evidence: `apps/api/fulfilment/services.py`)
- Route and job execution → Referrals and commissions: calls commission and referral logic (evidence: `apps/api/fulfilment/services.py`)
- Route and job execution → Customer and staff messaging: pushes job alerts (evidence: `apps/api/fulfilment/services.py`)
- Invoices and payments → Booking and orders: reads order data (evidence: `apps/api/billing/services.py`)
- Invoices and payments → Garment custody: reads custody data (evidence: `apps/api/billing/services.py`)
- Invoices and payments → Identity and access: reads staff identity (evidence: `apps/api/billing/services.py`)
- Invoices and payments → Territories and slots: reads territory data (evidence: `apps/api/billing/services.py`)
- Invoices and payments → Route and job execution: reads fulfilment data (evidence: `apps/api/billing/services.py`)
- Invoices and payments → Shared domain utilities: uses money and errors
- Referrals and commissions → Customer records: records attribution
- Referrals and commissions → Booking and orders: associates referrals
- Customer and staff messaging → Identity and access: targets user devices (evidence: `apps/api/notifications/services.py`)
- Privacy and retention → Invoices and payments: uses billing records (evidence: `apps/api/privacy/services.py`)
- Privacy and retention → Customer records: anonymizes customer data (evidence: `apps/api/privacy/services.py`)
- Privacy and retention → Booking and orders: preserves order records (evidence: `apps/api/privacy/services.py`)
- Privacy and retention → Customer and staff messaging: removes device data (evidence: `apps/api/privacy/services.py`)
- Django API → Booking and orders: exposes order operations
- Django API → Invoices and payments: exposes billing operations
- Django API → Reports and metrics: exposes reporting
