# soju001/case-managerment architecture

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

- Interactive diagram: https://gitdiagram.com/soju001/case-managerment
- Repository: https://github.com/soju001/case-managerment

## Overview

CaseMgmt is a Django/MySQL case-management application that preserves an existing browser frontend through a Google Apps Script-compatible RPC bridge. The main workflow is a user signing in, making a domain request through the bridge, and receiving or changing case, project, or task data; separate capabilities cover calendar, master data, reporting, imports, administration, and notifications. The excerpts establish several API-to-security and persistence dependencies; other feature links are included only where the README documents them.

Main entry points: [`core/rpc.py`](https://github.com/soju001/case-managerment/blob/main/core/rpc.py) (RPC endpoint), [`core/security.py`](https://github.com/soju001/case-managerment/blob/main/core/security.py) (Session and audit), [`core/api/site_settings.py`](https://github.com/soju001/case-managerment/blob/main/core/api/site_settings.py) (Site settings), [`core/api/system.py`](https://github.com/soju001/case-managerment/blob/main/core/api/system.py) (System maintenance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser client"]
  node_frontend["Frontend bridge<br/>[gas-shim.js]"]
  node_page["Page serving<br/>[views.py]"]
end

subgraph group_api["Request and API"]
  node_rpc["RPC endpoint<br/>[rpc.py]"]
end

subgraph group_work["Casework capabilities"]
  node_auth["Authentication<br/>[auth.py]"]
  node_cases["Case management<br/>[cases.py]"]
  node_projects["Project management<br/>[projects.py]"]
  node_tasks["Task management<br/>[tasks.py]"]
  node_calendar["Calendar<br/>[calendar.py]"]
  node_lookups["Master data<br/>[lookups.py]"]
  node_reports["Dashboard and KPIs<br/>[dashboard.py]"]
  node_users["User administration<br/>[users.py]"]
end

subgraph group_platform["Identity and persistence"]
  node_security["Session and audit<br/>[security.py]"]
  node_roles["Roles and permissions<br/>[roles.py]"]
  node_models["Domain records<br/>[models.py]"]
  node_database[("MySQL tables")]
end

subgraph group_admin["Administration and integrations"]
  node_imports["Data import<br/>[data_import.py]"]
  node_importer["Import processing<br/>[importer.py]"]
  node_site["Site settings<br/>[site_settings.py]"]
  node_maintenance["System maintenance<br/>[system.py]"]
  node_notify["Notifications<br/>[notify.py]"]
end

node_user(("User"))

node_user -->|"uses"| node_frontend
node_frontend -->|"calls"| node_rpc
node_user -->|"opens"| node_page
node_page -->|"reads branding"| node_site
node_rpc -->|"dispatches"| node_auth
node_rpc -->|"dispatches"| node_cases
node_rpc -->|"dispatches"| node_projects
node_rpc -->|"dispatches"| node_tasks
node_rpc -->|"dispatches"| node_calendar
node_rpc -->|"dispatches"| node_lookups
node_rpc -->|"dispatches"| node_reports
node_rpc -->|"dispatches"| node_users
node_rpc -->|"dispatches"| node_imports
node_rpc -->|"dispatches"| node_site
node_rpc -->|"dispatches"| node_maintenance
node_auth -->|"uses sessions"| node_security
node_calendar -->|"checks access"| node_security
node_cases -->|"checks access"| node_security
node_tasks -->|"checks access"| node_security
node_site -->|"checks access"| node_security
node_maintenance -->|"checks access"| node_security
node_security -->|"resolves roles"| node_roles
node_security -->|"reads and writes"| node_database
node_cases -->|"reads and writes"| node_database
node_calendar -->|"reads and writes"| node_database
node_tasks -->|"reads and writes"| node_database
node_site -->|"reads and writes"| node_database
node_maintenance -->|"reads and writes"| node_database
node_importer -->|"imports records"| node_database
node_imports -->|"invokes"| node_importer
node_maintenance -->|"sends updates"| node_notify
node_notify -->|"stores notifications"| node_database
node_notify -->|"loads SMTP config"| node_site

click node_frontend "https://github.com/soju001/case-managerment/blob/main/core/static/core/gas-shim.js"
click node_page "https://github.com/soju001/case-managerment/blob/main/core/views.py"
click node_rpc "https://github.com/soju001/case-managerment/blob/main/core/rpc.py"
click node_auth "https://github.com/soju001/case-managerment/blob/main/core/api/auth.py"
click node_cases "https://github.com/soju001/case-managerment/blob/main/core/api/cases.py"
click node_projects "https://github.com/soju001/case-managerment/blob/main/core/api/projects.py"
click node_tasks "https://github.com/soju001/case-managerment/blob/main/core/api/tasks.py"
click node_calendar "https://github.com/soju001/case-managerment/blob/main/core/api/calendar.py"
click node_lookups "https://github.com/soju001/case-managerment/blob/main/core/api/lookups.py"
click node_reports "https://github.com/soju001/case-managerment/blob/main/core/api/dashboard.py"
click node_users "https://github.com/soju001/case-managerment/blob/main/core/api/users.py"
click node_imports "https://github.com/soju001/case-managerment/blob/main/core/api/data_import.py"
click node_importer "https://github.com/soju001/case-managerment/blob/main/core/importer.py"
click node_site "https://github.com/soju001/case-managerment/blob/main/core/api/site_settings.py"
click node_maintenance "https://github.com/soju001/case-managerment/blob/main/core/api/system.py"
click node_notify "https://github.com/soju001/case-managerment/blob/main/core/notify.py"
click node_security "https://github.com/soju001/case-managerment/blob/main/core/security.py"
click node_roles "https://github.com/soju001/case-managerment/blob/main/core/roles.py"
click node_models "https://github.com/soju001/case-managerment/blob/main/core/models.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_frontend,node_page,node_user toneBlue
class node_rpc toneAmber
class node_auth,node_cases,node_projects,node_tasks,node_calendar,node_lookups,node_reports,node_users toneMint
class node_security,node_roles,node_models,node_database toneRose
class node_imports,node_importer,node_site,node_maintenance,node_notify toneIndigo
```

## Components

### Browser client

- [Frontend bridge](https://github.com/soju001/case-managerment/blob/main/core/static/core/gas-shim.js): `core/static/core/gas-shim.js`
- [Page serving](https://github.com/soju001/case-managerment/blob/main/core/views.py): `core/views.py`

### Request and API

- [RPC endpoint](https://github.com/soju001/case-managerment/blob/main/core/rpc.py): `core/rpc.py`

### Casework capabilities

- [Authentication](https://github.com/soju001/case-managerment/blob/main/core/api/auth.py): `core/api/auth.py`
- [Case management](https://github.com/soju001/case-managerment/blob/main/core/api/cases.py): `core/api/cases.py`
- [Project management](https://github.com/soju001/case-managerment/blob/main/core/api/projects.py): `core/api/projects.py`
- [Task management](https://github.com/soju001/case-managerment/blob/main/core/api/tasks.py): `core/api/tasks.py`
- [Calendar](https://github.com/soju001/case-managerment/blob/main/core/api/calendar.py): `core/api/calendar.py`
- [Master data](https://github.com/soju001/case-managerment/blob/main/core/api/lookups.py): `core/api/lookups.py`
- [Dashboard and KPIs](https://github.com/soju001/case-managerment/blob/main/core/api/dashboard.py): `core/api/dashboard.py`
- [User administration](https://github.com/soju001/case-managerment/blob/main/core/api/users.py): `core/api/users.py`

### Identity and persistence

- [Session and audit](https://github.com/soju001/case-managerment/blob/main/core/security.py): `core/security.py`
- [Roles and permissions](https://github.com/soju001/case-managerment/blob/main/core/roles.py): `core/roles.py`
- [Domain records](https://github.com/soju001/case-managerment/blob/main/core/models.py): `core/models.py`
- **MySQL tables**

### Administration and integrations

- [Data import](https://github.com/soju001/case-managerment/blob/main/core/api/data_import.py): `core/api/data_import.py`
- [Import processing](https://github.com/soju001/case-managerment/blob/main/core/importer.py): `core/importer.py`
- [Site settings](https://github.com/soju001/case-managerment/blob/main/core/api/site_settings.py): `core/api/site_settings.py`
- [System maintenance](https://github.com/soju001/case-managerment/blob/main/core/api/system.py): `core/api/system.py`
- [Notifications](https://github.com/soju001/case-managerment/blob/main/core/notify.py): `core/notify.py`

### Other components

- **User**

## Connections

- User → Frontend bridge: uses (evidence: `README.md`)
- Frontend bridge → RPC endpoint: calls (evidence: `README.md`)
- User → Page serving: opens (evidence: `README.md`)
- Page serving → Site settings: reads branding (evidence: `core/views.py`)
- RPC endpoint → Authentication: dispatches (evidence: `README.md`)
- RPC endpoint → Case management: dispatches (evidence: `README.md`)
- RPC endpoint → Project management: dispatches (evidence: `README.md`)
- RPC endpoint → Task management: dispatches (evidence: `README.md`)
- RPC endpoint → Calendar: dispatches (evidence: `README.md`)
- RPC endpoint → Master data: dispatches (evidence: `README.md`)
- RPC endpoint → Dashboard and KPIs: dispatches (evidence: `README.md`)
- RPC endpoint → User administration: dispatches (evidence: `README.md`)
- RPC endpoint → Data import: dispatches (evidence: `README.md`)
- RPC endpoint → Site settings: dispatches (evidence: `README.md`)
- RPC endpoint → System maintenance: dispatches (evidence: `README.md`)
- Authentication → Session and audit: uses sessions (evidence: `core/api/auth.py`)
- Calendar → Session and audit: checks access (evidence: `core/api/calendar.py`)
- Case management → Session and audit: checks access (evidence: `core/api/cases.py`)
- Task management → Session and audit: checks access (evidence: `core/api/tasks.py`)
- Site settings → Session and audit: checks access (evidence: `core/api/site_settings.py`)
- System maintenance → Session and audit: checks access (evidence: `core/api/system.py`)
- Session and audit → Roles and permissions: resolves roles (evidence: `core/security.py`)
- Session and audit → MySQL tables: reads and writes (evidence: `core/security.py`)
- Case management → MySQL tables: reads and writes (evidence: `core/api/cases.py`)
- Calendar → MySQL tables: reads and writes (evidence: `core/api/calendar.py`)
- Task management → MySQL tables: reads and writes (evidence: `core/api/tasks.py`)
- Site settings → MySQL tables: reads and writes (evidence: `core/api/site_settings.py`)
- System maintenance → MySQL tables: reads and writes (evidence: `core/api/system.py`)
- Import processing → MySQL tables: imports records (evidence: `core/importer.py`)
- Data import → Import processing: invokes
- System maintenance → Notifications: sends updates (evidence: `core/api/system.py`)
- Notifications → MySQL tables: stores notifications (evidence: `core/notify.py`)
- Notifications → Site settings: loads SMTP config (evidence: `core/notify.py`)
