# saniarose1/agentic-human-loop-service-ai architecture

> Architecture diagram of the GitHub repository saniarose1/agentic-human-loop-service-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saniarose1/agentic-human-loop-service-ai
- Repository: https://github.com/saniarose1/agentic-human-loop-service-ai

## Overview

ServiceAI supports student service-request submission and tracking, followed by AI completeness verification, policy checks, and administrator review and disposition. The frontend has separate student and admin dashboards; request data is also maintained through a browser-local store. The backend registers authentication, submission, AI verification, and policy routes and uses MongoDB-backed request models. The README documents lab slot checks, audit events, and human decisions; some of those implementations were not sampled, so only documented or evidenced relationships are shown.

Main entry points: [`src/pages/student/StudentDashboard.jsx`](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/pages/student/StudentDashboard.jsx) (Student dashboard), [`src/pages/admin/AdminDashboard.jsx`](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/pages/admin/AdminDashboard.jsx) (Admin dashboard), [`src/App.jsx`](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/App.jsx) (App routing), [`src/data/requestStore.js`](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/data/requestStore.js) (Request and audit store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_app["App routing<br/>[App.jsx]"]
  node_login["Login and registration<br/>[Login.jsx]"]
end

subgraph group_student["Student workflow"]
  node_student_dashboard["Student dashboard"]
  node_request_form["Request submission"]
  node_request_detail["Request details"]
  node_student_table["Request tracking<br/>[RequestTable.jsx]"]
  node_ai_assistant["AI assistant"]
  node_request_store["Request and audit store<br/>[requestStore.js]"]
  node_mock_data["Initial request data<br/>[mockData.js]"]
end

subgraph group_admin["Administrator review"]
  node_admin_dashboard["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_verification_queue["Verification queue"]
  node_review_panel["Request review"]
  node_decision_dialog["Decision and edits<br/>[DecisionDialog.jsx]"]
  node_audit_timeline["Audit timeline<br/>[AuditTimeline.jsx]"]
end

subgraph group_backend["Backend services"]
  node_request_model[("Request model<br/>[Request.js]")]
  node_user_model[("User model<br/>[User.js]")]
  node_auth_routes["Authentication routes<br/>[Api.js]"]
  node_submit_routes["Submission routes<br/>[SubmitApi.js]"]
  node_verify_routes["AI verification and slot checks<br/>[verifyApi.js]"]
  node_policy_routes["Policy verification<br/>[policyApi.js]"]
  node_service["Express service<br/>[Service.js]"]
end

node_student_actor(("Student"))
node_admin_actor(("Administrator"))
node_browser_storage[("Browser local storage")]
node_groq{{"Groq AI service"}}

node_student_actor -->|"opens"| node_app
node_admin_actor -->|"opens"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_student_dashboard
node_app -->|"routes to"| node_admin_dashboard
node_student_dashboard -->|"renders"| node_request_form
node_student_dashboard -->|"renders"| node_request_detail
node_student_dashboard -->|"renders"| node_student_table
node_student_dashboard -->|"renders"| node_ai_assistant
node_student_dashboard -->|"uses"| node_request_store
node_request_detail -.->|"uses"| node_request_store
node_request_store -->|"imports initial data"| node_mock_data
node_request_store -->|"reads and writes"| node_browser_storage
node_admin_dashboard -->|"uses"| node_request_store
node_admin_dashboard -->|"renders"| node_verification_queue
node_admin_dashboard -->|"renders"| node_review_panel
node_admin_dashboard -->|"renders"| node_decision_dialog
node_admin_dashboard -->|"renders"| node_audit_timeline
node_review_panel -->|"opens decision"| node_decision_dialog
node_service -->|"registers"| node_auth_routes
node_service -->|"registers"| node_submit_routes
node_service -->|"registers"| node_verify_routes
node_service -->|"registers"| node_policy_routes
node_auth_routes -->|"uses"| node_user_model
node_submit_routes -->|"uses"| node_request_model
node_verify_routes -->|"reads and updates"| node_request_model
node_policy_routes -->|"uses"| node_request_model
node_verify_routes -->|"requests verification"| node_groq

click node_app "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/App.jsx"
click node_login "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/pages/Login.jsx"
click node_student_dashboard "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/pages/student/StudentDashboard.jsx"
click node_request_form "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/NewRequestModal.jsx"
click node_request_detail "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/RequestDetailsModal.jsx"
click node_student_table "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/RequestTable.jsx"
click node_ai_assistant "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/AIAssistantModal.jsx"
click node_request_store "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/data/requestStore.js"
click node_mock_data "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/data/mockData.js"
click node_admin_dashboard "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/pages/admin/AdminDashboard.jsx"
click node_verification_queue "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/admin/VerificationQueueTable.jsx"
click node_review_panel "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/admin/RequestReviewPanel.jsx"
click node_decision_dialog "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/admin/DecisionDialog.jsx"
click node_audit_timeline "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/admin/AuditTimeline.jsx"
click node_request_model "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Model/Request.js"
click node_user_model "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Model/User.js"
click node_auth_routes "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Routes/Api.js"
click node_submit_routes "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Routes/SubmitApi.js"
click node_verify_routes "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Routes/verifyApi.js"
click node_policy_routes "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Routes/policyApi.js"
click node_service "https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Service.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_login toneBlue
class node_student_dashboard,node_request_form,node_request_detail,node_student_table,node_ai_assistant,node_request_store,node_mock_data,node_browser_storage toneAmber
class node_admin_dashboard,node_verification_queue,node_review_panel,node_decision_dialog,node_audit_timeline toneMint
class node_request_model,node_user_model,node_auth_routes,node_submit_routes,node_verify_routes,node_policy_routes,node_service toneRose
class node_student_actor,node_admin_actor,node_groq toneIndigo
```

## Components

### Frontend experience

- [App routing](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/App.jsx): `src/App.jsx`
- [Login and registration](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/pages/Login.jsx): `src/pages/Login.jsx`

### Student workflow

- [Student dashboard](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/pages/student/StudentDashboard.jsx): `src/pages/student/StudentDashboard.jsx`
- [Request submission](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/NewRequestModal.jsx): `src/components/NewRequestModal.jsx`
- [Request details](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/RequestDetailsModal.jsx): `src/components/RequestDetailsModal.jsx`
- [Request tracking](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/RequestTable.jsx): `src/components/RequestTable.jsx`
- [AI assistant](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/AIAssistantModal.jsx): `src/components/AIAssistantModal.jsx`
- [Request and audit store](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/data/requestStore.js): `src/data/requestStore.js`
- [Initial request data](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/data/mockData.js): `src/data/mockData.js`

### Administrator review

- [Admin dashboard](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/pages/admin/AdminDashboard.jsx): `src/pages/admin/AdminDashboard.jsx`
- [Verification queue](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/admin/VerificationQueueTable.jsx): `src/components/admin/VerificationQueueTable.jsx`
- [Request review](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/admin/RequestReviewPanel.jsx): `src/components/admin/RequestReviewPanel.jsx`
- [Decision and edits](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/admin/DecisionDialog.jsx): `src/components/admin/DecisionDialog.jsx`
- [Audit timeline](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/src/components/admin/AuditTimeline.jsx): `src/components/admin/AuditTimeline.jsx`

### Backend services

- [Request model](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Model/Request.js): `Backend/Model/Request.js`
- [User model](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Model/User.js): `Backend/Model/User.js`
- [Authentication routes](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Routes/Api.js): `Backend/Routes/Api.js`
- [Submission routes](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Routes/SubmitApi.js): `Backend/Routes/SubmitApi.js`
- [AI verification and slot checks](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Routes/verifyApi.js): `Backend/Routes/verifyApi.js`
- [Policy verification](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Routes/policyApi.js): `Backend/Routes/policyApi.js`
- [Express service](https://github.com/saniarose1/agentic-human-loop-service-ai/blob/main/Backend/Service.js): `Backend/Service.js`

### Other components

- **Student**
- **Administrator**
- **Browser local storage**
- **Groq AI service**

## Connections

- Student → App routing: opens (evidence: `src/App.jsx`)
- Administrator → App routing: opens (evidence: `src/App.jsx`)
- App routing → Login and registration: routes to (evidence: `src/App.jsx`)
- App routing → Student dashboard: routes to (evidence: `src/App.jsx`)
- App routing → Admin dashboard: routes to (evidence: `src/App.jsx`)
- Student dashboard → Request submission: renders (evidence: `src/pages/student/StudentDashboard.jsx`)
- Student dashboard → Request details: renders (evidence: `src/pages/student/StudentDashboard.jsx`)
- Student dashboard → Request tracking: renders (evidence: `src/pages/student/StudentDashboard.jsx`)
- Student dashboard → AI assistant: renders (evidence: `src/pages/student/StudentDashboard.jsx`)
- Student dashboard → Request and audit store: uses (evidence: `src/pages/student/StudentDashboard.jsx`)
- Request details → Request and audit store: uses
- Request and audit store → Initial request data: imports initial data (evidence: `src/data/requestStore.js`)
- Request and audit store → Browser local storage: reads and writes (evidence: `src/data/requestStore.js`)
- Admin dashboard → Request and audit store: uses (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Admin dashboard → Verification queue: renders (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Admin dashboard → Request review: renders (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Admin dashboard → Decision and edits: renders (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Admin dashboard → Audit timeline: renders (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Request review → Decision and edits: opens decision (evidence: `src/components/admin/RequestReviewPanel.jsx`)
- Express service → Authentication routes: registers (evidence: `Backend/Service.js`)
- Express service → Submission routes: registers (evidence: `Backend/Service.js`)
- Express service → AI verification and slot checks: registers (evidence: `Backend/Service.js`)
- Express service → Policy verification: registers (evidence: `Backend/Service.js`)
- Authentication routes → User model: uses (evidence: `Backend/Routes/Api.js`)
- Submission routes → Request model: uses (evidence: `Backend/Routes/SubmitApi.js`)
- AI verification and slot checks → Request model: reads and updates (evidence: `Backend/Routes/verifyApi.js`)
- Policy verification → Request model: uses (evidence: `Backend/Routes/policyApi.js`)
- AI verification and slot checks → Groq AI service: requests verification (evidence: `Backend/Routes/verifyApi.js`)
