# mani-pixel9165/opusappeal architecture

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

- Interactive diagram: https://gitdiagram.com/mani-pixel9165/opusappeal
- Repository: https://github.com/mani-pixel9165/opusappeal

## Overview

Opus Appeal Tracker Flow is a healthcare denial-management application for organization onboarding, authentication, denial processing, appeal preparation, and user administration. The principal workflow is an admin uploading denial data for preview and assignment; staff then manage denial actions and appeals, while dashboards and extraction logs support oversight. React routes and service clients provide the user-facing flow, and Flask blueprints delegate domain operations to services backed by PostgreSQL. The graph reflects documented routes and indexed module references; links between browser API calls and Flask endpoints are dashed because HTTP wiring was not directly shown.

Main entry points: [`backend/main/app.py`](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/app.py) (Flask application), [`frontend/src/routes/AppRoutes.jsx`](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/routes/AppRoutes.jsx) (Page routing), [`backend/main/modules/denials/service.py`](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/denials/service.py) (Denial processing), [`frontend/src/common/services/denialService.js`](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/services/denialService.js) (Denial API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_routes_ui["Page routing<br/>[AppRoutes.jsx]"]
  node_api_client["HTTP client<br/>[apiClient.js]"]
  node_app_factory["Flask application<br/>[app.py]"]
  node_response_errors["API responses and errors<br/>[errors.py]"]
end

subgraph group_identity["Identity and users"]
  node_auth_context["Session state<br/>[AuthContext.jsx]"]
  node_auth_storage["Browser auth storage<br/>[storage.js]"]
  node_auth_service["Auth API client<br/>[authService.js]"]
  node_user_pages["User administration"]
  node_user_routes["User endpoints<br/>[routes.py]"]
  node_user_service["User management<br/>[service.py]"]
end

subgraph group_denial_ops["Denial operations"]
  node_denial_pages["Denial work queues"]
  node_denial_client["Denial API client<br/>[denialService.js]"]
  node_denial_routes["Denial endpoints<br/>[routes.py]"]
  node_denial_service["Denial processing<br/>[service.py]"]
  node_denial_models[("Denial records<br/>[models.py]")]
  node_performance_page["Performance dashboard"]
  node_database[("PostgreSQL access<br/>[extensions.py]")]
end

subgraph group_appeals["Appeals"]
  node_appeal_page["Appeal package editor"]
  node_appeal_client["Appeal API client<br/>[appealService.js]"]
  node_appeal_routes["Appeal endpoints<br/>[routes.py]"]
  node_appeal_service["Appeal storage<br/>[service.py]"]
  node_appeal_models[("Appeal records<br/>[models.py]")]
end

subgraph group_reference_data["Code descriptions"]
  node_description_routes["Code description endpoints<br/>[routes.py]"]
  node_description_service["Code extraction and lookup<br/>[service.py]"]
  node_description_scheduler["Extraction scheduler<br/>[scheduler.py]"]
  node_description_logs["Extraction logs UI"]
end

node_staff(("Organization staff"))

node_staff -->|"uses"| node_routes_ui
node_routes_ui -->|"routes to"| node_denial_pages
node_routes_ui -->|"routes to"| node_appeal_page
node_routes_ui -->|"routes to"| node_performance_page
node_routes_ui -->|"routes to"| node_user_pages
node_auth_context -->|"calls"| node_auth_service
node_auth_context -->|"persists"| node_auth_storage
node_denial_pages -->|"requests"| node_denial_client
node_appeal_page -->|"requests"| node_appeal_client
node_appeal_page -->|"requests"| node_denial_client
node_performance_page -->|"requests"| node_denial_client
node_performance_page -->|"requests"| node_appeal_client
node_denial_client -->|"uses"| node_api_client
node_appeal_client -->|"uses"| node_api_client
node_denial_client -.->|"HTTP requests"| node_denial_routes
node_appeal_client -.->|"HTTP requests"| node_appeal_routes
node_auth_service -->|"uses"| node_api_client
node_user_pages -.->|"HTTP requests"| node_user_routes
node_denial_routes -->|"delegates"| node_denial_service
node_denial_service -->|"reads and writes"| node_denial_models
node_denial_service -->|"looks up codes"| node_description_service
node_appeal_routes -->|"delegates"| node_appeal_service
node_appeal_routes -->|"queries"| node_appeal_models
node_appeal_service -->|"reads and writes"| node_appeal_models
node_appeal_service -->|"uses denial operations"| node_denial_service
node_description_routes -->|"delegates"| node_description_service
node_description_scheduler -.->|"runs extraction"| node_description_service
node_description_logs -.->|"HTTP requests"| node_description_routes
node_user_routes -->|"delegates"| node_user_service
node_user_service -->|"uses"| node_database
node_denial_service -->|"uses"| node_database
node_description_service -->|"uses"| node_database
node_app_factory -->|"registers"| node_denial_routes
node_app_factory -->|"registers"| node_appeal_routes
node_app_factory -->|"registers"| node_description_routes
node_app_factory -->|"starts"| node_description_scheduler
node_app_factory -->|"registers handlers"| node_response_errors

click node_routes_ui "https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/routes/AppRoutes.jsx"
click node_auth_context "https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/context/AuthContext.jsx"
click node_auth_storage "https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/services/storage.js"
click node_auth_service "https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/services/authService.js"
click node_user_pages "https://github.com/mani-pixel9165/opusappeal/tree/master/frontend/src/modules/user_management/pages"
click node_user_routes "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/user_management/routes.py"
click node_user_service "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/user_management/service.py"
click node_denial_pages "https://github.com/mani-pixel9165/opusappeal/tree/master/frontend/src/modules/denials/pages"
click node_denial_client "https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/services/denialService.js"
click node_denial_routes "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/denials/routes.py"
click node_denial_service "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/denials/service.py"
click node_denial_models "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/denials/models.py"
click node_appeal_page "https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/modules/appeals/pages/AppealCreatePage.jsx"
click node_appeal_client "https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/services/appealService.js"
click node_appeal_routes "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/appeals/routes.py"
click node_appeal_service "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/appeals/service.py"
click node_appeal_models "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/appeals/models.py"
click node_performance_page "https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/modules/dashboards/pages/UserPerformancePage.jsx"
click node_description_routes "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/code_descriptions/routes.py"
click node_description_service "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/code_descriptions/service.py"
click node_description_scheduler "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/code_descriptions/scheduler.py"
click node_description_logs "https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/modules/user_management/pages/ExtractionLogsPage.jsx"
click node_api_client "https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/services/apiClient.js"
click node_app_factory "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/app.py"
click node_database "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/database/extensions.py"
click node_response_errors "https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/common/errors.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_routes_ui,node_api_client,node_app_factory,node_response_errors toneBlue
class node_auth_context,node_auth_storage,node_auth_service,node_user_pages,node_user_routes,node_user_service toneAmber
class node_denial_pages,node_denial_client,node_denial_routes,node_denial_service,node_denial_models,node_performance_page,node_database toneMint
class node_appeal_page,node_appeal_client,node_appeal_routes,node_appeal_service,node_appeal_models toneRose
class node_description_routes,node_description_service,node_description_scheduler,node_description_logs,node_staff toneIndigo
```

## Components

### Web application

- [Page routing](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/routes/AppRoutes.jsx): `frontend/src/routes/AppRoutes.jsx`
- [HTTP client](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/services/apiClient.js): `frontend/src/common/services/apiClient.js`
- [Flask application](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/app.py): `backend/main/app.py`
- [API responses and errors](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/common/errors.py): `backend/main/common/errors.py`

### Identity and users

- [Session state](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/context/AuthContext.jsx): `frontend/src/common/context/AuthContext.jsx`
- [Browser auth storage](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/services/storage.js): `frontend/src/common/services/storage.js`
- [Auth API client](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/services/authService.js): `frontend/src/common/services/authService.js`
- [User administration](https://github.com/mani-pixel9165/opusappeal/tree/master/frontend/src/modules/user_management/pages): `frontend/src/modules/user_management/pages`
- [User endpoints](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/user_management/routes.py): `backend/main/modules/user_management/routes.py`
- [User management](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/user_management/service.py): `backend/main/modules/user_management/service.py`

### Denial operations

- [Denial work queues](https://github.com/mani-pixel9165/opusappeal/tree/master/frontend/src/modules/denials/pages): `frontend/src/modules/denials/pages`
- [Denial API client](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/services/denialService.js): `frontend/src/common/services/denialService.js`
- [Denial endpoints](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/denials/routes.py): `backend/main/modules/denials/routes.py`
- [Denial processing](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/denials/service.py): `backend/main/modules/denials/service.py`
- [Denial records](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/denials/models.py): `backend/main/modules/denials/models.py`
- [Performance dashboard](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/modules/dashboards/pages/UserPerformancePage.jsx): `frontend/src/modules/dashboards/pages/UserPerformancePage.jsx`
- [PostgreSQL access](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/database/extensions.py): `backend/main/database/extensions.py`

### Appeals

- [Appeal package editor](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/modules/appeals/pages/AppealCreatePage.jsx): `frontend/src/modules/appeals/pages/AppealCreatePage.jsx`
- [Appeal API client](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/common/services/appealService.js): `frontend/src/common/services/appealService.js`
- [Appeal endpoints](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/appeals/routes.py): `backend/main/modules/appeals/routes.py`
- [Appeal storage](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/appeals/service.py): `backend/main/modules/appeals/service.py`
- [Appeal records](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/appeals/models.py): `backend/main/modules/appeals/models.py`

### Code descriptions

- [Code description endpoints](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/code_descriptions/routes.py): `backend/main/modules/code_descriptions/routes.py`
- [Code extraction and lookup](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/code_descriptions/service.py): `backend/main/modules/code_descriptions/service.py`
- [Extraction scheduler](https://github.com/mani-pixel9165/opusappeal/blob/master/backend/main/modules/code_descriptions/scheduler.py): `backend/main/modules/code_descriptions/scheduler.py`
- [Extraction logs UI](https://github.com/mani-pixel9165/opusappeal/blob/master/frontend/src/modules/user_management/pages/ExtractionLogsPage.jsx): `frontend/src/modules/user_management/pages/ExtractionLogsPage.jsx`

### Other components

- **Organization staff**

## Connections

- Organization staff → Page routing: uses (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Page routing → Denial work queues: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Page routing → Appeal package editor: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Page routing → Performance dashboard: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Page routing → User administration: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Session state → Auth API client: calls (evidence: `frontend/src/common/context/AuthContext.jsx`)
- Session state → Browser auth storage: persists (evidence: `frontend/src/common/context/AuthContext.jsx`)
- Denial work queues → Denial API client: requests (evidence: `frontend/src/modules/denials/pages/PendingDenialsPage.jsx`)
- Appeal package editor → Appeal API client: requests (evidence: `frontend/src/modules/appeals/pages/AppealCreatePage.jsx`)
- Appeal package editor → Denial API client: requests (evidence: `frontend/src/modules/appeals/pages/AppealCreatePage.jsx`)
- Performance dashboard → Denial API client: requests (evidence: `frontend/src/modules/dashboards/pages/UserPerformancePage.jsx`)
- Performance dashboard → Appeal API client: requests (evidence: `frontend/src/modules/dashboards/pages/UserPerformancePage.jsx`)
- Denial API client → HTTP client: uses (evidence: `frontend/src/common/services/denialService.js`)
- Appeal API client → HTTP client: uses (evidence: `frontend/src/common/services/appealService.js`)
- Denial API client → Denial endpoints: HTTP requests
- Appeal API client → Appeal endpoints: HTTP requests
- Auth API client → HTTP client: uses (evidence: `frontend/src/common/services/authService.js`)
- User administration → User endpoints: HTTP requests
- Denial endpoints → Denial processing: delegates (evidence: `backend/main/modules/denials/routes.py`)
- Denial processing → Denial records: reads and writes (evidence: `backend/main/modules/denials/service.py`)
- Denial processing → Code extraction and lookup: looks up codes (evidence: `backend/main/modules/denials/service.py`)
- Appeal endpoints → Appeal storage: delegates (evidence: `backend/main/modules/appeals/routes.py`)
- Appeal endpoints → Appeal records: queries (evidence: `backend/main/modules/appeals/routes.py`)
- Appeal storage → Appeal records: reads and writes (evidence: `backend/main/modules/appeals/service.py`)
- Appeal storage → Denial processing: uses denial operations (evidence: `backend/main/modules/appeals/service.py`)
- Code description endpoints → Code extraction and lookup: delegates (evidence: `backend/main/modules/code_descriptions/routes.py`)
- Extraction scheduler → Code extraction and lookup: runs extraction
- Extraction logs UI → Code description endpoints: HTTP requests
- User endpoints → User management: delegates (evidence: `backend/main/modules/user_management/routes.py`)
- User management → PostgreSQL access: uses (evidence: `backend/main/modules/user_management/service.py`)
- Denial processing → PostgreSQL access: uses (evidence: `backend/main/modules/denials/service.py`)
- Code extraction and lookup → PostgreSQL access: uses (evidence: `backend/main/modules/code_descriptions/service.py`)
- Flask application → Denial endpoints: registers (evidence: `backend/main/app.py`)
- Flask application → Appeal endpoints: registers (evidence: `backend/main/app.py`)
- Flask application → Code description endpoints: registers (evidence: `backend/main/app.py`)
- Flask application → Extraction scheduler: starts (evidence: `backend/main/app.py`)
- Flask application → API responses and errors: registers handlers (evidence: `backend/main/app.py`)
