# smks-007/pinkslipreport architecture

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

- Interactive diagram: https://gitdiagram.com/smks-007/pinkslipreport
- Repository: https://github.com/smks-007/pinkslipreport

## Overview

SMART PRO is described as a role-based attendance ledger and two-stage leave/Pink Slip approval product, with analytics and a Jarvis copilot. The supplied tree does not contain the README’s Flutter/Supabase application; it contains a React attendance dashboard, a Spring Boot backend, and a separate Google Drive backend. The graph maps only observable code and documents their connections separately; the excerpts do not establish a React-to-Spring integration.

Main entry points: [`college-attendance-system/src/App.tsx`](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/App.tsx) (Dashboard app), [`pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/repositories`](https://github.com/smks-007/pinkslipreport/tree/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/repositories) (Attendance repositories), [`pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/controllers/HodDashboardController.java`](https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/controllers/HodDashboardController.java) (HOD dashboard API), [`college-attendance-system/src/context/AttendanceContext.tsx`](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/context/AttendanceContext.tsx) (Attendance state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["React dashboard"]
  node_react_app["Dashboard app<br/>[App.tsx]"]
  node_attendance_state["Attendance state"]
  node_mock_data["Mock data<br/>[mockData.ts]"]
  node_calendar["Monthly calendar"]
  node_period_grid["Period attendance"]
  node_leave_workflow["Leave workflow"]
  node_analytics["Department analytics"]
  node_hod_cockpit["HOD cockpit<br/>[HODCockpit.tsx]"]
  node_student_dossier["Student dossier<br/>[StudentDossier.tsx]"]
  node_cloud_naac["Cloud and NAAC"]
  node_jarvis_ui["Jarvis copilot UI"]
  node_export_ui["Export and import"]
end

subgraph group_backend["Attendance backend"]
  node_auth_api["Authentication API"]
  node_hod_api["HOD dashboard API"]
  node_attendance_service["Attendance metrics"]
  node_workflow_service["Pink Slip workflow"]
  node_biometric_service["Biometric sync"]
  node_jarvis_service["Jarvis query service"]
end

subgraph group_domain["Attendance domain"]
  node_domain_models["Users, students, sections, slips"]
  node_repositories[("Attendance repositories")]
end

subgraph group_integrations["External services"]
  node_drive_controller["Drive API"]
  node_drive_service["Drive service"]
end

node_staff(("Department users"))
node_google_drive[("Google Drive")]

node_staff -->|"uses"| node_react_app
node_react_app -->|"reads state"| node_attendance_state
node_react_app -->|"renders"| node_calendar
node_react_app -->|"renders"| node_period_grid
node_react_app -->|"renders"| node_leave_workflow
node_react_app -->|"renders"| node_analytics
node_react_app -->|"renders"| node_hod_cockpit
node_react_app -->|"renders"| node_student_dossier
node_react_app -->|"renders"| node_cloud_naac
node_react_app -->|"opens"| node_jarvis_ui
node_react_app -->|"opens"| node_export_ui
node_attendance_state -->|"loads defaults"| node_mock_data
node_staff -.->|"authenticates"| node_auth_api
node_hod_api -->|"calls"| node_attendance_service
node_hod_api -->|"calls"| node_workflow_service
node_hod_api -->|"calls"| node_biometric_service
node_attendance_service -->|"reads and writes"| node_repositories
node_workflow_service -->|"reads and writes"| node_repositories
node_biometric_service -->|"records punches"| node_repositories
node_jarvis_service -->|"queries attendance"| node_repositories
node_drive_controller -->|"calls"| node_drive_service
node_drive_service -.->|"manages files"| node_google_drive

click node_react_app "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/App.tsx"
click node_attendance_state "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/context/AttendanceContext.tsx"
click node_mock_data "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/data/mockData.ts"
click node_calendar "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/calendar/MonthlyAttendanceCalendar.tsx"
click node_period_grid "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/attendance/PeriodAttendanceGrid.tsx"
click node_leave_workflow "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/leave/LeaveWorkflowCenter.tsx"
click node_analytics "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/analytics/DepartmentAnalyticsCharts.tsx"
click node_hod_cockpit "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/hod/HODCockpit.tsx"
click node_student_dossier "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/student/StudentDossier.tsx"
click node_cloud_naac "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/cloud/CloudAndNAACView.tsx"
click node_jarvis_ui "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/ai/JarvisAiAdvisor.tsx"
click node_export_ui "https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/export/ExportImportModal.tsx"
click node_auth_api "https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/controllers/AuthController.java"
click node_hod_api "https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/controllers/HodDashboardController.java"
click node_attendance_service "https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/AttendanceService.java"
click node_workflow_service "https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/PinkSlipWorkflowService.java"
click node_biometric_service "https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/BiometricSyncService.java"
click node_jarvis_service "https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/JarvisAiService.java"
click node_domain_models "https://github.com/smks-007/pinkslipreport/tree/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/models"
click node_repositories "https://github.com/smks-007/pinkslipreport/tree/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/repositories"
click node_drive_controller "https://github.com/smks-007/pinkslipreport/blob/main/attendance-backend/src/main/java/com/attendance/attendance_backend/GoogleDriveController.java"
click node_drive_service "https://github.com/smks-007/pinkslipreport/blob/main/attendance-backend/src/main/java/com/attendance/attendance_backend/GoogleDriveService.java"

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_react_app,node_attendance_state,node_mock_data,node_calendar,node_period_grid,node_leave_workflow,node_analytics,node_hod_cockpit,node_student_dossier,node_cloud_naac,node_jarvis_ui,node_export_ui,node_staff toneBlue
class node_auth_api,node_hod_api,node_attendance_service,node_workflow_service,node_biometric_service,node_jarvis_service,node_google_drive toneAmber
class node_domain_models,node_repositories toneMint
class node_drive_controller,node_drive_service toneRose
```

## Components

### React dashboard

- [Dashboard app](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/App.tsx): `college-attendance-system/src/App.tsx`
- [Attendance state](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/context/AttendanceContext.tsx): `college-attendance-system/src/context/AttendanceContext.tsx`
- [Mock data](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/data/mockData.ts): `college-attendance-system/src/data/mockData.ts`
- [Monthly calendar](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/calendar/MonthlyAttendanceCalendar.tsx): `college-attendance-system/src/components/calendar/MonthlyAttendanceCalendar.tsx`
- [Period attendance](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/attendance/PeriodAttendanceGrid.tsx): `college-attendance-system/src/components/attendance/PeriodAttendanceGrid.tsx`
- [Leave workflow](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/leave/LeaveWorkflowCenter.tsx): `college-attendance-system/src/components/leave/LeaveWorkflowCenter.tsx`
- [Department analytics](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/analytics/DepartmentAnalyticsCharts.tsx): `college-attendance-system/src/components/analytics/DepartmentAnalyticsCharts.tsx`
- [HOD cockpit](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/hod/HODCockpit.tsx): `college-attendance-system/src/components/hod/HODCockpit.tsx`
- [Student dossier](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/student/StudentDossier.tsx): `college-attendance-system/src/components/student/StudentDossier.tsx`
- [Cloud and NAAC](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/cloud/CloudAndNAACView.tsx): `college-attendance-system/src/components/cloud/CloudAndNAACView.tsx`
- [Jarvis copilot UI](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/ai/JarvisAiAdvisor.tsx): `college-attendance-system/src/components/ai/JarvisAiAdvisor.tsx`
- [Export and import](https://github.com/smks-007/pinkslipreport/blob/main/college-attendance-system/src/components/export/ExportImportModal.tsx): `college-attendance-system/src/components/export/ExportImportModal.tsx`

### Attendance backend

- [Authentication API](https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/controllers/AuthController.java): `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/controllers/AuthController.java`
- [HOD dashboard API](https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/controllers/HodDashboardController.java): `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/controllers/HodDashboardController.java`
- [Attendance metrics](https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/AttendanceService.java): `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/AttendanceService.java`
- [Pink Slip workflow](https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/PinkSlipWorkflowService.java): `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/PinkSlipWorkflowService.java`
- [Biometric sync](https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/BiometricSyncService.java): `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/BiometricSyncService.java`
- [Jarvis query service](https://github.com/smks-007/pinkslipreport/blob/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/JarvisAiService.java): `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/JarvisAiService.java`

### Attendance domain

- [Users, students, sections, slips](https://github.com/smks-007/pinkslipreport/tree/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/models): `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/models`
- [Attendance repositories](https://github.com/smks-007/pinkslipreport/tree/main/pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/repositories): `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/repositories`

### External services

- [Drive API](https://github.com/smks-007/pinkslipreport/blob/main/attendance-backend/src/main/java/com/attendance/attendance_backend/GoogleDriveController.java): `attendance-backend/src/main/java/com/attendance/attendance_backend/GoogleDriveController.java`
- [Drive service](https://github.com/smks-007/pinkslipreport/blob/main/attendance-backend/src/main/java/com/attendance/attendance_backend/GoogleDriveService.java): `attendance-backend/src/main/java/com/attendance/attendance_backend/GoogleDriveService.java`

### Other components

- **Department users**
- **Google Drive**

## Connections

- Department users → Dashboard app: uses (evidence: `README.md`)
- Dashboard app → Attendance state: reads state (evidence: `college-attendance-system/src/App.tsx`)
- Dashboard app → Monthly calendar: renders (evidence: `college-attendance-system/src/App.tsx`)
- Dashboard app → Period attendance: renders (evidence: `college-attendance-system/src/App.tsx`)
- Dashboard app → Leave workflow: renders (evidence: `college-attendance-system/src/App.tsx`)
- Dashboard app → Department analytics: renders (evidence: `college-attendance-system/src/App.tsx`)
- Dashboard app → HOD cockpit: renders (evidence: `college-attendance-system/src/App.tsx`)
- Dashboard app → Student dossier: renders (evidence: `college-attendance-system/src/App.tsx`)
- Dashboard app → Cloud and NAAC: renders (evidence: `college-attendance-system/src/App.tsx`)
- Dashboard app → Jarvis copilot UI: opens (evidence: `college-attendance-system/src/App.tsx`)
- Dashboard app → Export and import: opens (evidence: `college-attendance-system/src/App.tsx`)
- Attendance state → Mock data: loads defaults (evidence: `college-attendance-system/src/context/AttendanceContext.tsx`)
- Department users → Authentication API: authenticates (evidence: `README.md`)
- HOD dashboard API → Attendance metrics: calls (evidence: `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/controllers/HodDashboardController.java`)
- HOD dashboard API → Pink Slip workflow: calls (evidence: `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/controllers/HodDashboardController.java`)
- HOD dashboard API → Biometric sync: calls (evidence: `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/controllers/HodDashboardController.java`)
- Attendance metrics → Attendance repositories: reads and writes (evidence: `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/AttendanceService.java`)
- Pink Slip workflow → Attendance repositories: reads and writes (evidence: `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/PinkSlipWorkflowService.java`)
- Biometric sync → Attendance repositories: records punches (evidence: `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/BiometricSyncService.java`)
- Jarvis query service → Attendance repositories: queries attendance (evidence: `pinkslip-attendance-system/backend-spring-boot/src/main/java/com/pinkslip/services/JarvisAiService.java`)
- Drive API → Drive service: calls (evidence: `attendance-backend/src/main/java/com/attendance/attendance_backend/GoogleDriveController.java`)
- Drive service → Google Drive: manages files
