# inf1103-team-2/project architecture

> Architecture diagram of the GitHub repository inf1103-team-2/project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/inf1103-team-2/project
- Repository: https://github.com/inf1103-team-2/project

## Overview

Biomedical equipment error-log triage accepts individual entries or imported files, enriches each record with AI (or leaves it for human assessment), applies routing and priority rules, schedules and sends alerts, and persists the result. CLI and desktop interfaces also support review, record queries, fleet summaries, and HTML/Markdown reports. The shared pipeline and report manager are the key internal orchestration layers. Some controller and integration details are represented only by README or SOURCE INDEX references, so edges are limited to those documented or evidenced relationships.

Main entry points: [`main_triage_pipeline.py`](https://github.com/inf1103-team-2/project/blob/main/main_triage_pipeline.py) (Processing pipeline), [`main_triage_app.py`](https://github.com/inf1103-team-2/project/blob/main/main_triage_app.py) (CLI controller), [`main_gui_app.py`](https://github.com/inf1103-team-2/project/blob/main/main_gui_app.py) (GUI controller), [`logic_manager_error_log.py`](https://github.com/inf1103-team-2/project/blob/main/logic_manager_error_log.py) (Error record)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interfaces"]
  node_cli["CLI menu"]
  node_gui["Desktop window"]
  node_cli_app["CLI controller<br/>[main_triage_app.py]"]
  node_gui_app["GUI controller<br/>[main_gui_app.py]"]
  node_log_reader["Log importer"]
end

subgraph group_triage["Assessment and triage"]
  node_pipeline["Processing pipeline"]
  node_ai_client["AI client"]
  node_ai_assessment["AI assessment"]
  node_human_assessment["Human assessment"]
  node_assessment["Assessment model"]
  node_error_log["Error record"]
  node_triage_engine["Routing rules"]
  node_decision["Triage decision"]
end

subgraph group_operations["Alerts and records"]
  node_scheduler["Alert scheduler"]
  node_notifier["Notifier interface"]
  node_telegram["Telegram alerts"]
  node_repository[("Record repository")]
end

subgraph group_insights["Fleet and reports"]
  node_fleet["Fleet analyzer"]
  node_report_manager["Report generation"]
  node_html_formatter["HTML formatter"]
  node_markdown_formatter["Markdown formatter"]
  node_report_formatter["Formatter interface"]
end

node_operator(("Operator"))

node_operator -->|"enters logs"| node_cli
node_operator -->|"enters logs"| node_gui
node_cli_app -->|"uses interface"| node_cli
node_gui_app -->|"uses interface"| node_gui
node_cli_app -->|"imports files"| node_log_reader
node_gui_app -->|"imports files"| node_log_reader
node_cli_app -->|"submits records"| node_pipeline
node_gui_app -->|"submits records"| node_pipeline
node_pipeline -->|"enriches records"| node_ai_client
node_pipeline -->|"evaluates records"| node_triage_engine
node_pipeline -->|"checks alerts"| node_scheduler
node_pipeline -->|"sends alerts"| node_telegram
node_pipeline -->|"uses notifiers"| node_notifier
node_pipeline -->|"loads and saves"| node_repository
node_pipeline -->|"processes records"| node_error_log
node_ai_client -->|"creates assessment"| node_ai_assessment
node_ai_assessment -->|"implements"| node_assessment
node_human_assessment -->|"implements"| node_assessment
node_error_log -->|"selects effective"| node_assessment
node_triage_engine -->|"scores assessment"| node_assessment
node_triage_engine -->|"attaches decision"| node_decision
node_error_log -->|"stores decision"| node_decision
node_repository -->|"serializes records"| node_error_log
node_cli_app -->|"queries records"| node_repository
node_gui_app -->|"queries records"| node_repository
node_cli_app -->|"summarizes fleet"| node_fleet
node_gui_app -->|"summarizes fleet"| node_fleet
node_cli_app -->|"requests reports"| node_report_manager
node_gui_app -->|"requests reports"| node_report_manager
node_report_manager -->|"summarizes logs"| node_fleet
node_report_manager -->|"selects formatter"| node_report_formatter
node_html_formatter -->|"implements"| node_report_formatter
node_markdown_formatter -->|"implements"| node_report_formatter

click node_cli "https://github.com/inf1103-team-2/project/blob/main/io_manager_console_ui.py"
click node_gui "https://github.com/inf1103-team-2/project/blob/main/io_manager_gui_window.py"
click node_cli_app "https://github.com/inf1103-team-2/project/blob/main/main_triage_app.py"
click node_gui_app "https://github.com/inf1103-team-2/project/blob/main/main_gui_app.py"
click node_log_reader "https://github.com/inf1103-team-2/project/blob/main/io_manager_log_file_reader.py"
click node_pipeline "https://github.com/inf1103-team-2/project/blob/main/main_triage_pipeline.py"
click node_ai_client "https://github.com/inf1103-team-2/project/blob/main/ai_manager_ai_client.py"
click node_ai_assessment "https://github.com/inf1103-team-2/project/blob/main/logic_manager_ai_assessment.py"
click node_human_assessment "https://github.com/inf1103-team-2/project/blob/main/logic_manager_human_assessment.py"
click node_assessment "https://github.com/inf1103-team-2/project/blob/main/logic_manager_assessment.py"
click node_error_log "https://github.com/inf1103-team-2/project/blob/main/logic_manager_error_log.py"
click node_triage_engine "https://github.com/inf1103-team-2/project/blob/main/logic_manager_triage_engine.py"
click node_decision "https://github.com/inf1103-team-2/project/blob/main/logic_manager_decision.py"
click node_scheduler "https://github.com/inf1103-team-2/project/blob/main/logic_manager_alert_scheduler.py"
click node_notifier "https://github.com/inf1103-team-2/project/blob/main/io_manager_notifier.py"
click node_telegram "https://github.com/inf1103-team-2/project/blob/main/io_manager_telegram_notifier.py"
click node_repository "https://github.com/inf1103-team-2/project/blob/main/data_manager_record_repository.py"
click node_fleet "https://github.com/inf1103-team-2/project/blob/main/logic_manager_fleet_analyzer.py"
click node_report_manager "https://github.com/inf1103-team-2/project/blob/main/io_manager_report_manager.py"
click node_html_formatter "https://github.com/inf1103-team-2/project/blob/main/io_manager_html_report_formatter.py"
click node_markdown_formatter "https://github.com/inf1103-team-2/project/blob/main/io_manager_markdown_report_formatter.py"
click node_report_formatter "https://github.com/inf1103-team-2/project/blob/main/io_manager_report_formatter.py"

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_cli,node_gui,node_cli_app,node_gui_app,node_log_reader toneBlue
class node_pipeline,node_ai_client,node_ai_assessment,node_human_assessment,node_assessment,node_error_log,node_triage_engine,node_decision toneAmber
class node_scheduler,node_notifier,node_telegram,node_repository toneMint
class node_fleet,node_report_manager,node_html_formatter,node_markdown_formatter,node_report_formatter toneRose
class node_operator toneIndigo
```

## Components

### User interfaces

- [CLI menu](https://github.com/inf1103-team-2/project/blob/main/io_manager_console_ui.py): `io_manager_console_ui.py`
- [Desktop window](https://github.com/inf1103-team-2/project/blob/main/io_manager_gui_window.py): `io_manager_gui_window.py`
- [CLI controller](https://github.com/inf1103-team-2/project/blob/main/main_triage_app.py): `main_triage_app.py`
- [GUI controller](https://github.com/inf1103-team-2/project/blob/main/main_gui_app.py): `main_gui_app.py`
- [Log importer](https://github.com/inf1103-team-2/project/blob/main/io_manager_log_file_reader.py): `io_manager_log_file_reader.py`

### Assessment and triage

- [Processing pipeline](https://github.com/inf1103-team-2/project/blob/main/main_triage_pipeline.py): `main_triage_pipeline.py`
- [AI client](https://github.com/inf1103-team-2/project/blob/main/ai_manager_ai_client.py): `ai_manager_ai_client.py`
- [AI assessment](https://github.com/inf1103-team-2/project/blob/main/logic_manager_ai_assessment.py): `logic_manager_ai_assessment.py`
- [Human assessment](https://github.com/inf1103-team-2/project/blob/main/logic_manager_human_assessment.py): `logic_manager_human_assessment.py`
- [Assessment model](https://github.com/inf1103-team-2/project/blob/main/logic_manager_assessment.py): `logic_manager_assessment.py`
- [Error record](https://github.com/inf1103-team-2/project/blob/main/logic_manager_error_log.py): `logic_manager_error_log.py`
- [Routing rules](https://github.com/inf1103-team-2/project/blob/main/logic_manager_triage_engine.py): `logic_manager_triage_engine.py`
- [Triage decision](https://github.com/inf1103-team-2/project/blob/main/logic_manager_decision.py): `logic_manager_decision.py`

### Alerts and records

- [Alert scheduler](https://github.com/inf1103-team-2/project/blob/main/logic_manager_alert_scheduler.py): `logic_manager_alert_scheduler.py`
- [Notifier interface](https://github.com/inf1103-team-2/project/blob/main/io_manager_notifier.py): `io_manager_notifier.py`
- [Telegram alerts](https://github.com/inf1103-team-2/project/blob/main/io_manager_telegram_notifier.py): `io_manager_telegram_notifier.py`
- [Record repository](https://github.com/inf1103-team-2/project/blob/main/data_manager_record_repository.py): `data_manager_record_repository.py`

### Fleet and reports

- [Fleet analyzer](https://github.com/inf1103-team-2/project/blob/main/logic_manager_fleet_analyzer.py): `logic_manager_fleet_analyzer.py`
- [Report generation](https://github.com/inf1103-team-2/project/blob/main/io_manager_report_manager.py): `io_manager_report_manager.py`
- [HTML formatter](https://github.com/inf1103-team-2/project/blob/main/io_manager_html_report_formatter.py): `io_manager_html_report_formatter.py`
- [Markdown formatter](https://github.com/inf1103-team-2/project/blob/main/io_manager_markdown_report_formatter.py): `io_manager_markdown_report_formatter.py`
- [Formatter interface](https://github.com/inf1103-team-2/project/blob/main/io_manager_report_formatter.py): `io_manager_report_formatter.py`

### Other components

- **Operator**

## Connections

- Operator → CLI menu: enters logs (evidence: `README`)
- Operator → Desktop window: enters logs (evidence: `README`)
- CLI controller → CLI menu: uses interface (evidence: `main_triage_app.py`)
- GUI controller → Desktop window: uses interface (evidence: `main_gui_app.py`)
- CLI controller → Log importer: imports files (evidence: `main_triage_app.py`)
- GUI controller → Log importer: imports files (evidence: `main_gui_app.py`)
- CLI controller → Processing pipeline: submits records (evidence: `main_triage_app.py`)
- GUI controller → Processing pipeline: submits records (evidence: `main_gui_app.py`)
- Processing pipeline → AI client: enriches records (evidence: `main_triage_pipeline.py`)
- Processing pipeline → Routing rules: evaluates records (evidence: `main_triage_pipeline.py`)
- Processing pipeline → Alert scheduler: checks alerts (evidence: `main_triage_pipeline.py`)
- Processing pipeline → Telegram alerts: sends alerts (evidence: `main_triage_pipeline.py`)
- Processing pipeline → Notifier interface: uses notifiers (evidence: `main_triage_pipeline.py`)
- Processing pipeline → Record repository: loads and saves (evidence: `main_triage_pipeline.py`)
- Processing pipeline → Error record: processes records (evidence: `main_triage_pipeline.py`)
- AI client → AI assessment: creates assessment (evidence: `ai_manager_ai_client.py`)
- AI assessment → Assessment model: implements (evidence: `logic_manager_ai_assessment.py`)
- Human assessment → Assessment model: implements (evidence: `logic_manager_human_assessment.py`)
- Error record → Assessment model: selects effective (evidence: `logic_manager_error_log.py`)
- Routing rules → Assessment model: scores assessment (evidence: `logic_manager_triage_engine.py`)
- Routing rules → Triage decision: attaches decision (evidence: `logic_manager_triage_engine.py`)
- Error record → Triage decision: stores decision (evidence: `logic_manager_error_log.py`)
- Record repository → Error record: serializes records (evidence: `data_manager_record_repository.py`)
- CLI controller → Record repository: queries records (evidence: `main_triage_app.py`)
- GUI controller → Record repository: queries records (evidence: `main_gui_app.py`)
- CLI controller → Fleet analyzer: summarizes fleet (evidence: `main_triage_app.py`)
- GUI controller → Fleet analyzer: summarizes fleet (evidence: `main_gui_app.py`)
- CLI controller → Report generation: requests reports (evidence: `main_triage_app.py`)
- GUI controller → Report generation: requests reports (evidence: `main_gui_app.py`)
- Report generation → Fleet analyzer: summarizes logs (evidence: `io_manager_report_manager.py`)
- Report generation → Formatter interface: selects formatter (evidence: `io_manager_report_manager.py`)
- HTML formatter → Formatter interface: implements (evidence: `io_manager_html_report_formatter.py`)
- Markdown formatter → Formatter interface: implements (evidence: `io_manager_markdown_report_formatter.py`)
