# itmoorthy/attendance_tracker architecture

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

- Interactive diagram: https://gitdiagram.com/itmoorthy/attendance_tracker
- Repository: https://github.com/itmoorthy/attendance_tracker

## Overview

Office Attendance Tracker is a React attendance portal for employees and managers. Users sign in, select a quarter, review or update attendance, and see calculated totals and visual summaries; managers also review team attendance and manage employees and holidays. Calendar editing, spreadsheet import/export, formula guidance, and an attendance chatbot are distinct product capabilities. The graph follows relationships visible in excerpts or the source index; unsampled implementation details and server integrations are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/itmoorthy/attendance_tracker/blob/main/src/App.tsx) (App State and Routing), [`src/utils.ts`](https://github.com/itmoorthy/attendance_tracker/blob/main/src/utils.ts) (Calculations and Spreadsheet Tools), [`src/firebase.ts`](https://github.com/itmoorthy/attendance_tracker/blob/main/src/firebase.ts) (Firebase Client), [`src/components/ExcelTable.tsx`](https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/ExcelTable.tsx) (Attendance Spreadsheet)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_entry["React Entry<br/>[main.tsx]"]
  node_app_shell["App State and Routing<br/>[App.tsx]"]
  node_login["Sign-in Screen<br/>[LoginScreen.tsx]"]
  node_firebase["Firebase Client<br/>[firebase.ts]"]
end

subgraph group_attendance["Attendance Workspace"]
  node_attendance_table["Attendance Spreadsheet<br/>[ExcelTable.tsx]"]
  node_calendar["Calendar Planner"]
  node_stats["Attendance Summary<br/>[DashboardStats.tsx]"]
  node_charts["Attendance Charts"]
  node_formula["Formula Guide<br/>[FormulaGuide.tsx]"]
  node_chatbot["Attendance Chatbot"]
end

subgraph group_management["Team Management"]
  node_manager["Manager Dashboard"]
end

subgraph group_logic["Attendance Logic"]
  node_types["Attendance Data Types<br/>[types.ts]"]
  node_utils["Calculations and Spreadsheet Tools<br/>[utils.ts]"]
end

node_user(("Employee or Manager"))
node_firestore[("Firestore")]

node_entry -->|"renders"| node_app_shell
node_app_shell -->|"renders"| node_login
node_app_shell -->|"renders"| node_attendance_table
node_app_shell -->|"uses"| node_calendar
node_app_shell -->|"renders"| node_stats
node_app_shell -->|"uses"| node_charts
node_app_shell -->|"uses"| node_formula
node_app_shell -->|"uses"| node_chatbot
node_app_shell -->|"renders"| node_manager
node_app_shell -->|"uses"| node_firebase
node_app_shell -->|"writes"| node_firestore
node_firebase -->|"initializes"| node_firestore
node_attendance_table -->|"calculates with"| node_utils
node_manager -->|"calculates with"| node_utils
node_chatbot -->|"calculates with"| node_utils

click node_entry "https://github.com/itmoorthy/attendance_tracker/blob/main/src/main.tsx"
click node_app_shell "https://github.com/itmoorthy/attendance_tracker/blob/main/src/App.tsx"
click node_login "https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/LoginScreen.tsx"
click node_firebase "https://github.com/itmoorthy/attendance_tracker/blob/main/src/firebase.ts"
click node_attendance_table "https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/ExcelTable.tsx"
click node_calendar "https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/CalendarPlanner.tsx"
click node_stats "https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/DashboardStats.tsx"
click node_charts "https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/VisualizationCharts.tsx"
click node_formula "https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/FormulaGuide.tsx"
click node_chatbot "https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/AttendanceChatbot.tsx"
click node_manager "https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/ManagerDashboard.tsx"
click node_types "https://github.com/itmoorthy/attendance_tracker/blob/main/src/types.ts"
click node_utils "https://github.com/itmoorthy/attendance_tracker/blob/main/src/utils.ts"

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_entry,node_app_shell,node_login,node_firebase toneBlue
class node_attendance_table,node_calendar,node_stats,node_charts,node_formula,node_chatbot,node_firestore toneAmber
class node_manager toneMint
class node_types,node_utils toneRose
class node_user toneIndigo
```

## Components

### Application Shell

- [React Entry](https://github.com/itmoorthy/attendance_tracker/blob/main/src/main.tsx): `src/main.tsx`
- [App State and Routing](https://github.com/itmoorthy/attendance_tracker/blob/main/src/App.tsx): `src/App.tsx`
- [Sign-in Screen](https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/LoginScreen.tsx): `src/components/LoginScreen.tsx`
- [Firebase Client](https://github.com/itmoorthy/attendance_tracker/blob/main/src/firebase.ts): `src/firebase.ts`

### Attendance Workspace

- [Attendance Spreadsheet](https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/ExcelTable.tsx): `src/components/ExcelTable.tsx`
- [Calendar Planner](https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/CalendarPlanner.tsx): `src/components/CalendarPlanner.tsx`
- [Attendance Summary](https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/DashboardStats.tsx): `src/components/DashboardStats.tsx`
- [Attendance Charts](https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/VisualizationCharts.tsx): `src/components/VisualizationCharts.tsx`
- [Formula Guide](https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/FormulaGuide.tsx): `src/components/FormulaGuide.tsx`
- [Attendance Chatbot](https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/AttendanceChatbot.tsx): `src/components/AttendanceChatbot.tsx`

### Team Management

- [Manager Dashboard](https://github.com/itmoorthy/attendance_tracker/blob/main/src/components/ManagerDashboard.tsx): `src/components/ManagerDashboard.tsx`

### Attendance Logic

- [Attendance Data Types](https://github.com/itmoorthy/attendance_tracker/blob/main/src/types.ts): `src/types.ts`
- [Calculations and Spreadsheet Tools](https://github.com/itmoorthy/attendance_tracker/blob/main/src/utils.ts): `src/utils.ts`

### Other components

- **Employee or Manager**
- **Firestore**

## Connections

- React Entry → App State and Routing: renders (evidence: `src/main.tsx`)
- App State and Routing → Sign-in Screen: renders (evidence: `src/App.tsx`)
- App State and Routing → Attendance Spreadsheet: renders (evidence: `src/App.tsx`)
- App State and Routing → Calendar Planner: uses (evidence: `src/App.tsx`)
- App State and Routing → Attendance Summary: renders (evidence: `src/App.tsx`)
- App State and Routing → Attendance Charts: uses (evidence: `src/App.tsx`)
- App State and Routing → Formula Guide: uses (evidence: `src/App.tsx`)
- App State and Routing → Attendance Chatbot: uses (evidence: `src/App.tsx`)
- App State and Routing → Manager Dashboard: renders (evidence: `src/App.tsx`)
- App State and Routing → Firebase Client: uses (evidence: `src/App.tsx`)
- App State and Routing → Firestore: writes (evidence: `src/App.tsx`)
- Firebase Client → Firestore: initializes (evidence: `src/firebase.ts`)
- Attendance Spreadsheet → Calculations and Spreadsheet Tools: calculates with (evidence: `src/components/ExcelTable.tsx`)
- Manager Dashboard → Calculations and Spreadsheet Tools: calculates with (evidence: `src/components/ManagerDashboard.tsx`)
- Attendance Chatbot → Calculations and Spreadsheet Tools: calculates with (evidence: `src/components/AttendanceChatbot.tsx`)
