How mani-pixel9165/opusappeal works
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: app.py Flask application · AppRoutes.jsx Page routing · service.py Denial processing · denialService.js Denial API client
Components 27
Web application
- Page routing
frontend/src/routes/AppRoutes.jsx - HTTP client
frontend/src/common/services/apiClient.js - Flask application
backend/main/app.py - API responses and errors
backend/main/common/errors.py
Identity and users
- Session state
frontend/src/common/context/AuthContext.jsx - Browser auth storage
frontend/src/common/services/storage.js - Auth API client
frontend/src/common/services/authService.js - User administration
frontend/src/modules/user_management/pages - User endpoints
backend/main/modules/user_management/routes.py - User management
backend/main/modules/user_management/service.py
Denial operations
- Denial work queues
frontend/src/modules/denials/pages - Denial API client
frontend/src/common/services/denialService.js - Denial endpoints
backend/main/modules/denials/routes.py - Denial processing
backend/main/modules/denials/service.py - Denial records
backend/main/modules/denials/models.py - Performance dashboard
frontend/src/modules/dashboards/pages/UserPerformancePage.jsx - PostgreSQL access
backend/main/database/extensions.py
Appeals
- Appeal package editor
frontend/src/modules/appeals/pages/AppealCreatePage.jsx - Appeal API client
frontend/src/common/services/appealService.js - Appeal endpoints
backend/main/modules/appeals/routes.py - Appeal storage
backend/main/modules/appeals/service.py - Appeal records
backend/main/modules/appeals/models.py
Code descriptions
- Code description endpoints
backend/main/modules/code_descriptions/routes.py - Code extraction and lookup
backend/main/modules/code_descriptions/service.py - Extraction scheduler
backend/main/modules/code_descriptions/scheduler.py - Extraction logs UI
frontend/src/modules/user_management/pages/ExtractionLogsPage.jsx
Other components
- Organization staff
Connections 37
- Organization staff → Page routing: uses
frontend/src/routes/AppRoutes.jsx - Page routing → Denial work queues: routes to
frontend/src/routes/AppRoutes.jsx - Page routing → Appeal package editor: routes to
frontend/src/routes/AppRoutes.jsx - Page routing → Performance dashboard: routes to
frontend/src/routes/AppRoutes.jsx - Page routing → User administration: routes to
frontend/src/routes/AppRoutes.jsx - Session state → Auth API client: calls
frontend/src/common/context/AuthContext.jsx - Session state → Browser auth storage: persists
frontend/src/common/context/AuthContext.jsx - Denial work queues → Denial API client: requests
frontend/src/modules/denials/pages/PendingDenialsPage.jsx - Appeal package editor → Appeal API client: requests
frontend/src/modules/appeals/pages/AppealCreatePage.jsx - Appeal package editor → Denial API client: requests
frontend/src/modules/appeals/pages/AppealCreatePage.jsx - Performance dashboard → Denial API client: requests
frontend/src/modules/dashboards/pages/UserPerformancePage.jsx - Performance dashboard → Appeal API client: requests
frontend/src/modules/dashboards/pages/UserPerformancePage.jsx - Denial API client → HTTP client: uses
frontend/src/common/services/denialService.js - Appeal API client → HTTP client: uses
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
frontend/src/common/services/authService.js - User administration → User endpoints: HTTP requests
- Denial endpoints → Denial processing: delegates
backend/main/modules/denials/routes.py - Denial processing → Denial records: reads and writes
backend/main/modules/denials/service.py - Denial processing → Code extraction and lookup: looks up codes
backend/main/modules/denials/service.py - Appeal endpoints → Appeal storage: delegates
backend/main/modules/appeals/routes.py - Appeal endpoints → Appeal records: queries
backend/main/modules/appeals/routes.py - Appeal storage → Appeal records: reads and writes
backend/main/modules/appeals/service.py - Appeal storage → Denial processing: uses denial operations
backend/main/modules/appeals/service.py - Code description endpoints → Code extraction and lookup: delegates
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
backend/main/modules/user_management/routes.py - User management → PostgreSQL access: uses
backend/main/modules/user_management/service.py - Denial processing → PostgreSQL access: uses
backend/main/modules/denials/service.py - Code extraction and lookup → PostgreSQL access: uses
backend/main/modules/code_descriptions/service.py - Flask application → Denial endpoints: registers
backend/main/app.py - Flask application → Appeal endpoints: registers
backend/main/app.py - Flask application → Code description endpoints: registers
backend/main/app.py - Flask application → Extraction scheduler: starts
backend/main/app.py - Flask application → API responses and errors: registers handlers
backend/main/app.py