# jsepulvedai1/clanship_tradesman architecture

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

- Interactive diagram: https://gitdiagram.com/jsepulvedai1/clanship_tradesman
- Repository: https://github.com/jsepulvedai1/clanship_tradesman

## Overview

The tree identifies a Flutter tradesman app with authentication, a dashboard, job-request management, profile/settings, and chat. Its likely user workflow is to sign in, review the dashboard and incoming opportunities, manage jobs, and maintain a tradesman profile; chat is a separate capability. The README is only Flutter starter text, and the excerpts show native platform scaffolding rather than Dart feature code, so feature relationships and backend integrations cannot be verified and are not drawn.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Account access"]
  node_auth["Authentication<br/>[login_page.dart]"]
  node_splash["App launch<br/>[splash_page.dart]"]
end

subgraph group_work["Work management"]
  node_home["Dashboard<br/>[home_page.dart]"]
  node_requests["Job requests<br/>[requests_page.dart]"]
  node_opportunities["Opportunities"]
  node_active_job["Active job detail"]
  node_quote["Quote builder"]
  node_complete_job["Job completion"]
  node_completed_jobs["Completed jobs"]
  node_rejected_jobs["Rejected requests"]
end

subgraph group_engagement["Tradesman engagement"]
  node_profile["Tradesman profile<br/>[profile_page.dart]"]
  node_profile_preview["Profile preview"]
  node_documents["Profile documents"]
  node_chat["Customer chat<br/>[chat_page.dart]"]
  node_settings["Settings<br/>[settings_page.dart]"]
  node_plan["Subscription plan<br/>[my_plan_page.dart]"]
end

subgraph group_platform["App foundation"]
  node_navigation["Main navigation"]
  node_graphql["GraphQL service"]
  node_websocket["Jobs WebSocket"]
  node_notifications["Notifications"]
  node_tutorials["Tutorial guidance"]
end

node_user(("Tradesman"))

click node_auth "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/auth/presentation/pages/login_page.dart"
click node_splash "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/splash/presentation/pages/splash_page.dart"
click node_navigation "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/navigation/presentation/pages/main_shell_page.dart"
click node_home "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/home/presentation/pages/home_page.dart"
click node_requests "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/requests_page.dart"
click node_opportunities "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/opportunities_page.dart"
click node_active_job "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/active_request_detail_page.dart"
click node_quote "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/quote_builder_page.dart"
click node_complete_job "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/complete_job_page.dart"
click node_completed_jobs "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/completed_requests_page.dart"
click node_rejected_jobs "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/rejected_requests_page.dart"
click node_profile "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/profile/presentation/pages/profile_page.dart"
click node_profile_preview "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/profile/presentation/pages/profile_preview_page.dart"
click node_documents "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/profile/presentation/pages/documents_page.dart"
click node_chat "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/chat/presentation/pages/chat_page.dart"
click node_settings "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/settings/presentation/pages/settings_page.dart"
click node_plan "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/settings/presentation/pages/my_plan_page.dart"
click node_graphql "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/core/network/graphql_service.dart"
click node_websocket "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/core/network/jobs_websocket_service.dart"
click node_notifications "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/core/network/firebase_notification_helper.dart"
click node_tutorials "https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/core/services/tutorial_coordinator.dart"

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_auth,node_splash toneBlue
class node_home,node_requests,node_opportunities,node_active_job,node_quote,node_complete_job,node_completed_jobs,node_rejected_jobs toneAmber
class node_profile,node_profile_preview,node_documents,node_chat,node_settings,node_plan toneMint
class node_navigation,node_graphql,node_websocket,node_notifications,node_tutorials toneRose
class node_user toneIndigo
```

## Components

### Account access

- [Authentication](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/auth/presentation/pages/login_page.dart): `lib/features/auth/presentation/pages/login_page.dart`
- [App launch](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/splash/presentation/pages/splash_page.dart): `lib/features/splash/presentation/pages/splash_page.dart`

### Work management

- [Dashboard](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/home/presentation/pages/home_page.dart): `lib/features/home/presentation/pages/home_page.dart`
- [Job requests](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/requests_page.dart): `lib/features/requests/presentation/pages/requests_page.dart`
- [Opportunities](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/opportunities_page.dart): `lib/features/requests/presentation/pages/opportunities_page.dart`
- [Active job detail](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/active_request_detail_page.dart): `lib/features/requests/presentation/pages/active_request_detail_page.dart`
- [Quote builder](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/quote_builder_page.dart): `lib/features/requests/presentation/pages/quote_builder_page.dart`
- [Job completion](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/complete_job_page.dart): `lib/features/requests/presentation/pages/complete_job_page.dart`
- [Completed jobs](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/completed_requests_page.dart): `lib/features/requests/presentation/pages/completed_requests_page.dart`
- [Rejected requests](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/requests/presentation/pages/rejected_requests_page.dart): `lib/features/requests/presentation/pages/rejected_requests_page.dart`

### Tradesman engagement

- [Tradesman profile](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/profile/presentation/pages/profile_page.dart): `lib/features/profile/presentation/pages/profile_page.dart`
- [Profile preview](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/profile/presentation/pages/profile_preview_page.dart): `lib/features/profile/presentation/pages/profile_preview_page.dart`
- [Profile documents](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/profile/presentation/pages/documents_page.dart): `lib/features/profile/presentation/pages/documents_page.dart`
- [Customer chat](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/chat/presentation/pages/chat_page.dart): `lib/features/chat/presentation/pages/chat_page.dart`
- [Settings](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/settings/presentation/pages/settings_page.dart): `lib/features/settings/presentation/pages/settings_page.dart`
- [Subscription plan](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/settings/presentation/pages/my_plan_page.dart): `lib/features/settings/presentation/pages/my_plan_page.dart`

### App foundation

- [Main navigation](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/features/navigation/presentation/pages/main_shell_page.dart): `lib/features/navigation/presentation/pages/main_shell_page.dart`
- [GraphQL service](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/core/network/graphql_service.dart): `lib/core/network/graphql_service.dart`
- [Jobs WebSocket](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/core/network/jobs_websocket_service.dart): `lib/core/network/jobs_websocket_service.dart`
- [Notifications](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/core/network/firebase_notification_helper.dart): `lib/core/network/firebase_notification_helper.dart`
- [Tutorial guidance](https://github.com/jsepulvedai1/clanship_tradesman/blob/main/lib/core/services/tutorial_coordinator.dart): `lib/core/services/tutorial_coordinator.dart`

### Other components

- **Tradesman**
