# chinmayj592/sales-force-object-manager-ui architecture

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

- Interactive diagram: https://gitdiagram.com/chinmayj592/sales-force-object-manager-ui
- Repository: https://github.com/chinmayj592/sales-force-object-manager-ui

## Overview

This is a Salesforce object-management web app: users authenticate, choose an object type, browse records, and create, view, edit, or delete records. The dashboard coordinates record state and UI actions; record services map object types to API routes. Authentication and object selection are separate application concerns. The graph follows the excerpts and source-index references; backend behavior beyond the visible API calls is not inspected.

Main entry points: [`src/pages/DashboardPage.jsx`](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/pages/DashboardPage.jsx) (Dashboard), [`src/App.jsx`](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/App.jsx) (App shell), [`src/routes.jsx`](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/routes.jsx) (Route guards), [`src/context/ObjectContext.jsx`](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/context/ObjectContext.jsx) (Object state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["App shell<br/>[App.jsx]"]
  node_routes["Route guards<br/>[routes.jsx]"]
end

subgraph group_auth["Authentication"]
  node_login["Login page<br/>[LoginPage.jsx]"]
  node_authstate["Auth state<br/>[AuthContext.jsx]"]
  node_authhook["Auth hook<br/>[useAuth.js]"]
  node_authservice["Auth service<br/>[authService.js]"]
end

subgraph group_objects["Object selection"]
  node_objectstate["Object state<br/>[ObjectContext.jsx]"]
  node_objectpicker["Object picker<br/>[ObjectDropdown.jsx]"]
  node_objectschema["Object schemas<br/>[constants.js]"]
end

subgraph group_records["Record management"]
  node_dashboard["Dashboard<br/>[DashboardPage.jsx]"]
  node_recordhook["Record state<br/>[useRecords.js]"]
  node_recordservice["Record service<br/>[recordService.js]"]
  node_api["API client<br/>[api.js]"]
  node_table["Record table<br/>[RecordTable.jsx]"]
  node_row["Record row<br/>[RecordRow.jsx]"]
  node_form["Record form<br/>[RecordForm.jsx]"]
  node_view["Record details<br/>[ViewModal.jsx]"]
  node_modal["Modal dialog<br/>[Modal.jsx]"]
  node_helpers["Record helpers<br/>[helpers.js]"]
end

node_user(("User"))
node_backend{{"Application backend"}}

node_user -->|"opens app"| node_app
node_app -->|"provides auth"| node_authstate
node_app -->|"renders routes"| node_routes
node_routes -->|"checks session"| node_authhook
node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_dashboard
node_authstate -->|"calls auth"| node_authservice
node_authhook -->|"reads context"| node_authstate
node_user -.->|"starts login"| node_login
node_app -->|"provides objects"| node_objectstate
node_dashboard -->|"reads selection"| node_objectstate
node_dashboard -->|"renders picker"| node_objectpicker
node_objectpicker -->|"updates selection"| node_objectstate
node_objectstate -->|"reads definitions"| node_objectschema
node_dashboard -->|"loads records"| node_recordhook
node_recordhook -->|"calls CRUD"| node_recordservice
node_recordservice -->|"sends requests"| node_api
node_api -->|"requests records"| node_backend
node_dashboard -->|"renders records"| node_table
node_table -->|"renders rows"| node_row
node_dashboard -->|"renders create/edit"| node_form
node_dashboard -->|"renders details"| node_view
node_view -->|"uses dialog"| node_modal
node_form -->|"uses dialog"| node_modal
node_form -->|"builds record"| node_helpers
node_row -->|"formats display"| node_helpers

click node_app "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/App.jsx"
click node_routes "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/routes.jsx"
click node_login "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/pages/LoginPage.jsx"
click node_authstate "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/context/AuthContext.jsx"
click node_authhook "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/hooks/useAuth.js"
click node_authservice "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/services/authService.js"
click node_dashboard "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/pages/DashboardPage.jsx"
click node_objectstate "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/context/ObjectContext.jsx"
click node_objectpicker "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/objectSelector/ObjectDropdown.jsx"
click node_objectschema "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/utils/constants.js"
click node_recordhook "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/hooks/useRecords.js"
click node_recordservice "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/services/recordService.js"
click node_api "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/services/api.js"
click node_table "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/records/RecordTable.jsx"
click node_row "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/records/RecordRow.jsx"
click node_form "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/records/RecordForm.jsx"
click node_view "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/records/ViewModal.jsx"
click node_modal "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/common/Modal.jsx"
click node_helpers "https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/utils/helpers.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_app,node_routes,node_user toneBlue
class node_login,node_authstate,node_authhook,node_authservice toneAmber
class node_objectstate,node_objectpicker,node_objectschema toneMint
class node_dashboard,node_recordhook,node_recordservice,node_api,node_table,node_row,node_form,node_view,node_modal,node_helpers toneRose
class node_backend toneIndigo
```

## Components

### Application shell

- [App shell](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/App.jsx): `src/App.jsx`
- [Route guards](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/routes.jsx): `src/routes.jsx`

### Authentication

- [Login page](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/pages/LoginPage.jsx): `src/pages/LoginPage.jsx`
- [Auth state](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Auth hook](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/hooks/useAuth.js): `src/hooks/useAuth.js`
- [Auth service](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/services/authService.js): `src/services/authService.js`

### Object selection

- [Object state](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/context/ObjectContext.jsx): `src/context/ObjectContext.jsx`
- [Object picker](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/objectSelector/ObjectDropdown.jsx): `src/components/objectSelector/ObjectDropdown.jsx`
- [Object schemas](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/utils/constants.js): `src/utils/constants.js`

### Record management

- [Dashboard](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/pages/DashboardPage.jsx): `src/pages/DashboardPage.jsx`
- [Record state](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/hooks/useRecords.js): `src/hooks/useRecords.js`
- [Record service](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/services/recordService.js): `src/services/recordService.js`
- [API client](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/services/api.js): `src/services/api.js`
- [Record table](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/records/RecordTable.jsx): `src/components/records/RecordTable.jsx`
- [Record row](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/records/RecordRow.jsx): `src/components/records/RecordRow.jsx`
- [Record form](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/records/RecordForm.jsx): `src/components/records/RecordForm.jsx`
- [Record details](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/records/ViewModal.jsx): `src/components/records/ViewModal.jsx`
- [Modal dialog](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/components/common/Modal.jsx): `src/components/common/Modal.jsx`
- [Record helpers](https://github.com/chinmayj592/sales-force-object-manager-ui/blob/main/src/utils/helpers.js): `src/utils/helpers.js`

### Other components

- **User**
- **Application backend**

## Connections

- User → App shell: opens app (evidence: `src/App.jsx`)
- App shell → Auth state: provides auth (evidence: `src/App.jsx`)
- App shell → Route guards: renders routes (evidence: `src/App.jsx`)
- Route guards → Auth hook: checks session (evidence: `src/routes.jsx`)
- Route guards → Login page: routes to (evidence: `src/routes.jsx`)
- Route guards → Dashboard: routes to (evidence: `src/routes.jsx`)
- Auth state → Auth service: calls auth (evidence: `src/context/AuthContext.jsx`)
- Auth hook → Auth state: reads context (evidence: `src/hooks/useAuth.js`)
- User → Login page: starts login
- App shell → Object state: provides objects (evidence: `src/App.jsx`)
- Dashboard → Object state: reads selection (evidence: `src/pages/DashboardPage.jsx`)
- Dashboard → Object picker: renders picker (evidence: `src/pages/DashboardPage.jsx`)
- Object picker → Object state: updates selection (evidence: `src/components/objectSelector/ObjectDropdown.jsx`)
- Object state → Object schemas: reads definitions (evidence: `src/context/ObjectContext.jsx`)
- Dashboard → Record state: loads records (evidence: `src/pages/DashboardPage.jsx`)
- Record state → Record service: calls CRUD (evidence: `src/hooks/useRecords.js`)
- Record service → API client: sends requests (evidence: `src/services/recordService.js`)
- API client → Application backend: requests records
- Dashboard → Record table: renders records (evidence: `src/pages/DashboardPage.jsx`)
- Record table → Record row: renders rows (evidence: `src/components/records/RecordTable.jsx`)
- Dashboard → Record form: renders create/edit (evidence: `src/pages/DashboardPage.jsx`)
- Dashboard → Record details: renders details (evidence: `src/pages/DashboardPage.jsx`)
- Record details → Modal dialog: uses dialog (evidence: `src/components/records/ViewModal.jsx`)
- Record form → Modal dialog: uses dialog (evidence: `src/components/records/RecordForm.jsx`)
- Record form → Record helpers: builds record (evidence: `src/components/records/RecordForm.jsx`)
- Record row → Record helpers: formats display (evidence: `src/components/records/RecordRow.jsx`)
