# ferdicoder/capstone1_accentra architecture

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

- Interactive diagram: https://gitdiagram.com/ferdicoder/capstone1_accentra
- Repository: https://github.com/ferdicoder/capstone1_accentra

## Overview

Accentra is a practice-management application for Philippine accounting firms. Clients register, request services, and follow resulting engagements; firm users manage service templates and requests, convert requests into engagements, and oversee tasks, reviews, activity, and documents. The React workspaces use Supabase directly for most application data, with Express handling privileged operations and document transfer to Backblaze B2. The README documents these capabilities; sampled backend excerpts confirm document-storage behavior, while several frontend connections are documented rather than verified in source.

Main entry points: [`frontend/src/pages/firm`](https://github.com/ferdicoder/capstone1_accentra/tree/main/frontend/src/pages/firm) (Firm Workspace), [`frontend/src/pages/client`](https://github.com/ferdicoder/capstone1_accentra/tree/main/frontend/src/pages/client) (Client Workspace), [`backend/server.js`](https://github.com/ferdicoder/capstone1_accentra/blob/main/backend/server.js) (Express API), [`backend/controllers/user.controller.js`](https://github.com/ferdicoder/capstone1_accentra/blob/main/backend/controllers/user.controller.js) (Staff and Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspaces["User Workspaces"]
  node_client_workspace["Client Workspace"]
  node_firm_workspace["Firm Workspace"]
  node_service_templates["Service Templates"]
  node_request_management["Service Requests"]
  node_engagement_management["Engagement Workflows"]
end

subgraph group_frontend_data["Frontend Data Access"]
  node_auth["Authentication<br/>[authService.js]"]
  node_client_requests["Client Requests"]
  node_engagement_data["Engagement Data<br/>[useEngagements.jsx]"]
  node_service_data["Service Data<br/>[serviceAPI.js]"]
  node_user_data["User Data<br/>[userAPI.js]"]
  node_document_api["Document API<br/>[documentAPI.js]"]
end

subgraph group_backend["Express Operations"]
  node_express["Express API<br/>[server.js]"]
  node_staff_service["Staff and Service<br/>[user.controller.js]"]
  node_template_documents["Template Documents"]
  node_engagement_documents["Engagement Documents"]
end

subgraph group_persistence["Persistence and Files"]
  node_supabase[("Supabase")]
  node_backblaze[("Backblaze B2")]
end

node_clients(("Clients"))
node_firm_users(("Firm Users"))

node_clients -->|"use"| node_client_workspace
node_firm_users -->|"use"| node_firm_workspace
node_client_workspace -->|"sign in"| node_auth
node_firm_workspace -->|"sign in"| node_auth
node_client_workspace -->|"manage requests"| node_client_requests
node_client_workspace -->|"view engagements"| node_engagement_data
node_firm_workspace -->|"manage templates"| node_service_templates
node_firm_workspace -->|"review requests"| node_request_management
node_request_management -->|"convert request"| node_engagement_management
node_firm_workspace -->|"manage engagements"| node_engagement_management
node_auth -->|"authenticate"| node_supabase
node_client_requests -->|"read and write"| node_supabase
node_engagement_data -->|"read and update"| node_supabase
node_service_data -->|"read and write"| node_supabase
node_user_data -->|"read and update"| node_supabase
node_document_api -->|"transfer files"| node_express
node_express -->|"routes requests"| node_staff_service
node_express -->|"routes uploads"| node_template_documents
node_express -->|"routes documents"| node_engagement_documents
node_staff_service -->|"create staff"| node_supabase
node_staff_service -.->|"create service"| node_supabase
node_template_documents -->|"store metadata"| node_supabase
node_template_documents -->|"upload file"| node_backblaze
node_engagement_documents -->|"store metadata"| node_supabase
node_engagement_documents -->|"upload and retrieve"| node_backblaze

click node_client_workspace "https://github.com/ferdicoder/capstone1_accentra/tree/main/frontend/src/pages/client"
click node_firm_workspace "https://github.com/ferdicoder/capstone1_accentra/tree/main/frontend/src/pages/firm"
click node_service_templates "https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/components/firm/service-management/service-template-form.jsx"
click node_request_management "https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/pages/firm/ServiceRequestsPage.jsx"
click node_engagement_management "https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/pages/firm/EngagementDetailsPage.jsx"
click node_auth "https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/services/authService.js"
click node_client_requests "https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/hooks/useServiceRequests.jsx"
click node_engagement_data "https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/hooks/useEngagements.jsx"
click node_service_data "https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/services/api/serviceAPI.js"
click node_user_data "https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/services/api/userAPI.js"
click node_document_api "https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/services/api/documentAPI.js"
click node_express "https://github.com/ferdicoder/capstone1_accentra/blob/main/backend/server.js"
click node_staff_service "https://github.com/ferdicoder/capstone1_accentra/blob/main/backend/controllers/user.controller.js"
click node_template_documents "https://github.com/ferdicoder/capstone1_accentra/blob/main/backend/controllers/templateDocument.controller.js"
click node_engagement_documents "https://github.com/ferdicoder/capstone1_accentra/blob/main/backend/controllers/engagementDocument.controller.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_client_workspace,node_firm_workspace,node_service_templates,node_request_management,node_engagement_management,node_clients,node_firm_users toneBlue
class node_auth,node_client_requests,node_engagement_data,node_service_data,node_user_data,node_document_api toneAmber
class node_express,node_staff_service,node_template_documents,node_engagement_documents toneMint
class node_supabase,node_backblaze toneRose
```

## Components

### User Workspaces

- [Client Workspace](https://github.com/ferdicoder/capstone1_accentra/tree/main/frontend/src/pages/client): `frontend/src/pages/client`
- [Firm Workspace](https://github.com/ferdicoder/capstone1_accentra/tree/main/frontend/src/pages/firm): `frontend/src/pages/firm`
- [Service Templates](https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/components/firm/service-management/service-template-form.jsx): `frontend/src/components/firm/service-management/service-template-form.jsx`
- [Service Requests](https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/pages/firm/ServiceRequestsPage.jsx): `frontend/src/pages/firm/ServiceRequestsPage.jsx`
- [Engagement Workflows](https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/pages/firm/EngagementDetailsPage.jsx): `frontend/src/pages/firm/EngagementDetailsPage.jsx`

### Frontend Data Access

- [Authentication](https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/services/authService.js): `frontend/src/services/authService.js`
- [Client Requests](https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/hooks/useServiceRequests.jsx): `frontend/src/hooks/useServiceRequests.jsx`
- [Engagement Data](https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/hooks/useEngagements.jsx): `frontend/src/hooks/useEngagements.jsx`
- [Service Data](https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/services/api/serviceAPI.js): `frontend/src/services/api/serviceAPI.js`
- [User Data](https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/services/api/userAPI.js): `frontend/src/services/api/userAPI.js`
- [Document API](https://github.com/ferdicoder/capstone1_accentra/blob/main/frontend/src/services/api/documentAPI.js): `frontend/src/services/api/documentAPI.js`

### Express Operations

- [Express API](https://github.com/ferdicoder/capstone1_accentra/blob/main/backend/server.js): `backend/server.js`
- [Staff and Service](https://github.com/ferdicoder/capstone1_accentra/blob/main/backend/controllers/user.controller.js): `backend/controllers/user.controller.js`
- [Template Documents](https://github.com/ferdicoder/capstone1_accentra/blob/main/backend/controllers/templateDocument.controller.js): `backend/controllers/templateDocument.controller.js`
- [Engagement Documents](https://github.com/ferdicoder/capstone1_accentra/blob/main/backend/controllers/engagementDocument.controller.js): `backend/controllers/engagementDocument.controller.js`

### Persistence and Files

- **Supabase**
- **Backblaze B2**

### Other components

- **Clients**
- **Firm Users**

## Connections

- Clients → Client Workspace: use
- Firm Users → Firm Workspace: use
- Client Workspace → Authentication: sign in
- Firm Workspace → Authentication: sign in
- Client Workspace → Client Requests: manage requests
- Client Workspace → Engagement Data: view engagements
- Firm Workspace → Service Templates: manage templates
- Firm Workspace → Service Requests: review requests
- Service Requests → Engagement Workflows: convert request
- Firm Workspace → Engagement Workflows: manage engagements
- Authentication → Supabase: authenticate
- Client Requests → Supabase: read and write
- Engagement Data → Supabase: read and update
- Service Data → Supabase: read and write
- User Data → Supabase: read and update
- Document API → Express API: transfer files
- Express API → Staff and Service: routes requests (evidence: `backend/server.js`)
- Express API → Template Documents: routes uploads (evidence: `backend/server.js`)
- Express API → Engagement Documents: routes documents (evidence: `backend/server.js`)
- Staff and Service → Supabase: create staff (evidence: `backend/controllers/user.controller.js`)
- Staff and Service → Supabase: create service
- Template Documents → Supabase: store metadata (evidence: `backend/controllers/templateDocument.controller.js`)
- Template Documents → Backblaze B2: upload file (evidence: `backend/controllers/templateDocument.controller.js`)
- Engagement Documents → Supabase: store metadata (evidence: `backend/controllers/engagementDocument.controller.js`)
- Engagement Documents → Backblaze B2: upload and retrieve (evidence: `backend/controllers/engagementDocument.controller.js`)
