# kashish-jain-kj/easley-dunn architecture

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

- Interactive diagram: https://gitdiagram.com/kashish-jain-kj/easley-dunn
- Repository: https://github.com/kashish-jain-kj/easley-dunn

## Overview

Cerberus is an access-governance platform for user lifecycle management across external services. Operators authenticate, select a user, and request onboarding or offboarding; the backend routes protected requests to provider integrations that update external permissions and record outcomes. The dashboard also supports role management and activity-log review. The README documents nine provider integrations, while sampled source confirms several integration details; other provider internals are represented at their listed controller paths without assuming their implementation.

Main entry points: [`frontend/src/App.js`](https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/App.js) (Dashboard), [`backend/src/routes/index.routes.js`](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/routes/index.routes.js) (Feature router), [`backend/src/routes`](https://github.com/kashish-jain-kj/easley-dunn/tree/main/backend/src/routes) (Provider routes), [`backend/src/controllers/discord.controller.js`](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/discord.controller.js) (Discord access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Operator dashboard"]
  node_dashboard["Dashboard<br/>[App.js]"]
  node_auth_ui["Session context<br/>[AuthContext.js]"]
  node_request_helper["Authenticated fetch<br/>[fetchWithAuth.js]"]
  node_user_views["User views<br/>[UserList.js]"]
  node_role_ui["Role management"]
  node_audit_ui["Activity logs"]
end

subgraph group_api["API and identity"]
  node_express_app["HTTP application<br/>[app.js]"]
  node_api_router["Feature router<br/>[index.routes.js]"]
  node_auth_routes["Authentication routes<br/>[auth.routes.js]"]
  node_auth_middleware["Authentication guard"]
end

subgraph group_governance["Access governance"]
  node_users_roles["Users and roles"]
  node_admin["Administration"]
  node_service_catalog["Service catalog"]
end

subgraph group_integrations["Provider integrations"]
  node_provider_routes["Provider routes"]
  node_bigquery["BigQuery access"]
  node_discord["Discord access"]
  node_apple["App Store Connect"]
  node_other_providers["Other providers"]
end

subgraph group_state["Persistence and audit"]
  node_postgres[("PostgreSQL<br/>[database.js]")]
  node_audit["Activity audit<br/>[logUtils.js]"]
  node_mail["Email delivery<br/>[mail.js]"]
end

node_operator(("Operator"))
node_external_services{{"External services"}}

node_operator -->|"uses"| node_dashboard
node_dashboard -->|"checks session"| node_auth_ui
node_dashboard -->|"sends requests"| node_request_helper
node_dashboard -->|"renders"| node_user_views
node_dashboard -->|"renders"| node_role_ui
node_dashboard -->|"renders"| node_audit_ui
node_dashboard -->|"calls API"| node_express_app
node_auth_ui -->|"calls auth API"| node_auth_routes
node_express_app -->|"mounts"| node_api_router
node_api_router -->|"mounts"| node_auth_routes
node_api_router -->|"guards routes"| node_auth_middleware
node_api_router -->|"mounts"| node_provider_routes
node_api_router -->|"routes roles"| node_users_roles
node_api_router -->|"routes admin"| node_admin
node_api_router -->|"routes services"| node_service_catalog
node_provider_routes -->|"dispatches"| node_bigquery
node_provider_routes -->|"dispatches"| node_discord
node_provider_routes -->|"dispatches"| node_apple
node_provider_routes -.->|"dispatches"| node_other_providers
node_bigquery -->|"reads and writes"| node_postgres
node_bigquery -->|"records outcomes"| node_audit
node_discord -->|"reads and writes"| node_postgres
node_discord -->|"records outcomes"| node_audit
node_discord -->|"sends invites"| node_mail
node_apple -->|"uses access records"| node_postgres
node_apple -->|"records operations"| node_audit
node_bigquery -->|"manages permissions"| node_external_services
node_discord -->|"manages membership"| node_external_services
node_apple -->|"provisions access"| node_external_services
node_other_providers -->|"integrates services"| node_external_services
node_audit -->|"persists logs"| node_postgres

click node_dashboard "https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/App.js"
click node_auth_ui "https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/context/AuthContext.js"
click node_request_helper "https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/utils/fetchWithAuth.js"
click node_user_views "https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/components/UserList.js"
click node_role_ui "https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/components/RoleManagementCard.js"
click node_audit_ui "https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/components/ActivityLogsCard.js"
click node_express_app "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/app.js"
click node_api_router "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/routes/index.routes.js"
click node_auth_routes "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/routes/auth.routes.js"
click node_auth_middleware "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/middlewares/requireAuth.middleware.js"
click node_users_roles "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/roles.controller.js"
click node_admin "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/admin.controller.js"
click node_service_catalog "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/services.controller.js"
click node_provider_routes "https://github.com/kashish-jain-kj/easley-dunn/tree/main/backend/src/routes"
click node_bigquery "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/bigQuery.controller.js"
click node_discord "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/discord.controller.js"
click node_apple "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/appleStoreConnect.controller.js"
click node_other_providers "https://github.com/kashish-jain-kj/easley-dunn/tree/main/backend/src/controllers"
click node_postgres "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/db/database.js"
click node_audit "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/utils/logUtils.js"
click node_mail "https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/utils/mail.js"

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_dashboard,node_auth_ui,node_request_helper,node_user_views,node_role_ui,node_audit_ui toneBlue
class node_express_app,node_api_router,node_auth_routes,node_auth_middleware toneAmber
class node_users_roles,node_admin,node_service_catalog toneMint
class node_provider_routes,node_bigquery,node_discord,node_apple,node_other_providers toneRose
class node_postgres,node_audit,node_mail,node_operator,node_external_services toneIndigo
```

## Components

### Operator dashboard

- [Dashboard](https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Session context](https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/context/AuthContext.js): `frontend/src/context/AuthContext.js`
- [Authenticated fetch](https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/utils/fetchWithAuth.js): `frontend/src/utils/fetchWithAuth.js`
- [User views](https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/components/UserList.js): `frontend/src/components/UserList.js`
- [Role management](https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/components/RoleManagementCard.js): `frontend/src/components/RoleManagementCard.js`
- [Activity logs](https://github.com/kashish-jain-kj/easley-dunn/blob/main/frontend/src/components/ActivityLogsCard.js): `frontend/src/components/ActivityLogsCard.js`

### API and identity

- [HTTP application](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/app.js): `backend/src/app.js`
- [Feature router](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/routes/index.routes.js): `backend/src/routes/index.routes.js`
- [Authentication routes](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/routes/auth.routes.js): `backend/src/routes/auth.routes.js`
- [Authentication guard](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/middlewares/requireAuth.middleware.js): `backend/src/middlewares/requireAuth.middleware.js`

### Access governance

- [Users and roles](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/roles.controller.js): `backend/src/controllers/roles.controller.js`
- [Administration](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/admin.controller.js): `backend/src/controllers/admin.controller.js`
- [Service catalog](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/services.controller.js): `backend/src/controllers/services.controller.js`

### Provider integrations

- [Provider routes](https://github.com/kashish-jain-kj/easley-dunn/tree/main/backend/src/routes): `backend/src/routes`
- [BigQuery access](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/bigQuery.controller.js): `backend/src/controllers/bigQuery.controller.js`
- [Discord access](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/discord.controller.js): `backend/src/controllers/discord.controller.js`
- [App Store Connect](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/controllers/appleStoreConnect.controller.js): `backend/src/controllers/appleStoreConnect.controller.js`
- [Other providers](https://github.com/kashish-jain-kj/easley-dunn/tree/main/backend/src/controllers): `backend/src/controllers`

### Persistence and audit

- [PostgreSQL](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/db/database.js): `backend/src/db/database.js`
- [Activity audit](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/utils/logUtils.js): `backend/src/utils/logUtils.js`
- [Email delivery](https://github.com/kashish-jain-kj/easley-dunn/blob/main/backend/src/utils/mail.js): `backend/src/utils/mail.js`

### Other components

- **Operator**
- **External services**

## Connections

- Operator → Dashboard: uses (evidence: `README.md`)
- Dashboard → Session context: checks session (evidence: `frontend/src/App.js`)
- Dashboard → Authenticated fetch: sends requests (evidence: `frontend/src/App.js`)
- Dashboard → User views: renders (evidence: `frontend/src/App.js`)
- Dashboard → Role management: renders (evidence: `frontend/src/App.js`)
- Dashboard → Activity logs: renders (evidence: `frontend/src/App.js`)
- Dashboard → HTTP application: calls API (evidence: `frontend/src/App.js`)
- Session context → Authentication routes: calls auth API (evidence: `frontend/src/context/AuthContext.js`)
- HTTP application → Feature router: mounts (evidence: `backend/src/app.js`)
- Feature router → Authentication routes: mounts (evidence: `backend/src/routes/index.routes.js`)
- Feature router → Authentication guard: guards routes (evidence: `backend/src/routes/index.routes.js`)
- Feature router → Provider routes: mounts (evidence: `backend/src/routes/index.routes.js`)
- Feature router → Users and roles: routes roles (evidence: `backend/src/routes/index.routes.js`)
- Feature router → Administration: routes admin (evidence: `backend/src/routes/index.routes.js`)
- Feature router → Service catalog: routes services (evidence: `backend/src/routes/index.routes.js`)
- Provider routes → BigQuery access: dispatches (evidence: `backend/src/routes/bigQuery.routes.js`)
- Provider routes → Discord access: dispatches (evidence: `backend/src/routes/index.routes.js`)
- Provider routes → App Store Connect: dispatches (evidence: `backend/src/routes/appleStoreConnect.routes.js`)
- Provider routes → Other providers: dispatches (evidence: `backend/src/routes/bigQuery.routes.js`)
- BigQuery access → PostgreSQL: reads and writes (evidence: `backend/src/controllers/bigQuery.controller.js`)
- BigQuery access → Activity audit: records outcomes (evidence: `backend/src/controllers/bigQuery.controller.js`)
- Discord access → PostgreSQL: reads and writes (evidence: `backend/src/controllers/discord.controller.js`)
- Discord access → Activity audit: records outcomes (evidence: `backend/src/controllers/discord.controller.js`)
- Discord access → Email delivery: sends invites (evidence: `backend/src/controllers/discord.controller.js`)
- App Store Connect → PostgreSQL: uses access records (evidence: `backend/src/controllers/appleStoreConnect.controller.js`)
- App Store Connect → Activity audit: records operations (evidence: `backend/src/controllers/appleStoreConnect.controller.js`)
- BigQuery access → External services: manages permissions (evidence: `README.md`)
- Discord access → External services: manages membership (evidence: `README.md`)
- App Store Connect → External services: provisions access (evidence: `README.md`)
- Other providers → External services: integrates services (evidence: `README.md`)
- Activity audit → PostgreSQL: persists logs (evidence: `backend/src/utils/logUtils.js`)
