# aravindan-001/icore-ess architecture

> Architecture diagram of the GitHub repository aravindan-001/icore-ess, 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/aravindan-001/icore-ess
- Repository: https://github.com/aravindan-001/icore-ess

## Overview

ebaConnect is a Flutter employee self-service app with employee and HR workflows. The documented runtime path runs from UI through Riverpod state, business services, and the repository boundary to the active deterministic mock backend; SOAP transport and the client HR backend are prepared integration targets. The graph preserves the README’s major employee and HR capabilities. Source excerpts were limited to native platform runners, so feature-level links reflect documented architecture and capabilities rather than inspected Dart call sites.

Main entry points: [`lib/features`](https://github.com/aravindan-001/icore-ess/tree/main/lib/features) (Employee UI), [`lib/features/hr`](https://github.com/aravindan-001/icore-ess/tree/main/lib/features/hr) (HR administration), [`lib/services`](https://github.com/aravindan-001/icore-ess/tree/main/lib/services) (Business services), [`lib/repositories/ess_repository.dart`](https://github.com/aravindan-001/icore-ess/blob/main/lib/repositories/ess_repository.dart) (ESS repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_employee_ui["Employee UI"]
end

subgraph group_employee["Employee workflows"]
  node_dashboard["Home dashboard"]
  node_attendance["GPS attendance"]
  node_leave_requests["Leave and requests"]
  node_request_center["Unified requests"]
  node_employee_profile["Profile and documents"]
  node_payroll["Pay and payslips"]
  node_employee_services["Employee services"]
  node_notifications["Notifications"]
end

subgraph group_hr["HR workflows"]
  node_hr_ui["HR administration"]
end

subgraph group_domain["Services and data"]
  node_state["Riverpod state"]
  node_business_services["Business services"]
  node_repository_contract["ESS repository"]
  node_domain_models["Domain models"]
  node_pdf_generator["PDF generation<br/>[pdf_generator.dart]"]
end

subgraph group_integration["Backend integration"]
  node_mock_backend[("Mock repository")]
  node_soap_repository["SOAP repository"]
  node_soap_transport["SOAP transport<br/>[soap_client.dart]"]
end

node_employee_actor(("Employee"))
node_hr_actor(("HR administrator"))
node_client_backend(("Client HR backend"))

node_employee_actor -->|"uses"| node_employee_ui
node_hr_actor -->|"uses"| node_hr_ui
node_employee_ui -->|"updates state"| node_state
node_hr_ui -->|"updates state"| node_state
node_state -->|"calls"| node_business_services
node_business_services -->|"uses"| node_repository_contract
node_repository_contract -->|"defaults to"| node_mock_backend
node_repository_contract -.->|"selects for SOAP"| node_soap_repository
node_soap_repository -.->|"uses"| node_soap_transport
node_soap_transport -.->|"sends SOAP"| node_client_backend
node_employee_ui -->|"includes"| node_dashboard
node_employee_ui -->|"includes"| node_attendance
node_employee_ui -->|"includes"| node_leave_requests
node_employee_ui -->|"includes"| node_request_center
node_employee_ui -->|"includes"| node_employee_profile
node_employee_ui -->|"includes"| node_payroll
node_employee_ui -->|"includes"| node_employee_services
node_employee_ui -->|"includes"| node_notifications
node_hr_ui -->|"reviews leave"| node_leave_requests
node_business_services -.->|"uses"| node_domain_models
node_payroll -->|"generates PDFs"| node_pdf_generator

click node_employee_ui "https://github.com/aravindan-001/icore-ess/tree/main/lib/features"
click node_dashboard "https://github.com/aravindan-001/icore-ess/tree/main/lib/features/dashboard"
click node_attendance "https://github.com/aravindan-001/icore-ess/tree/main/lib/features/attendance"
click node_leave_requests "https://github.com/aravindan-001/icore-ess/tree/main/lib/features/leave"
click node_request_center "https://github.com/aravindan-001/icore-ess/tree/main/lib/features/requests"
click node_employee_profile "https://github.com/aravindan-001/icore-ess/tree/main/lib/features/profile"
click node_payroll "https://github.com/aravindan-001/icore-ess/tree/main/lib/features/pay_summary"
click node_employee_services "https://github.com/aravindan-001/icore-ess/tree/main/lib/features/services"
click node_hr_ui "https://github.com/aravindan-001/icore-ess/tree/main/lib/features/hr"
click node_notifications "https://github.com/aravindan-001/icore-ess/tree/main/lib/features/notifications"
click node_state "https://github.com/aravindan-001/icore-ess/blob/main/lib/core/providers/injection_providers.dart"
click node_business_services "https://github.com/aravindan-001/icore-ess/tree/main/lib/services"
click node_repository_contract "https://github.com/aravindan-001/icore-ess/blob/main/lib/repositories/ess_repository.dart"
click node_domain_models "https://github.com/aravindan-001/icore-ess/tree/main/lib/models"
click node_pdf_generator "https://github.com/aravindan-001/icore-ess/blob/main/lib/core/utils/pdf_generator.dart"
click node_mock_backend "https://github.com/aravindan-001/icore-ess/blob/main/lib/repositories/mock_ess_repository.dart"
click node_soap_repository "https://github.com/aravindan-001/icore-ess/blob/main/lib/repositories/soap_ess_repository.dart"
click node_soap_transport "https://github.com/aravindan-001/icore-ess/blob/main/lib/services/soap/soap_client.dart"

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_employee_ui,node_client_backend toneBlue
class node_dashboard,node_attendance,node_leave_requests,node_request_center,node_employee_profile,node_payroll,node_employee_services,node_notifications toneAmber
class node_hr_ui toneMint
class node_state,node_business_services,node_repository_contract,node_domain_models,node_pdf_generator toneRose
class node_mock_backend,node_soap_repository,node_soap_transport,node_employee_actor,node_hr_actor toneIndigo
```

## Components

### App experience

- [Employee UI](https://github.com/aravindan-001/icore-ess/tree/main/lib/features): `lib/features`

### Employee workflows

- [Home dashboard](https://github.com/aravindan-001/icore-ess/tree/main/lib/features/dashboard): `lib/features/dashboard`
- [GPS attendance](https://github.com/aravindan-001/icore-ess/tree/main/lib/features/attendance): `lib/features/attendance`
- [Leave and requests](https://github.com/aravindan-001/icore-ess/tree/main/lib/features/leave): `lib/features/leave`
- [Unified requests](https://github.com/aravindan-001/icore-ess/tree/main/lib/features/requests): `lib/features/requests`
- [Profile and documents](https://github.com/aravindan-001/icore-ess/tree/main/lib/features/profile): `lib/features/profile`
- [Pay and payslips](https://github.com/aravindan-001/icore-ess/tree/main/lib/features/pay_summary): `lib/features/pay_summary`
- [Employee services](https://github.com/aravindan-001/icore-ess/tree/main/lib/features/services): `lib/features/services`
- [Notifications](https://github.com/aravindan-001/icore-ess/tree/main/lib/features/notifications): `lib/features/notifications`

### HR workflows

- [HR administration](https://github.com/aravindan-001/icore-ess/tree/main/lib/features/hr): `lib/features/hr`

### Services and data

- [Riverpod state](https://github.com/aravindan-001/icore-ess/blob/main/lib/core/providers/injection_providers.dart): `lib/core/providers/injection_providers.dart`
- [Business services](https://github.com/aravindan-001/icore-ess/tree/main/lib/services): `lib/services`
- [ESS repository](https://github.com/aravindan-001/icore-ess/blob/main/lib/repositories/ess_repository.dart): `lib/repositories/ess_repository.dart`
- [Domain models](https://github.com/aravindan-001/icore-ess/tree/main/lib/models): `lib/models`
- [PDF generation](https://github.com/aravindan-001/icore-ess/blob/main/lib/core/utils/pdf_generator.dart): `lib/core/utils/pdf_generator.dart`

### Backend integration

- [Mock repository](https://github.com/aravindan-001/icore-ess/blob/main/lib/repositories/mock_ess_repository.dart): `lib/repositories/mock_ess_repository.dart`
- [SOAP repository](https://github.com/aravindan-001/icore-ess/blob/main/lib/repositories/soap_ess_repository.dart): `lib/repositories/soap_ess_repository.dart`
- [SOAP transport](https://github.com/aravindan-001/icore-ess/blob/main/lib/services/soap/soap_client.dart): `lib/services/soap/soap_client.dart`

### Other components

- **Employee**
- **HR administrator**
- **Client HR backend**

## Connections

- Employee → Employee UI: uses (evidence: `README.md`)
- HR administrator → HR administration: uses (evidence: `README.md`)
- Employee UI → Riverpod state: updates state (evidence: `README.md`)
- HR administration → Riverpod state: updates state (evidence: `README.md`)
- Riverpod state → Business services: calls (evidence: `README.md`)
- Business services → ESS repository: uses (evidence: `README.md`)
- ESS repository → Mock repository: defaults to (evidence: `README.md`)
- ESS repository → SOAP repository: selects for SOAP (evidence: `README.md`)
- SOAP repository → SOAP transport: uses (evidence: `README.md`)
- SOAP transport → Client HR backend: sends SOAP (evidence: `README.md`)
- Employee UI → Home dashboard: includes (evidence: `README.md`)
- Employee UI → GPS attendance: includes (evidence: `README.md`)
- Employee UI → Leave and requests: includes (evidence: `README.md`)
- Employee UI → Unified requests: includes (evidence: `README.md`)
- Employee UI → Profile and documents: includes (evidence: `README.md`)
- Employee UI → Pay and payslips: includes (evidence: `README.md`)
- Employee UI → Employee services: includes (evidence: `README.md`)
- Employee UI → Notifications: includes (evidence: `README.md`)
- HR administration → Leave and requests: reviews leave (evidence: `README.md`)
- Business services → Domain models: uses
- Pay and payslips → PDF generation: generates PDFs (evidence: `README.md`)
