# salem-tarek/team-flow architecture

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

- Interactive diagram: https://gitdiagram.com/salem-tarek/team-flow
- Repository: https://github.com/salem-tarek/team-flow

## Overview

Team Flow is a React project-management app for managing users, teams, projects, and tasks, with relationships between those records. Users enter through login or the authenticated dashboard; routed pages provide management and profile workflows, backed by domain hooks/services and reusable listing and form components. The README also advertises mock API support and a configurable form builder. Arrows are limited to routes, imports, and calls documented in the supplied excerpts or SOURCE INDEX; unsampled service-to-API wiring is not inferred.

Main entry points: [`src/app/router/router.jsx`](https://github.com/salem-tarek/team-flow/blob/master/src/app/router/router.jsx) (Route map), [`src/layouts/DashboardLayout.jsx`](https://github.com/salem-tarek/team-flow/blob/master/src/layouts/DashboardLayout.jsx) (Dashboard layout), [`src/modules/tasks/pages/List.jsx`](https://github.com/salem-tarek/team-flow/blob/master/src/modules/tasks/pages/List.jsx) (Task management), [`src/components/GenericListing/index.tsx`](https://github.com/salem-tarek/team-flow/blob/master/src/components/GenericListing/index.tsx) (Generic listing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["App shell<br/>[App.jsx]"]
  node_router["Route map<br/>[router.jsx]"]
  node_dashboard_layout["Dashboard layout"]
  node_mock_worker["Mock service worker"]
end

subgraph group_auth["Authentication"]
  node_login["Login page<br/>[Login.jsx]"]
  node_auth_hook["Auth hooks<br/>[useAuth.js]"]
  node_auth_service["Auth service<br/>[index.js]"]
  node_auth_store[("Session store<br/>[authStore.js]")]
end

subgraph group_management["Work management"]
  node_users["User management<br/>[List.jsx]"]
  node_teams["Team management<br/>[List.jsx]"]
  node_projects["Project management<br/>[List.jsx]"]
  node_project_details["Project details<br/>[Details.jsx]"]
  node_project_edit["Project editing<br/>[AddEdit.jsx]"]
  node_tasks["Task management<br/>[List.jsx]"]
  node_profile["User profile<br/>[Profile.jsx]"]
  node_domain_hooks["Domain hooks<br/>[index.ts]"]
  node_task_hooks["Task hooks<br/>[index.ts]"]
  node_team_hooks["Team hooks<br/>[index.ts]"]
  node_user_hooks["User hooks<br/>[index.ts]"]
  node_dashboard["Dashboard overview<br/>[Overview.jsx]"]
  node_dashboard_service["Dashboard services<br/>[index.js]"]
end

subgraph group_ui["Reusable interface"]
  node_listing["Generic listing<br/>[index.tsx]"]
  node_generic_form["Form builder<br/>[GenericForm.tsx]"]
  node_field_config["Field configurations<br/>[fields.js]"]
  node_columns["Table columns<br/>[columns.tsx]"]
end

subgraph group_state["Shared state"]
  node_notifications[("Notifications")]
  node_breadcrumbs[("Breadcrumb state<br/>[breadcrumbStore.js]")]
  node_confirm_provider["Confirmation provider"]
end

node_user(("User"))

node_user -->|"opens"| node_app
node_app -->|"renders routes"| node_router
node_router -->|"routes to"| node_login
node_router -->|"routes through"| node_dashboard_layout
node_router -->|"routes to"| node_users
node_router -->|"routes to"| node_teams
node_router -->|"routes to"| node_projects
node_router -->|"routes to"| node_project_details
node_router -->|"routes to"| node_project_edit
node_router -->|"routes to"| node_tasks
node_router -->|"routes to"| node_profile
node_router -->|"routes to"| node_dashboard
node_login -->|"uses"| node_auth_hook
node_auth_hook -->|"calls"| node_auth_service
node_auth_hook -->|"updates session"| node_auth_store
node_dashboard_layout -->|"uses logout"| node_auth_hook
node_dashboard_layout -->|"reads session"| node_auth_store
node_users -->|"uses"| node_listing
node_teams -->|"uses"| node_listing
node_tasks -->|"uses"| node_listing
node_users -->|"uses"| node_user_hooks
node_teams -->|"uses"| node_team_hooks
node_tasks -->|"uses"| node_task_hooks
node_tasks -->|"uses project hooks"| node_domain_hooks
node_project_details -->|"uses"| node_domain_hooks
node_listing -->|"renders"| node_generic_form
node_listing -->|"receives columns"| node_columns
node_tasks -->|"uses task fields"| node_field_config
node_generic_form -->|"consumes configurations"| node_field_config
node_dashboard_layout -->|"uses"| node_notifications
node_app -->|"renders notifications"| node_notifications
node_dashboard_layout -->|"reads items"| node_breadcrumbs
node_dashboard_layout -->|"uses confirmations"| node_confirm_provider
node_users -->|"uses confirmations"| node_confirm_provider
node_teams -->|"uses confirmations"| node_confirm_provider
node_tasks -->|"uses confirmations"| node_confirm_provider
node_user -.->|"mocked requests"| node_mock_worker

click node_app "https://github.com/salem-tarek/team-flow/blob/master/src/app/App.jsx"
click node_router "https://github.com/salem-tarek/team-flow/blob/master/src/app/router/router.jsx"
click node_dashboard_layout "https://github.com/salem-tarek/team-flow/blob/master/src/layouts/DashboardLayout.jsx"
click node_login "https://github.com/salem-tarek/team-flow/blob/master/src/modules/auth/pages/Login.jsx"
click node_auth_hook "https://github.com/salem-tarek/team-flow/blob/master/src/modules/auth/hooks/useAuth.js"
click node_auth_service "https://github.com/salem-tarek/team-flow/blob/master/src/modules/auth/services/index.js"
click node_auth_store "https://github.com/salem-tarek/team-flow/blob/master/src/modules/auth/stores/authStore.js"
click node_users "https://github.com/salem-tarek/team-flow/blob/master/src/modules/users/pages/List.jsx"
click node_teams "https://github.com/salem-tarek/team-flow/blob/master/src/modules/teams/pages/List.jsx"
click node_projects "https://github.com/salem-tarek/team-flow/blob/master/src/modules/projects/pages/List.jsx"
click node_project_details "https://github.com/salem-tarek/team-flow/blob/master/src/modules/projects/pages/Details.jsx"
click node_project_edit "https://github.com/salem-tarek/team-flow/blob/master/src/modules/projects/pages/AddEdit.jsx"
click node_tasks "https://github.com/salem-tarek/team-flow/blob/master/src/modules/tasks/pages/List.jsx"
click node_profile "https://github.com/salem-tarek/team-flow/blob/master/src/modules/profile/pages/Profile.jsx"
click node_domain_hooks "https://github.com/salem-tarek/team-flow/blob/master/src/modules/projects/hooks/index.ts"
click node_task_hooks "https://github.com/salem-tarek/team-flow/blob/master/src/modules/tasks/hooks/index.ts"
click node_team_hooks "https://github.com/salem-tarek/team-flow/blob/master/src/modules/teams/hooks/index.ts"
click node_user_hooks "https://github.com/salem-tarek/team-flow/blob/master/src/modules/users/hooks/index.ts"
click node_dashboard "https://github.com/salem-tarek/team-flow/blob/master/src/modules/dashboard/pages/Overview.jsx"
click node_dashboard_service "https://github.com/salem-tarek/team-flow/blob/master/src/modules/dashboard/services/index.js"
click node_listing "https://github.com/salem-tarek/team-flow/blob/master/src/components/GenericListing/index.tsx"
click node_generic_form "https://github.com/salem-tarek/team-flow/blob/master/src/components/form/GenericForm.tsx"
click node_field_config "https://github.com/salem-tarek/team-flow/blob/master/src/app/constants/fields.js"
click node_columns "https://github.com/salem-tarek/team-flow/blob/master/src/app/constants/columns.tsx"
click node_notifications "https://github.com/salem-tarek/team-flow/blob/master/src/stores/notificationsStore.js"
click node_breadcrumbs "https://github.com/salem-tarek/team-flow/blob/master/src/stores/breadcrumbStore.js"
click node_confirm_provider "https://github.com/salem-tarek/team-flow/blob/master/src/app/providers/ConfirmationProvider.jsx"
click node_mock_worker "https://github.com/salem-tarek/team-flow/blob/master/public/mockServiceWorker.js"

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_router,node_dashboard_layout,node_mock_worker,node_user toneBlue
class node_login,node_auth_hook,node_auth_service,node_auth_store toneAmber
class node_users,node_teams,node_projects,node_project_details,node_project_edit,node_tasks,node_profile,node_domain_hooks,node_task_hooks,node_team_hooks,node_user_hooks,node_dashboard,node_dashboard_service toneMint
class node_listing,node_generic_form,node_field_config,node_columns toneRose
class node_notifications,node_breadcrumbs,node_confirm_provider toneIndigo
```

## Components

### Application shell

- [App shell](https://github.com/salem-tarek/team-flow/blob/master/src/app/App.jsx): `src/app/App.jsx`
- [Route map](https://github.com/salem-tarek/team-flow/blob/master/src/app/router/router.jsx): `src/app/router/router.jsx`
- [Dashboard layout](https://github.com/salem-tarek/team-flow/blob/master/src/layouts/DashboardLayout.jsx): `src/layouts/DashboardLayout.jsx`
- [Mock service worker](https://github.com/salem-tarek/team-flow/blob/master/public/mockServiceWorker.js): `public/mockServiceWorker.js`

### Authentication

- [Login page](https://github.com/salem-tarek/team-flow/blob/master/src/modules/auth/pages/Login.jsx): `src/modules/auth/pages/Login.jsx`
- [Auth hooks](https://github.com/salem-tarek/team-flow/blob/master/src/modules/auth/hooks/useAuth.js): `src/modules/auth/hooks/useAuth.js`
- [Auth service](https://github.com/salem-tarek/team-flow/blob/master/src/modules/auth/services/index.js): `src/modules/auth/services/index.js`
- [Session store](https://github.com/salem-tarek/team-flow/blob/master/src/modules/auth/stores/authStore.js): `src/modules/auth/stores/authStore.js`

### Work management

- [User management](https://github.com/salem-tarek/team-flow/blob/master/src/modules/users/pages/List.jsx): `src/modules/users/pages/List.jsx`
- [Team management](https://github.com/salem-tarek/team-flow/blob/master/src/modules/teams/pages/List.jsx): `src/modules/teams/pages/List.jsx`
- [Project management](https://github.com/salem-tarek/team-flow/blob/master/src/modules/projects/pages/List.jsx): `src/modules/projects/pages/List.jsx`
- [Project details](https://github.com/salem-tarek/team-flow/blob/master/src/modules/projects/pages/Details.jsx): `src/modules/projects/pages/Details.jsx`
- [Project editing](https://github.com/salem-tarek/team-flow/blob/master/src/modules/projects/pages/AddEdit.jsx): `src/modules/projects/pages/AddEdit.jsx`
- [Task management](https://github.com/salem-tarek/team-flow/blob/master/src/modules/tasks/pages/List.jsx): `src/modules/tasks/pages/List.jsx`
- [User profile](https://github.com/salem-tarek/team-flow/blob/master/src/modules/profile/pages/Profile.jsx): `src/modules/profile/pages/Profile.jsx`
- [Domain hooks](https://github.com/salem-tarek/team-flow/blob/master/src/modules/projects/hooks/index.ts): `src/modules/projects/hooks/index.ts`
- [Task hooks](https://github.com/salem-tarek/team-flow/blob/master/src/modules/tasks/hooks/index.ts): `src/modules/tasks/hooks/index.ts`
- [Team hooks](https://github.com/salem-tarek/team-flow/blob/master/src/modules/teams/hooks/index.ts): `src/modules/teams/hooks/index.ts`
- [User hooks](https://github.com/salem-tarek/team-flow/blob/master/src/modules/users/hooks/index.ts): `src/modules/users/hooks/index.ts`
- [Dashboard overview](https://github.com/salem-tarek/team-flow/blob/master/src/modules/dashboard/pages/Overview.jsx): `src/modules/dashboard/pages/Overview.jsx`
- [Dashboard services](https://github.com/salem-tarek/team-flow/blob/master/src/modules/dashboard/services/index.js): `src/modules/dashboard/services/index.js`

### Reusable interface

- [Generic listing](https://github.com/salem-tarek/team-flow/blob/master/src/components/GenericListing/index.tsx): `src/components/GenericListing/index.tsx`
- [Form builder](https://github.com/salem-tarek/team-flow/blob/master/src/components/form/GenericForm.tsx): `src/components/form/GenericForm.tsx`
- [Field configurations](https://github.com/salem-tarek/team-flow/blob/master/src/app/constants/fields.js): `src/app/constants/fields.js`
- [Table columns](https://github.com/salem-tarek/team-flow/blob/master/src/app/constants/columns.tsx): `src/app/constants/columns.tsx`

### Shared state

- [Notifications](https://github.com/salem-tarek/team-flow/blob/master/src/stores/notificationsStore.js): `src/stores/notificationsStore.js`
- [Breadcrumb state](https://github.com/salem-tarek/team-flow/blob/master/src/stores/breadcrumbStore.js): `src/stores/breadcrumbStore.js`
- [Confirmation provider](https://github.com/salem-tarek/team-flow/blob/master/src/app/providers/ConfirmationProvider.jsx): `src/app/providers/ConfirmationProvider.jsx`

### Other components

- **User**

## Connections

- User → App shell: opens (evidence: `src/app/App.jsx`)
- App shell → Route map: renders routes (evidence: `src/app/App.jsx`)
- Route map → Login page: routes to (evidence: `src/app/router/router.jsx`)
- Route map → Dashboard layout: routes through (evidence: `src/app/router/router.jsx`)
- Route map → User management: routes to (evidence: `src/app/router/router.jsx`)
- Route map → Team management: routes to (evidence: `src/app/router/router.jsx`)
- Route map → Project management: routes to (evidence: `src/app/router/router.jsx`)
- Route map → Project details: routes to (evidence: `src/app/router/router.jsx`)
- Route map → Project editing: routes to (evidence: `src/app/router/router.jsx`)
- Route map → Task management: routes to (evidence: `src/app/router/router.jsx`)
- Route map → User profile: routes to (evidence: `src/app/router/router.jsx`)
- Route map → Dashboard overview: routes to (evidence: `src/app/router/router.jsx`)
- Login page → Auth hooks: uses (evidence: `src/modules/auth/pages/Login.jsx`)
- Auth hooks → Auth service: calls (evidence: `src/modules/auth/hooks/useAuth.js`)
- Auth hooks → Session store: updates session (evidence: `src/modules/auth/hooks/useAuth.js`)
- Dashboard layout → Auth hooks: uses logout (evidence: `src/layouts/DashboardLayout.jsx`)
- Dashboard layout → Session store: reads session (evidence: `src/layouts/DashboardLayout.jsx`)
- User management → Generic listing: uses (evidence: `src/modules/users/pages/List.jsx`)
- Team management → Generic listing: uses (evidence: `src/modules/teams/pages/List.jsx`)
- Task management → Generic listing: uses (evidence: `src/modules/tasks/pages/List.jsx`)
- User management → User hooks: uses (evidence: `src/modules/users/pages/List.jsx`)
- Team management → Team hooks: uses (evidence: `src/modules/teams/pages/List.jsx`)
- Task management → Task hooks: uses (evidence: `src/modules/tasks/pages/List.jsx`)
- Task management → Domain hooks: uses project hooks (evidence: `src/modules/tasks/pages/List.jsx`)
- Project details → Domain hooks: uses (evidence: `src/modules/projects/pages/Details.jsx`)
- Generic listing → Form builder: renders (evidence: `src/components/GenericListing/index.tsx`)
- Generic listing → Table columns: receives columns (evidence: `src/modules/tasks/pages/List.jsx`)
- Task management → Field configurations: uses task fields (evidence: `src/modules/tasks/pages/List.jsx`)
- Form builder → Field configurations: consumes configurations (evidence: `src/modules/auth/pages/Login.jsx`)
- Dashboard layout → Notifications: uses (evidence: `src/layouts/DashboardLayout.jsx`)
- App shell → Notifications: renders notifications (evidence: `src/app/App.jsx`)
- Dashboard layout → Breadcrumb state: reads items (evidence: `src/layouts/DashboardLayout.jsx`)
- Dashboard layout → Confirmation provider: uses confirmations (evidence: `src/layouts/DashboardLayout.jsx`)
- User management → Confirmation provider: uses confirmations (evidence: `src/modules/users/pages/List.jsx`)
- Team management → Confirmation provider: uses confirmations (evidence: `src/modules/teams/pages/List.jsx`)
- Task management → Confirmation provider: uses confirmations (evidence: `src/modules/tasks/pages/List.jsx`)
- User → Mock service worker: mocked requests
