# 1feycode/laboratory-management-system-for-haramaya-university architecture

> Architecture diagram of the GitHub repository 1feycode/laboratory-management-system-for-haramaya-university, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1feycode/laboratory-management-system-for-haramaya-university
- Repository: https://github.com/1feycode/laboratory-management-system-for-haramaya-university

## Overview

This repository currently delivers specifications and architectural blueprints, not an implemented application. The diagram summarizes the planned asset-management product: users work through a role-aware web interface and REST API, with persistent records and documented asset, transfer, maintenance, and calibration workflows. Paths point to the repository’s specifications, not runtime code. Because no source excerpts or document contents beyond the README were provided, runtime relationships are shown as unverified (dashed) rather than asserted as implemented.

Main entry points: [`docs/api/api-specification.md`](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/api/api-specification.md) (REST API), [`docs/architecture/03-frontend-architecture.md`](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/03-frontend-architecture.md) (Web interface), [`docs/architecture/06-authentication-and-security.md`](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/06-authentication-and-security.md) (Authentication and RBAC), [`docs/architecture/01-system-architecture.md`](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/01-system-architecture.md) (System architecture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interaction"]
  node_web["Web interface"]
  node_scan["QR scanning"]
end

subgraph group_services["Planned services"]
  node_api["REST API"]
  node_auth["Authentication and RBAC"]
  node_database[("Relational database")]
end

subgraph group_domain["Asset operations"]
  node_assets["Asset registry"]
  node_transfers["Asset transfers<br/>[asset-transfer.mmd]"]
  node_maintenance["Maintenance work orders"]
  node_calibration["Calibration tracking"]
end

subgraph group_specs["System specifications"]
  node_systemdesign["System architecture"]
  node_backenddesign["Backend architecture"]
  node_apidoc["API design<br/>[05-api-design.md]"]
end

node_staff(("University staff"))

node_staff -.->|"uses"| node_web
node_web -.->|"sends requests"| node_api
node_web -.->|"uses scanning"| node_scan
node_web -.->|"uses JWT"| node_auth
node_api -.->|"checks access"| node_auth
node_api -.->|"supports registration"| node_assets
node_api -.->|"supports transfers"| node_transfers
node_api -.->|"supports work orders"| node_maintenance
node_api -.->|"supports tracking"| node_calibration
node_api -.->|"persists records"| node_database
node_systemdesign -.->|"describes layers"| node_backenddesign
node_apidoc -.->|"specifies routes"| node_api

click node_web "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/03-frontend-architecture.md"
click node_scan "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/03-frontend-architecture.md"
click node_api "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/api/api-specification.md"
click node_auth "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/06-authentication-and-security.md"
click node_assets "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/workflows/asset-registration.mmd"
click node_transfers "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/workflows/asset-transfer.mmd"
click node_maintenance "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/workflows/maintenance-request.mmd"
click node_calibration "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/workflows/calibration-workflow.mmd"
click node_database "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/04-database-design.md"
click node_systemdesign "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/01-system-architecture.md"
click node_backenddesign "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/02-backend-architecture.md"
click node_apidoc "https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/05-api-design.md"

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_scan toneBlue
class node_api,node_auth,node_database toneAmber
class node_assets,node_transfers,node_maintenance,node_calibration toneMint
class node_systemdesign,node_backenddesign,node_apidoc toneRose
class node_staff toneIndigo
```

## Components

### User interaction

- [Web interface](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/03-frontend-architecture.md): `docs/architecture/03-frontend-architecture.md`
- [QR scanning](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/03-frontend-architecture.md): `docs/architecture/03-frontend-architecture.md`

### Planned services

- [REST API](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/api/api-specification.md): `docs/api/api-specification.md`
- [Authentication and RBAC](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/06-authentication-and-security.md): `docs/architecture/06-authentication-and-security.md`
- [Relational database](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/04-database-design.md): `docs/architecture/04-database-design.md`

### Asset operations

- [Asset registry](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/workflows/asset-registration.mmd): `docs/workflows/asset-registration.mmd`
- [Asset transfers](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/workflows/asset-transfer.mmd): `docs/workflows/asset-transfer.mmd`
- [Maintenance work orders](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/workflows/maintenance-request.mmd): `docs/workflows/maintenance-request.mmd`
- [Calibration tracking](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/workflows/calibration-workflow.mmd): `docs/workflows/calibration-workflow.mmd`

### System specifications

- [System architecture](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/01-system-architecture.md): `docs/architecture/01-system-architecture.md`
- [Backend architecture](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/02-backend-architecture.md): `docs/architecture/02-backend-architecture.md`
- [API design](https://github.com/1feycode/laboratory-management-system-for-haramaya-university/blob/main/docs/architecture/05-api-design.md): `docs/architecture/05-api-design.md`

### Other components

- **University staff**

## Connections

- University staff → Web interface: uses
- Web interface → REST API: sends requests
- Web interface → QR scanning: uses scanning
- Web interface → Authentication and RBAC: uses JWT (evidence: `README.md`)
- REST API → Authentication and RBAC: checks access
- REST API → Asset registry: supports registration
- REST API → Asset transfers: supports transfers
- REST API → Maintenance work orders: supports work orders
- REST API → Calibration tracking: supports tracking
- REST API → Relational database: persists records
- System architecture → Backend architecture: describes layers (evidence: `README.md`)
- API design → REST API: specifies routes (evidence: `README.md`)