# siprabin/seyal architecture

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

- Interactive diagram: https://gitdiagram.com/siprabin/seyal
- Repository: https://github.com/siprabin/seyal

## Overview

Seyal is a self-hosted team-work management application. A typical flow is that a signed-in team member works with projects and tasks, starts a day, logs task work and AI usage, and closes the day; managers monitor team activity and performance. The PHP front controller and bootstrap provide routing and shared services. The README documents additional people/access, client portal, reporting, appraisal, backup, language, and notification capabilities. Several subsystem paths are based on the repository tree and README; their internal call relationships were not sampled, so those links are omitted.

Main entry points: [`index.php`](https://github.com/siprabin/seyal/blob/main/index.php) (Web front controller), [`app/daylog.php`](https://github.com/siprabin/seyal/blob/main/app/daylog.php) (My Day work log), [`pages/tasks.php`](https://github.com/siprabin/seyal/blob/main/pages/tasks.php) (Tasks & subtasks), [`app/notifications.php`](https://github.com/siprabin/seyal/blob/main/app/notifications.php) (Email & Teams notices)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_work["Projects &amp; Work"]
  node_projects["Projects &amp; clients<br/>[projects.php]"]
  node_tasks["Tasks &amp; subtasks<br/>[tasks.php]"]
  node_daily_work["My Day work log<br/>[daylog.php]"]
  node_team_day["Team Day<br/>[team.php]"]
end

subgraph group_people["People &amp; Access"]
  node_people_access["Users &amp; permissions<br/>[permissions.php]"]
  node_org_chart["Organization chart<br/>[orgchart.php]"]
  node_client_portal["Client portal<br/>[portal.php]"]
end

subgraph group_insights["Performance &amp; Reports"]
  node_project_pulse["Project Pulse<br/>[overview.php]"]
  node_performance["Performance &amp; appraisals<br/>[performance.php]"]
  node_reports["Reports &amp; exports<br/>[export.php]"]
end

subgraph group_platform["Application Platform"]
  node_front_controller["Web front controller<br/>[index.php]"]
  node_bootstrap["Application bootstrap<br/>[bootstrap.php]"]
  node_database[("MySQL database")]
  node_installer["Installation wizard<br/>[index.php]"]
  node_audit["Audit trail<br/>[audit.php]"]
end

subgraph group_integrations["Notifications &amp; Integrations"]
  node_scheduler["Scheduler &amp; reminders<br/>[scheduler.php]"]
  node_notifications["Email &amp; Teams notices<br/>[notifications.php]"]
  node_mailer["PHPMailer<br/>[PHPMailer.php]"]
  node_smtp["SMTP transport<br/>[SMTP.php]"]
  node_mail_exception["Mail exceptions<br/>[Exception.php]"]
end

node_team_member(("Team member"))
node_manager(("Manager"))
node_teams_service["Microsoft Teams"]
node_smtp_service["SMTP server"]

node_team_member -->|"uses"| node_front_controller
node_manager -->|"uses"| node_front_controller
node_front_controller -->|"loads"| node_bootstrap
node_front_controller -->|"routes requests"| node_tasks
node_front_controller -->|"routes requests"| node_projects
node_front_controller -->|"routes requests"| node_daily_work
node_front_controller -->|"routes requests"| node_team_day
node_installer -->|"creates tables"| node_database
node_tasks -->|"provides work entries"| node_daily_work
node_team_day -->|"shows team status"| node_daily_work
node_people_access -->|"supplies hierarchy"| node_org_chart
node_team_member -.->|"views shared projects"| node_client_portal
node_daily_work -->|"informs scoring"| node_performance
node_tasks -->|"provides rated tasks"| node_performance
node_project_pulse -->|"links AI report"| node_reports
node_daily_work -->|"supplies work metrics"| node_project_pulse
node_daily_work -->|"sends close-day summary"| node_notifications
node_notifications -.->|"sends email"| node_mailer
node_mailer -->|"uses transport"| node_smtp
node_mailer -->|"uses exceptions"| node_mail_exception
node_smtp -.->|"sends mail"| node_smtp_service
node_notifications -->|"posts summary"| node_teams_service
node_scheduler -.->|"triggers reminders"| node_notifications
node_tasks -->|"records changes"| node_audit
node_bootstrap -->|"loads database service"| node_database

click node_front_controller "https://github.com/siprabin/seyal/blob/main/index.php"
click node_bootstrap "https://github.com/siprabin/seyal/blob/main/app/bootstrap.php"
click node_installer "https://github.com/siprabin/seyal/blob/main/install/index.php"
click node_projects "https://github.com/siprabin/seyal/blob/main/pages/projects.php"
click node_tasks "https://github.com/siprabin/seyal/blob/main/pages/tasks.php"
click node_daily_work "https://github.com/siprabin/seyal/blob/main/app/daylog.php"
click node_team_day "https://github.com/siprabin/seyal/blob/main/pages/team.php"
click node_people_access "https://github.com/siprabin/seyal/blob/main/app/permissions.php"
click node_org_chart "https://github.com/siprabin/seyal/blob/main/pages/orgchart.php"
click node_client_portal "https://github.com/siprabin/seyal/blob/main/pages/portal.php"
click node_project_pulse "https://github.com/siprabin/seyal/blob/main/pages/overview.php"
click node_performance "https://github.com/siprabin/seyal/blob/main/pages/performance.php"
click node_reports "https://github.com/siprabin/seyal/blob/main/app/export.php"
click node_audit "https://github.com/siprabin/seyal/blob/main/app/audit.php"
click node_scheduler "https://github.com/siprabin/seyal/blob/main/app/scheduler.php"
click node_notifications "https://github.com/siprabin/seyal/blob/main/app/notifications.php"
click node_mailer "https://github.com/siprabin/seyal/blob/main/lib/PHPMailer/PHPMailer.php"
click node_smtp "https://github.com/siprabin/seyal/blob/main/lib/PHPMailer/SMTP.php"
click node_mail_exception "https://github.com/siprabin/seyal/blob/main/lib/PHPMailer/Exception.php"

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_projects,node_tasks,node_daily_work,node_team_day toneBlue
class node_people_access,node_org_chart,node_client_portal toneAmber
class node_project_pulse,node_performance,node_reports,node_smtp_service toneMint
class node_front_controller,node_bootstrap,node_database,node_installer,node_audit toneRose
class node_scheduler,node_notifications,node_mailer,node_smtp,node_mail_exception,node_team_member,node_manager,node_teams_service toneIndigo
```

## Components

### Projects & Work

- [Projects & clients](https://github.com/siprabin/seyal/blob/main/pages/projects.php): `pages/projects.php`
- [Tasks & subtasks](https://github.com/siprabin/seyal/blob/main/pages/tasks.php): `pages/tasks.php`
- [My Day work log](https://github.com/siprabin/seyal/blob/main/app/daylog.php): `app/daylog.php`
- [Team Day](https://github.com/siprabin/seyal/blob/main/pages/team.php): `pages/team.php`

### People & Access

- [Users & permissions](https://github.com/siprabin/seyal/blob/main/app/permissions.php): `app/permissions.php`
- [Organization chart](https://github.com/siprabin/seyal/blob/main/pages/orgchart.php): `pages/orgchart.php`
- [Client portal](https://github.com/siprabin/seyal/blob/main/pages/portal.php): `pages/portal.php`

### Performance & Reports

- [Project Pulse](https://github.com/siprabin/seyal/blob/main/pages/overview.php): `pages/overview.php`
- [Performance & appraisals](https://github.com/siprabin/seyal/blob/main/pages/performance.php): `pages/performance.php`
- [Reports & exports](https://github.com/siprabin/seyal/blob/main/app/export.php): `app/export.php`

### Application Platform

- [Web front controller](https://github.com/siprabin/seyal/blob/main/index.php): `index.php`
- [Application bootstrap](https://github.com/siprabin/seyal/blob/main/app/bootstrap.php): `app/bootstrap.php`
- **MySQL database**
- [Installation wizard](https://github.com/siprabin/seyal/blob/main/install/index.php): `install/index.php`
- [Audit trail](https://github.com/siprabin/seyal/blob/main/app/audit.php): `app/audit.php`

### Notifications & Integrations

- [Scheduler & reminders](https://github.com/siprabin/seyal/blob/main/app/scheduler.php): `app/scheduler.php`
- [Email & Teams notices](https://github.com/siprabin/seyal/blob/main/app/notifications.php): `app/notifications.php`
- [PHPMailer](https://github.com/siprabin/seyal/blob/main/lib/PHPMailer/PHPMailer.php): `lib/PHPMailer/PHPMailer.php`
- [SMTP transport](https://github.com/siprabin/seyal/blob/main/lib/PHPMailer/SMTP.php): `lib/PHPMailer/SMTP.php`
- [Mail exceptions](https://github.com/siprabin/seyal/blob/main/lib/PHPMailer/Exception.php): `lib/PHPMailer/Exception.php`

### Other components

- **Team member**
- **Manager**
- **Microsoft Teams**
- **SMTP server**

## Connections

- Team member → Web front controller: uses
- Manager → Web front controller: uses
- Web front controller → Application bootstrap: loads (evidence: `index.php`)
- Web front controller → Tasks & subtasks: routes requests (evidence: `index.php`)
- Web front controller → Projects & clients: routes requests (evidence: `index.php`)
- Web front controller → My Day work log: routes requests (evidence: `index.php`)
- Web front controller → Team Day: routes requests (evidence: `index.php`)
- Installation wizard → MySQL database: creates tables (evidence: `install/index.php`)
- Tasks & subtasks → My Day work log: provides work entries
- Team Day → My Day work log: shows team status
- Users & permissions → Organization chart: supplies hierarchy
- Team member → Client portal: views shared projects
- My Day work log → Performance & appraisals: informs scoring
- Tasks & subtasks → Performance & appraisals: provides rated tasks
- Project Pulse → Reports & exports: links AI report
- My Day work log → Project Pulse: supplies work metrics
- My Day work log → Email & Teams notices: sends close-day summary
- Email & Teams notices → PHPMailer: sends email
- PHPMailer → SMTP transport: uses transport (evidence: `lib/PHPMailer/PHPMailer.php`)
- PHPMailer → Mail exceptions: uses exceptions (evidence: `lib/PHPMailer/PHPMailer.php`)
- SMTP transport → SMTP server: sends mail
- Email & Teams notices → Microsoft Teams: posts summary
- Scheduler & reminders → Email & Teams notices: triggers reminders
- Tasks & subtasks → Audit trail: records changes
- Application bootstrap → MySQL database: loads database service (evidence: `app/bootstrap.php`)
