# fatimaalmurtadha/healthcaresystem architecture

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

- Interactive diagram: https://gitdiagram.com/fatimaalmurtadha/healthcaresystem
- Repository: https://github.com/fatimaalmurtadha/healthcaresystem

## Overview

##### Project Type and Purpose
- This is a console-based, C#/.NET monolithic application for managing healthcare users, patients, personnel, appointments, journals, and permissions. It demonstrates OOP principles in a student practice project.

##### Main Logical Layers (Components)
a. Presentation Layer (Console UI)
- Program.cs: startup, main menu loop
- AppointmentMenu.cs: appointment-specific console menus
- RequestRegistration.cs: registration UI
b. Business Logic Layer
- SystemLogic.cs: orchestrates user workflows (login, registration, requests)
- MainAdmin.cs / LocalAdminPerm.cs: admin logic for permissions and regions
- Personnel.cs / Patient.cs: role-specific operations
c. Domain Model
- Entities and interfaces:
- IUser.cs, User.cs (if exists), Patient.cs, Personnel.cs, MainAdmin.cs
- Appointment.cs (or Appointments.cs), Journal.cs, Permissions.cs
d. Data Access Layer (Repositories)
- UserDataManager.cs, JournalDataManager.cs, AppointmentStorage.cs, PermissionsDataManager.cs
- These classes implement CRUD against plain-text files (Users.txt, Journals.txt, Appointments.txt, Permissions.txt, etc.)
e. Storage
- Flat files under project root: Users.txt, Journals.txt, Appointments.txt, Permissions.txt, Personnel.txt, Users_log.txt
- AdminPermissions.txt, other metadata text files

##### Relationships & Interactions
- UI components invoke methods on SystemLogic.
- SystemLogic delegates to role-specific classes (Patient, Personnel, Admin).
- Each role class uses one or more DataManager classes to read/write data.
- DataManager classes perform file I/O and return domain entities or collections.
- Domain entities (Appointment, Journal, User, Permission) carry business data through the layers.
- Optionally, SystemLogic logs key events to Users_log.txt via UserDataManager.

##### Architectural Patterns & Principles
- Layered Architecture: clear separation between UI, business logic, domain model, and data access.
- Repository Pattern: DataManager classes abstract persistence behind CRUD methods.
- Single Responsibility: each class has one main focus (e.g., AppointmentStorage only handles appointment persistence).
- Dependency‐inversion: interfaces (IUser) decouple code from concrete implementations.

##### Technologies & Frameworks
- .NET 8.0 SDK, C# 11
- Console Application (command-line interface)
- File-based persistence (no external DB)

##### Final Checklist
- UI → SystemLogic → Role Classes → Data Managers → Storage.
- Optional: annotate key use cases (e.g., “Request Appointment” path) on the side.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Program["Program.cs"]:::presentation
        AppointmentMenu["AppointmentMenu.cs"]:::presentation
        RequestRegistration["RequestRegistration.cs"]:::presentation
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        direction TB
        SystemLogic["SystemLogic.cs"]:::business
        MainAdmin["MainAdmin.cs"]:::business
        LocalAdminPerm["LocalAdminPerm.cs"]:::business
        PersonnelBL["Personnel.cs"]:::business
        PatientBL["Patient.cs"]:::business
    end

    %% Domain Model
    subgraph "Domain Model"
        direction TB
        IUser["«interface» IUser.cs"]:::interface
        AppointmentsDM["Appointments.cs"]:::domain
        JournalDM["Journal.cs"]:::domain
        PermissionsDM["Permissons.cs"]:::domain
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        direction TB
        UserDataManager["UserDataManager.cs"]:::dataAccess
        AppointmentStorage["AppointmentStorage.cs"]:::dataAccess
        JournalDataManager["JournalDataManger.cs"]:::dataAccess
        PermissionsDataManager["PermissionsDataManger.cs"]:::dataAccess
    end

    %% Storage
    subgraph "Storage (Flat Files)"
        direction TB
        UsersFile["Users.txt"]:::storage
        UsersLog["Users_log.txt"]:::storage
        AppointmentsFile["Appointments.txt"]:::storage
        JournalsFile["Journals.txt"]:::storage
        PermissionsFile["Permissions.txt"]:::storage
        PersonnelFile["Personnel.txt"]:::storage
        AdminPermissionsFile["AdminPermissions.txt"]:::storage
    end

    %% Connections
    Program -->|invokes| SystemLogic
    AppointmentMenu -->|invokes| SystemLogic
    RequestRegistration -->|invokes| SystemLogic

    SystemLogic -->|routes to| MainAdmin
    SystemLogic -->|routes to| LocalAdminPerm
    SystemLogic -->|routes to| PersonnelBL
    SystemLogic -->|routes to| PatientBL

    MainAdmin -->|uses| UserDataManager
    LocalAdminPerm -->|uses| UserDataManager
    PersonnelBL -->|uses| UserDataManager
    PatientBL -->|uses| UserDataManager

    PersonnelBL -->|uses| AppointmentStorage
    PatientBL -->|uses| AppointmentStorage

    PersonnelBL -->|uses| JournalDataManager
    PatientBL -->|uses| JournalDataManager

    MainAdmin -->|uses| PermissionsDataManager
    LocalAdminPerm -->|uses| PermissionsDataManager

    UserDataManager -.->|reads/writes| UsersFile
    UserDataManager -.->|logs to| UsersLog
    AppointmentStorage -.->|reads/writes| AppointmentsFile
    JournalDataManager -.->|reads/writes| JournalsFile
    PermissionsDataManager -.->|reads/writes| PermissionsFile

    %% Click Events
    click Program "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Program.cs"
    click AppointmentMenu "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/AppointmentMenu.cs"
    click RequestRegistration "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/RequestRegistration.cs"
    click SystemLogic "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/SystemLogic.cs"
    click MainAdmin "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/MainAdmin.cs"
    click LocalAdminPerm "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/LocalAdminPerm.cs"
    click PersonnelBL "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Personnel.cs"
    click PatientBL "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Patient.cs"
    click IUser "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/IUser.cs"
    click AppointmentsDM "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Appointments.cs"
    click JournalDM "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Journal.cs"
    click PermissionsDM "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Permissons.cs"
    click UserDataManager "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/UserDataManager.cs"
    click AppointmentStorage "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/AppointmentStorage.cs"
    click JournalDataManager "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/JournalDataManger.cs"
    click PermissionsDataManager "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/PermissionsDataManger.cs"
    click UsersFile "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Users.txt"
    click UsersLog "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Users_log.txt"
    click AppointmentsFile "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Appointments.txt"
    click JournalsFile "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Journals.txt"
    click PermissionsFile "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Permissions.txt"
    click PersonnelFile "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/Personnel.txt"
    click AdminPermissionsFile "https://github.com/fatimaalmurtadha/healthcaresystem/blob/main/AdminPermissions.txt"

    %% Styles
    classDef presentation fill:#D0E6FF,stroke:#000
    classDef business fill:#D0FFD6,stroke:#000
    classDef domain fill:#FFF5B1,stroke:#000
    classDef dataAccess fill:#FFD8A8,stroke:#000
    classDef storage fill:#D3D3D3,stroke:#000
    classDef interface fill:#FFF5B1,stroke-dasharray: 5 5,stroke:#000
```
