# karremanoj5599-del/bh-fems architecture

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

- Interactive diagram: https://gitdiagram.com/karremanoj5599-del/bh-fems
- Repository: https://github.com/karremanoj5599-del/bh-fems

## Overview

FEMS is a field employee management system with an admin/employee web application, mobile app shells, and a FastAPI backend. The main workflow is users signing in, opening role-appropriate operational pages, and using the web client’s API layer to reach backend routes and persistent domain data. Operational areas include attendance and site execution, tasks, workforce organization, shifts, leave and expenses, and reporting. Source excerpts confirm authentication, task-page composition, attendance API calls, and backend route registration; several other domain links are documented only by the file structure, so they are not asserted as direct calls.

Main entry points: [`backend/app/main.py`](https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/main.py) (API application), [`web-admin/src/pages/tasks/TasksPage.jsx`](https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/pages/tasks/TasksPage.jsx) (Task workspace), [`backend/app/api/auth.py`](https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/api/auth.py) (Authentication routes), [`web-admin/src/App.jsx`](https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/App.jsx) (Admin web app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_web["Admin web app<br/>[App.jsx]"]
  node_task_page["Task workspace<br/>[TasksPage.jsx]"]
  node_task_views["Task views"]
  node_attendance_client["Attendance client"]
  node_api_client["HTTP client<br/>[api.js]"]
  node_mobile_admin["Admin mobile shell<br/>[MainActivity.kt]"]
  node_mobile_employee["Employee mobile shell<br/>[MainActivity.kt]"]
end

subgraph group_identity["Identity and access"]
  node_auth_context["Web auth state<br/>[AuthContext.jsx]"]
  node_auth_routes["Authentication routes<br/>[auth.py]"]
  node_security["Token security<br/>[security.py]"]
end

subgraph group_operations["Field operations"]
  node_attendance_api["Attendance routes"]
  node_tasks_api["Task routes"]
  node_task_service["Task service<br/>[task_service.py]"]
  node_site_api["Site routes<br/>[sites.py]"]
  node_shift_api["Shift routes"]
end

subgraph group_workforce["Workforce management"]
  node_leave_api["Leave routes<br/>[leaves.py]"]
  node_expense_api["Expense routes<br/>[expenses.py]"]
  node_org_api["People and org routes"]
  node_report_api["Reporting routes"]
end

subgraph group_platform["Backend platform"]
  node_app_entry["API application<br/>[main.py]"]
  node_database_session["Database sessions<br/>[database.py]"]
  node_domain_models["Domain models"]
  node_database[("SQL database")]
end

node_users(("Staff users"))

node_users -->|"use"| node_web
node_web -->|"provides auth"| node_auth_context
node_auth_context -->|"requests identity"| node_api_client
node_web -->|"routes to"| node_task_page
node_task_page -->|"renders"| node_task_views
node_task_page -->|"uses"| node_task_service
node_task_page -->|"uses"| node_attendance_client
node_attendance_client -->|"sends requests"| node_api_client
node_api_client -.->|"HTTP requests"| node_app_entry
node_mobile_admin -.->|"uses API"| node_app_entry
node_mobile_employee -.->|"uses API"| node_app_entry
node_app_entry -->|"registers routes"| node_auth_routes
node_app_entry -->|"registers routes"| node_attendance_api
node_app_entry -->|"registers routes"| node_tasks_api
node_app_entry -->|"registers routes"| node_site_api
node_app_entry -->|"registers routes"| node_shift_api
node_app_entry -->|"registers routes"| node_leave_api
node_app_entry -->|"registers routes"| node_expense_api
node_app_entry -->|"registers routes"| node_org_api
node_app_entry -.->|"registers routes"| node_report_api
node_auth_routes -->|"gets session"| node_database_session
node_auth_routes -->|"queries employees"| node_domain_models
node_auth_routes -->|"uses tokens"| node_security
node_database_session -->|"opens sessions"| node_database
node_domain_models -->|"maps entities"| node_database
node_tasks_api -.->|"delegates"| node_task_service

click node_web "https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/App.jsx"
click node_task_page "https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/pages/tasks/TasksPage.jsx"
click node_task_views "https://github.com/karremanoj5599-del/bh-fems/tree/main/web-admin/src/pages/tasks/components"
click node_attendance_client "https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/services/attendanceService.js"
click node_api_client "https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/services/api.js"
click node_mobile_admin "https://github.com/karremanoj5599-del/bh-fems/blob/main/mobile-admin/app/src/main/java/com/bh/fems/admin/MainActivity.kt"
click node_mobile_employee "https://github.com/karremanoj5599-del/bh-fems/blob/main/mobile-employee/app/src/main/java/com/bh/fems/employee/MainActivity.kt"
click node_auth_context "https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/context/AuthContext.jsx"
click node_auth_routes "https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/api/auth.py"
click node_security "https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/core/security.py"
click node_attendance_api "https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/api/attendance"
click node_tasks_api "https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/api/tasks"
click node_task_service "https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/services/task_service.py"
click node_site_api "https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/api/sites.py"
click node_shift_api "https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/api/shifts"
click node_leave_api "https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/api/leaves.py"
click node_expense_api "https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/api/expenses.py"
click node_org_api "https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/api"
click node_report_api "https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/api/reports"
click node_app_entry "https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/main.py"
click node_database_session "https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/core/database.py"
click node_domain_models "https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/models"

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_web,node_task_page,node_task_views,node_attendance_client,node_api_client,node_mobile_admin,node_mobile_employee,node_users toneBlue
class node_auth_context,node_auth_routes,node_security toneAmber
class node_attendance_api,node_tasks_api,node_task_service,node_site_api,node_shift_api toneMint
class node_leave_api,node_expense_api,node_org_api,node_report_api toneRose
class node_app_entry,node_database_session,node_domain_models,node_database toneIndigo
```

## Components

### User clients

- [Admin web app](https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/App.jsx): `web-admin/src/App.jsx`
- [Task workspace](https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/pages/tasks/TasksPage.jsx): `web-admin/src/pages/tasks/TasksPage.jsx`
- [Task views](https://github.com/karremanoj5599-del/bh-fems/tree/main/web-admin/src/pages/tasks/components): `web-admin/src/pages/tasks/components`
- [Attendance client](https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/services/attendanceService.js): `web-admin/src/services/attendanceService.js`
- [HTTP client](https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/services/api.js): `web-admin/src/services/api.js`
- [Admin mobile shell](https://github.com/karremanoj5599-del/bh-fems/blob/main/mobile-admin/app/src/main/java/com/bh/fems/admin/MainActivity.kt): `mobile-admin/app/src/main/java/com/bh/fems/admin/MainActivity.kt`
- [Employee mobile shell](https://github.com/karremanoj5599-del/bh-fems/blob/main/mobile-employee/app/src/main/java/com/bh/fems/employee/MainActivity.kt): `mobile-employee/app/src/main/java/com/bh/fems/employee/MainActivity.kt`

### Identity and access

- [Web auth state](https://github.com/karremanoj5599-del/bh-fems/blob/main/web-admin/src/context/AuthContext.jsx): `web-admin/src/context/AuthContext.jsx`
- [Authentication routes](https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/api/auth.py): `backend/app/api/auth.py`
- [Token security](https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/core/security.py): `backend/app/core/security.py`

### Field operations

- [Attendance routes](https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/api/attendance): `backend/app/api/attendance`
- [Task routes](https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/api/tasks): `backend/app/api/tasks`
- [Task service](https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/services/task_service.py): `backend/app/services/task_service.py`
- [Site routes](https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/api/sites.py): `backend/app/api/sites.py`
- [Shift routes](https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/api/shifts): `backend/app/api/shifts`

### Workforce management

- [Leave routes](https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/api/leaves.py): `backend/app/api/leaves.py`
- [Expense routes](https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/api/expenses.py): `backend/app/api/expenses.py`
- [People and org routes](https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/api): `backend/app/api`
- [Reporting routes](https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/api/reports): `backend/app/api/reports`

### Backend platform

- [API application](https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/main.py): `backend/app/main.py`
- [Database sessions](https://github.com/karremanoj5599-del/bh-fems/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Domain models](https://github.com/karremanoj5599-del/bh-fems/tree/main/backend/app/models): `backend/app/models`
- **SQL database**

### Other components

- **Staff users**

## Connections

- Staff users → Admin web app: use (evidence: `web-admin/src/App.jsx`)
- Admin web app → Web auth state: provides auth (evidence: `web-admin/src/App.jsx`)
- Web auth state → HTTP client: requests identity (evidence: `web-admin/src/context/AuthContext.jsx`)
- Admin web app → Task workspace: routes to (evidence: `web-admin/src/App.jsx`)
- Task workspace → Task views: renders (evidence: `web-admin/src/pages/tasks/TasksPage.jsx`)
- Task workspace → Task service: uses (evidence: `web-admin/src/pages/tasks/TasksPage.jsx`)
- Task workspace → Attendance client: uses (evidence: `web-admin/src/pages/tasks/TasksPage.jsx`)
- Attendance client → HTTP client: sends requests (evidence: `web-admin/src/services/attendanceService.js`)
- HTTP client → API application: HTTP requests
- Admin mobile shell → API application: uses API
- Employee mobile shell → API application: uses API
- API application → Authentication routes: registers routes (evidence: `backend/app/main.py`)
- API application → Attendance routes: registers routes (evidence: `backend/app/main.py`)
- API application → Task routes: registers routes (evidence: `backend/app/main.py`)
- API application → Site routes: registers routes (evidence: `backend/app/main.py`)
- API application → Shift routes: registers routes (evidence: `backend/app/main.py`)
- API application → Leave routes: registers routes (evidence: `backend/app/main.py`)
- API application → Expense routes: registers routes (evidence: `backend/app/main.py`)
- API application → People and org routes: registers routes (evidence: `backend/app/main.py`)
- API application → Reporting routes: registers routes (evidence: `backend/app/main.py`)
- Authentication routes → Database sessions: gets session (evidence: `backend/app/api/auth.py`)
- Authentication routes → Domain models: queries employees (evidence: `backend/app/api/auth.py`)
- Authentication routes → Token security: uses tokens (evidence: `backend/app/api/auth.py`)
- Database sessions → SQL database: opens sessions (evidence: `backend/app/core/database.py`)
- Domain models → SQL database: maps entities (evidence: `backend/app/models/attendance.py`)
- Task routes → Task service: delegates
