# du2711/info-b5-g3-isdts- architecture

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

- Interactive diagram: https://gitdiagram.com/du2711/info-b5-g3-isdts-
- Repository: https://github.com/du2711/info-b5-g3-isdts-

## Overview

This appears to be IntelliTrack, a Flask issue-tracking and project-management application. Its main workflow is users reporting issues into projects, then teams triaging, assigning, and moving them through a role-aware lifecycle, with activity history and in-app notifications. Separate capabilities include authentication, project and sprint planning, attachments and comments, analytics, administration, classification, and resolution assistance. The README provides no product detail; connections for unsampled route behavior are therefore shown only as unverified, while service relationships are limited to those evidenced by excerpts or the source index.

Main entry points: [`app.py`](https://github.com/du2711/info-b5-g3-isdts-/blob/main/app.py) (Flask application), [`services/analytics_service.py`](https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/analytics_service.py) (Analytics), [`services/issue_service.py`](https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/issue_service.py) (Issue operations), [`services/notification_service.py`](https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/notification_service.py) (In-app notifications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Flask application<br/>[app.py]"]
  node_auth_routes["Authentication<br/>[auth.py]"]
  node_dashboard_routes["Dashboard<br/>[dashboard.py]"]
  node_issue_routes["Issue routes<br/>[issues.py]"]
  node_project_routes["Project routes<br/>[projects.py]"]
  node_sprint_routes["Sprint routes<br/>[sprints.py]"]
  node_api_routes["API routes<br/>[api.py]"]
  node_admin_routes["Administration<br/>[admin.py]"]
end

subgraph group_issues["Issue workflow"]
  node_issue_service["Issue operations<br/>[issue_service.py]"]
  node_workflow["Workflow engine"]
  node_notifications["In-app notifications"]
  node_comments["Comments<br/>[comment.py]"]
  node_attachments["Attachments<br/>[attachment.py]"]
end

subgraph group_planning["Projects and planning"]
  node_projects["Projects and membership<br/>[project.py]"]
  node_sprints["Sprint planning<br/>[sprint.py]"]
  node_releases["Releases<br/>[release.py]"]
end

subgraph group_insights["Insights and assistance"]
  node_analytics["Analytics"]
  node_classification["Issue classification"]
  node_resolution["Resolution assistant"]
end

subgraph group_domain["Domain and persistence"]
  node_issue_model[("Issues<br/>[issue.py]")]
  node_activity[("Activity history<br/>[activity.py]")]
  node_notification_model[("Notification records<br/>[notification.py]")]
  node_users[("Users and roles<br/>[user.py]")]
  node_extensions["Database and auth extensions<br/>[extensions.py]"]
end

node_user_actor(("User"))

node_user_actor -.->|"uses"| node_app
node_app -.->|"registers"| node_auth_routes
node_app -.->|"registers"| node_dashboard_routes
node_app -.->|"registers"| node_issue_routes
node_app -.->|"registers"| node_project_routes
node_app -.->|"registers"| node_sprint_routes
node_app -.->|"registers"| node_api_routes
node_app -.->|"registers"| node_admin_routes
node_issue_service -->|"creates and queries"| node_issue_model
node_issue_service -->|"records changes"| node_activity
node_issue_service -->|"notifies assignee"| node_notifications
node_workflow -->|"transitions"| node_issue_model
node_workflow -->|"records transition"| node_activity
node_workflow -->|"notifies status change"| node_notifications
node_notifications -->|"creates and queries"| node_notification_model
node_notifications -->|"checks membership"| node_projects
node_analytics -->|"queries metrics"| node_issue_model
node_analytics -->|"compares projects"| node_projects
node_analytics -->|"measures workload"| node_users
node_analytics -->|"measures completion"| node_sprints
node_resolution -->|"uses classification"| node_classification
node_resolution -->|"uses issue operations"| node_issue_service
node_extensions -.->|"provides ORM"| node_issue_model
node_extensions -.->|"provides login loader"| node_users

click node_app "https://github.com/du2711/info-b5-g3-isdts-/blob/main/app.py"
click node_auth_routes "https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/auth.py"
click node_dashboard_routes "https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/dashboard.py"
click node_issue_routes "https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/issues.py"
click node_project_routes "https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/projects.py"
click node_sprint_routes "https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/sprints.py"
click node_api_routes "https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/api.py"
click node_admin_routes "https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/admin.py"
click node_issue_service "https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/issue_service.py"
click node_workflow "https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/workflow_service.py"
click node_notifications "https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/notification_service.py"
click node_comments "https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/comment.py"
click node_attachments "https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/attachment.py"
click node_projects "https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/project.py"
click node_sprints "https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/sprint.py"
click node_releases "https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/release.py"
click node_analytics "https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/analytics_service.py"
click node_classification "https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/classification_service.py"
click node_resolution "https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/resolution_assistant.py"
click node_issue_model "https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/issue.py"
click node_activity "https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/activity.py"
click node_notification_model "https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/notification.py"
click node_users "https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/user.py"
click node_extensions "https://github.com/du2711/info-b5-g3-isdts-/blob/main/extensions.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_app,node_auth_routes,node_dashboard_routes,node_issue_routes,node_project_routes,node_sprint_routes,node_api_routes,node_admin_routes,node_user_actor toneBlue
class node_issue_service,node_workflow,node_notifications,node_comments,node_attachments toneAmber
class node_projects,node_sprints,node_releases toneMint
class node_analytics,node_classification,node_resolution toneRose
class node_issue_model,node_activity,node_notification_model,node_users,node_extensions toneIndigo
```

## Components

### Web application

- [Flask application](https://github.com/du2711/info-b5-g3-isdts-/blob/main/app.py): `app.py`
- [Authentication](https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/auth.py): `routes/auth.py`
- [Dashboard](https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/dashboard.py): `routes/dashboard.py`
- [Issue routes](https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/issues.py): `routes/issues.py`
- [Project routes](https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/projects.py): `routes/projects.py`
- [Sprint routes](https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/sprints.py): `routes/sprints.py`
- [API routes](https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/api.py): `routes/api.py`
- [Administration](https://github.com/du2711/info-b5-g3-isdts-/blob/main/routes/admin.py): `routes/admin.py`

### Issue workflow

- [Issue operations](https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/issue_service.py): `services/issue_service.py`
- [Workflow engine](https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/workflow_service.py): `services/workflow_service.py`
- [In-app notifications](https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/notification_service.py): `services/notification_service.py`
- [Comments](https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/comment.py): `models/comment.py`
- [Attachments](https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/attachment.py): `models/attachment.py`

### Projects and planning

- [Projects and membership](https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/project.py): `models/project.py`
- [Sprint planning](https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/sprint.py): `models/sprint.py`
- [Releases](https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/release.py): `models/release.py`

### Insights and assistance

- [Analytics](https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/analytics_service.py): `services/analytics_service.py`
- [Issue classification](https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/classification_service.py): `services/classification_service.py`
- [Resolution assistant](https://github.com/du2711/info-b5-g3-isdts-/blob/main/services/resolution_assistant.py): `services/resolution_assistant.py`

### Domain and persistence

- [Issues](https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/issue.py): `models/issue.py`
- [Activity history](https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/activity.py): `models/activity.py`
- [Notification records](https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/notification.py): `models/notification.py`
- [Users and roles](https://github.com/du2711/info-b5-g3-isdts-/blob/main/models/user.py): `models/user.py`
- [Database and auth extensions](https://github.com/du2711/info-b5-g3-isdts-/blob/main/extensions.py): `extensions.py`

### Other components

- **User**

## Connections

- User → Flask application: uses
- Flask application → Authentication: registers
- Flask application → Dashboard: registers
- Flask application → Issue routes: registers
- Flask application → Project routes: registers
- Flask application → Sprint routes: registers
- Flask application → API routes: registers
- Flask application → Administration: registers
- Issue operations → Issues: creates and queries (evidence: `services/issue_service.py`)
- Issue operations → Activity history: records changes (evidence: `services/issue_service.py`)
- Issue operations → In-app notifications: notifies assignee (evidence: `services/issue_service.py`)
- Workflow engine → Issues: transitions (evidence: `services/workflow_service.py`)
- Workflow engine → Activity history: records transition (evidence: `services/workflow_service.py`)
- Workflow engine → In-app notifications: notifies status change (evidence: `services/workflow_service.py`)
- In-app notifications → Notification records: creates and queries (evidence: `services/notification_service.py`)
- In-app notifications → Projects and membership: checks membership (evidence: `services/notification_service.py`)
- Analytics → Issues: queries metrics (evidence: `services/analytics_service.py`)
- Analytics → Projects and membership: compares projects (evidence: `services/analytics_service.py`)
- Analytics → Users and roles: measures workload (evidence: `services/analytics_service.py`)
- Analytics → Sprint planning: measures completion (evidence: `services/analytics_service.py`)
- Resolution assistant → Issue classification: uses classification (evidence: `services/resolution_assistant.py`)
- Resolution assistant → Issue operations: uses issue operations (evidence: `services/resolution_assistant.py`)
- Database and auth extensions → Issues: provides ORM (evidence: `models/issue.py`)
- Database and auth extensions → Users and roles: provides login loader (evidence: `models/user.py`)
