# senodetech/apextodo architecture

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

- Interactive diagram: https://gitdiagram.com/senodetech/apextodo
- Repository: https://github.com/senodetech/apextodo

## Overview

ApexTasks is an Angular/NestJS task-management application. Users authenticate, then manage and prioritize tasks in list or Kanban views; dashboards provide personal or executive metrics, while administrators manage users and review audit activity. The API enforces JWT and role-based access and persists tasks, users, notifications, and audit logs through TypeORM. The graph preserves README-described capabilities whose frontend implementations were not sampled. Those links are dashed where source evidence is incomplete; solid links are grounded in excerpts, the SOURCE INDEX, or README.

Main entry points: [`backend/src/app.module.ts`](https://github.com/senodetech/apextodo/blob/main/backend/src/app.module.ts) (TypeORM database), [`frontend/src/app/app.routes.ts`](https://github.com/senodetech/apextodo/blob/main/frontend/src/app/app.routes.ts) (Auth and dashboard routes), [`backend/src/auth/auth.controller.ts`](https://github.com/senodetech/apextodo/blob/main/backend/src/auth/auth.controller.ts) (Auth endpoints), [`backend/src/auth/auth.service.ts`](https://github.com/senodetech/apextodo/blob/main/backend/src/auth/auth.service.ts) (Authentication and audit)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_frontend["Application shell<br/>[app.component.ts]"]
  node_routes["Auth and dashboard routes<br/>[app.routes.ts]"]
  node_authui["Login and registration"]
  node_dashboards["Persona dashboards"]
  node_taskviews["List and Kanban views"]
  node_clientauth["Session and tokens<br/>[auth.service.ts]"]
  node_taskclient["Task API client<br/>[task.service.ts]"]
  node_notifyclient["Notification client"]
end

subgraph group_identity["Identity and access"]
  node_authcontroller["Auth endpoints<br/>[auth.controller.ts]"]
  node_authservice["Authentication and audit<br/>[auth.service.ts]"]
  node_authguards["JWT and role guards"]
end

subgraph group_work["Task management"]
  node_taskcontroller["Task endpoints"]
  node_taskservice["Task rules and metrics<br/>[tasks.service.ts]"]
end

subgraph group_admin["Administration"]
  node_usercontroller["User administration API"]
  node_userservice["User management<br/>[users.service.ts]"]
  node_notificationapi["Notifications API"]
end

subgraph group_persistence["Persistence"]
  node_taskrecord["Task records<br/>[task.entity.ts]"]
  node_userrecord["User records<br/>[user.entity.ts]"]
  node_auditrecord["Audit records<br/>[auth-log.entity.ts]"]
  node_notificationrecord["Notification records"]
  node_database[("TypeORM database<br/>[app.module.ts]")]
end

node_browser(("Workspace user"))

node_browser -->|"opens workspace"| node_frontend
node_frontend -->|"hosts routes"| node_routes
node_routes -->|"routes to"| node_authui
node_routes -->|"routes to"| node_dashboards
node_browser -.->|"manages tasks"| node_taskviews
node_authui -.->|"submits credentials"| node_clientauth
node_dashboards -.->|"requests metrics"| node_taskclient
node_taskviews -.->|"requests task data"| node_taskclient
node_clientauth -->|"calls auth API"| node_authcontroller
node_taskclient -->|"calls task API"| node_taskcontroller
node_notifyclient -.->|"calls notifications API"| node_notificationapi
node_authcontroller -->|"delegates auth"| node_authservice
node_authcontroller -->|"applies guards"| node_authguards
node_taskcontroller -->|"delegates tasks"| node_taskservice
node_taskcontroller -->|"applies JWT guard"| node_authguards
node_usercontroller -->|"delegates admin actions"| node_userservice
node_usercontroller -->|"applies access guards"| node_authguards
node_authservice -->|"reads and updates"| node_userrecord
node_authservice -->|"writes audit logs"| node_auditrecord
node_taskservice -->|"reads and writes"| node_taskrecord
node_userservice -->|"manages users"| node_userrecord
node_userservice -->|"uses notification service"| node_notificationapi
node_notificationapi -->|"persists notifications"| node_notificationrecord
node_database -->|"configures entity"| node_taskrecord
node_database -->|"configures entity"| node_userrecord
node_database -->|"configures entity"| node_auditrecord
node_database -->|"configures entity"| node_notificationrecord

click node_frontend "https://github.com/senodetech/apextodo/blob/main/frontend/src/app/app.component.ts"
click node_routes "https://github.com/senodetech/apextodo/blob/main/frontend/src/app/app.routes.ts"
click node_authui "https://github.com/senodetech/apextodo/tree/main/frontend/src/app/components/auth"
click node_dashboards "https://github.com/senodetech/apextodo/tree/main/frontend/src/app/components/dashboard"
click node_taskviews "https://github.com/senodetech/apextodo/tree/main/frontend/src/app/components"
click node_clientauth "https://github.com/senodetech/apextodo/blob/main/frontend/src/app/services/auth.service.ts"
click node_taskclient "https://github.com/senodetech/apextodo/blob/main/frontend/src/app/services/task.service.ts"
click node_notifyclient "https://github.com/senodetech/apextodo/blob/main/frontend/src/app/services/notification.service.ts"
click node_authcontroller "https://github.com/senodetech/apextodo/blob/main/backend/src/auth/auth.controller.ts"
click node_authservice "https://github.com/senodetech/apextodo/blob/main/backend/src/auth/auth.service.ts"
click node_authguards "https://github.com/senodetech/apextodo/tree/main/backend/src/auth/guards"
click node_usercontroller "https://github.com/senodetech/apextodo/blob/main/backend/src/users/users.controller.ts"
click node_userservice "https://github.com/senodetech/apextodo/blob/main/backend/src/users/users.service.ts"
click node_notificationapi "https://github.com/senodetech/apextodo/tree/main/backend/src/notifications"
click node_taskcontroller "https://github.com/senodetech/apextodo/blob/main/backend/src/tasks/tasks.controller.ts"
click node_taskservice "https://github.com/senodetech/apextodo/blob/main/backend/src/tasks/tasks.service.ts"
click node_taskrecord "https://github.com/senodetech/apextodo/blob/main/backend/src/tasks/entities/task.entity.ts"
click node_userrecord "https://github.com/senodetech/apextodo/blob/main/backend/src/users/entities/user.entity.ts"
click node_auditrecord "https://github.com/senodetech/apextodo/blob/main/backend/src/auth/entities/auth-log.entity.ts"
click node_notificationrecord "https://github.com/senodetech/apextodo/blob/main/backend/src/notifications/entities/notification.entity.ts"
click node_database "https://github.com/senodetech/apextodo/blob/main/backend/src/app.module.ts"

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_frontend,node_routes,node_authui,node_dashboards,node_taskviews,node_clientauth,node_taskclient,node_notifyclient,node_browser toneBlue
class node_authcontroller,node_authservice,node_authguards toneAmber
class node_taskcontroller,node_taskservice toneMint
class node_usercontroller,node_userservice,node_notificationapi toneRose
class node_taskrecord,node_userrecord,node_auditrecord,node_notificationrecord,node_database toneIndigo
```

## Components

### Angular client

- [Application shell](https://github.com/senodetech/apextodo/blob/main/frontend/src/app/app.component.ts): `frontend/src/app/app.component.ts`
- [Auth and dashboard routes](https://github.com/senodetech/apextodo/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Login and registration](https://github.com/senodetech/apextodo/tree/main/frontend/src/app/components/auth): `frontend/src/app/components/auth`
- [Persona dashboards](https://github.com/senodetech/apextodo/tree/main/frontend/src/app/components/dashboard): `frontend/src/app/components/dashboard`
- [List and Kanban views](https://github.com/senodetech/apextodo/tree/main/frontend/src/app/components): `frontend/src/app/components`
- [Session and tokens](https://github.com/senodetech/apextodo/blob/main/frontend/src/app/services/auth.service.ts): `frontend/src/app/services/auth.service.ts`
- [Task API client](https://github.com/senodetech/apextodo/blob/main/frontend/src/app/services/task.service.ts): `frontend/src/app/services/task.service.ts`
- [Notification client](https://github.com/senodetech/apextodo/blob/main/frontend/src/app/services/notification.service.ts): `frontend/src/app/services/notification.service.ts`

### Identity and access

- [Auth endpoints](https://github.com/senodetech/apextodo/blob/main/backend/src/auth/auth.controller.ts): `backend/src/auth/auth.controller.ts`
- [Authentication and audit](https://github.com/senodetech/apextodo/blob/main/backend/src/auth/auth.service.ts): `backend/src/auth/auth.service.ts`
- [JWT and role guards](https://github.com/senodetech/apextodo/tree/main/backend/src/auth/guards): `backend/src/auth/guards`

### Task management

- [Task endpoints](https://github.com/senodetech/apextodo/blob/main/backend/src/tasks/tasks.controller.ts): `backend/src/tasks/tasks.controller.ts`
- [Task rules and metrics](https://github.com/senodetech/apextodo/blob/main/backend/src/tasks/tasks.service.ts): `backend/src/tasks/tasks.service.ts`

### Administration

- [User administration API](https://github.com/senodetech/apextodo/blob/main/backend/src/users/users.controller.ts): `backend/src/users/users.controller.ts`
- [User management](https://github.com/senodetech/apextodo/blob/main/backend/src/users/users.service.ts): `backend/src/users/users.service.ts`
- [Notifications API](https://github.com/senodetech/apextodo/tree/main/backend/src/notifications): `backend/src/notifications`

### Persistence

- [Task records](https://github.com/senodetech/apextodo/blob/main/backend/src/tasks/entities/task.entity.ts): `backend/src/tasks/entities/task.entity.ts`
- [User records](https://github.com/senodetech/apextodo/blob/main/backend/src/users/entities/user.entity.ts): `backend/src/users/entities/user.entity.ts`
- [Audit records](https://github.com/senodetech/apextodo/blob/main/backend/src/auth/entities/auth-log.entity.ts): `backend/src/auth/entities/auth-log.entity.ts`
- [Notification records](https://github.com/senodetech/apextodo/blob/main/backend/src/notifications/entities/notification.entity.ts): `backend/src/notifications/entities/notification.entity.ts`
- [TypeORM database](https://github.com/senodetech/apextodo/blob/main/backend/src/app.module.ts): `backend/src/app.module.ts`

### Other components

- **Workspace user**

## Connections

- Workspace user → Application shell: opens workspace (evidence: `README.md`)
- Application shell → Auth and dashboard routes: hosts routes (evidence: `frontend/src/app/app.component.ts`)
- Auth and dashboard routes → Login and registration: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Auth and dashboard routes → Persona dashboards: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Workspace user → List and Kanban views: manages tasks
- Login and registration → Session and tokens: submits credentials
- Persona dashboards → Task API client: requests metrics
- List and Kanban views → Task API client: requests task data
- Session and tokens → Auth endpoints: calls auth API (evidence: `frontend/src/app/services/auth.service.ts`)
- Task API client → Task endpoints: calls task API (evidence: `README.md`)
- Notification client → Notifications API: calls notifications API
- Auth endpoints → Authentication and audit: delegates auth (evidence: `backend/src/auth/auth.controller.ts`)
- Auth endpoints → JWT and role guards: applies guards (evidence: `backend/src/auth/auth.controller.ts`)
- Task endpoints → Task rules and metrics: delegates tasks (evidence: `backend/src/tasks/tasks.controller.ts`)
- Task endpoints → JWT and role guards: applies JWT guard (evidence: `backend/src/tasks/tasks.controller.ts`)
- User administration API → User management: delegates admin actions (evidence: `backend/src/users/users.controller.ts`)
- User administration API → JWT and role guards: applies access guards (evidence: `backend/src/users/users.controller.ts`)
- Authentication and audit → User records: reads and updates (evidence: `backend/src/auth/auth.service.ts`)
- Authentication and audit → Audit records: writes audit logs (evidence: `backend/src/auth/auth.service.ts`)
- Task rules and metrics → Task records: reads and writes (evidence: `backend/src/tasks/tasks.service.ts`)
- User management → User records: manages users (evidence: `backend/src/users/users.controller.ts`)
- User management → Notifications API: uses notification service (evidence: `backend/src/users/users.service.ts`)
- Notifications API → Notification records: persists notifications (evidence: `backend/src/notifications/notifications.service.ts`)
- TypeORM database → Task records: configures entity (evidence: `backend/src/app.module.ts`)
- TypeORM database → User records: configures entity (evidence: `backend/src/app.module.ts`)
- TypeORM database → Audit records: configures entity (evidence: `backend/src/app.module.ts`)
- TypeORM database → Notification records: configures entity (evidence: `backend/src/app.module.ts`)
