# jsepulvedai1/clanship_client architecture

> Architecture diagram of the GitHub repository jsepulvedai1/clanship_client, 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_client
- Repository: https://github.com/jsepulvedai1/clanship_client

## Overview

This is a Flutter client app whose feature tree indicates a service marketplace: users authenticate, find professionals, and manage public job requests and proposals, with chat and account features alongside. The README is only the Flutter starter template and does not document product behavior. Dart feature internals were not sampled, so workflow links are shown as dashed and unverified; native platform runners and generated plugin registrants are excluded as hosting infrastructure.

Main entry points: [`lib/features/home`](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/home) (Professional search), [`lib/features/jobs`](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/jobs) (Job requests), [`lib/main.dart`](https://github.com/jsepulvedai1/clanship_client/blob/main/lib/main.dart) (Flutter app entry), [`lib/features/settings`](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/settings) (User settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_core["App foundation"]
  node_app["Flutter app entry<br/>[main.dart]"]
  node_startup["Startup and config"]
  node_dashboard["Main dashboard"]
  node_notifications["Notifications"]
  node_graphql["GraphQL service"]
  node_realtime["Jobs websocket"]
  node_localdb[("Local database")]
end

subgraph group_marketplace["Professional discovery"]
  node_home["Professional search"]
  node_explore["Map exploration"]
  node_favorites["Saved professionals"]
end

subgraph group_work["Jobs and communication"]
  node_jobs["Job requests"]
  node_chat["Messaging"]
end

subgraph group_account["Account features"]
  node_auth["Authentication"]
  node_settings["User settings"]
  node_profile["Personal information"]
end

node_user(("App user"))

node_user -.->|"opens"| node_app
node_app -.->|"initializes"| node_startup
node_user -.->|"signs in"| node_auth
node_auth -.->|"enters"| node_dashboard
node_dashboard -.->|"explores"| node_home
node_home -.->|"views map"| node_explore
node_home -.->|"saves"| node_favorites
node_home -.->|"requests service"| node_jobs
node_jobs -.->|"communicates"| node_chat
node_user -.->|"manages account"| node_settings
node_settings -.->|"edits details"| node_profile
node_home -.->|"loads data"| node_graphql
node_jobs -.->|"loads data"| node_graphql
node_jobs -.->|"receives updates"| node_realtime
node_app -.->|"handles alerts"| node_notifications
node_settings -.->|"persists settings"| node_localdb

click node_app "https://github.com/jsepulvedai1/clanship_client/blob/main/lib/main.dart"
click node_startup "https://github.com/jsepulvedai1/clanship_client/tree/main/lib/core/config"
click node_auth "https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/auth"
click node_dashboard "https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/dashboard"
click node_home "https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/home"
click node_explore "https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/explore"
click node_favorites "https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/favorites"
click node_jobs "https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/jobs"
click node_chat "https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/chat"
click node_notifications "https://github.com/jsepulvedai1/clanship_client/blob/main/lib/core/network/firebase_notification_helper.dart"
click node_settings "https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/settings"
click node_profile "https://github.com/jsepulvedai1/clanship_client/blob/main/lib/features/settings/presentation/pages/personal_info_page.dart"
click node_graphql "https://github.com/jsepulvedai1/clanship_client/blob/main/lib/core/network/graphql_service.dart"
click node_realtime "https://github.com/jsepulvedai1/clanship_client/blob/main/lib/core/network/jobs_websocket_service.dart"
click node_localdb "https://github.com/jsepulvedai1/clanship_client/blob/main/lib/core/persistence/database_helper.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_app,node_startup,node_dashboard,node_notifications,node_graphql,node_realtime,node_localdb,node_user toneBlue
class node_home,node_explore,node_favorites toneAmber
class node_jobs,node_chat toneMint
class node_auth,node_settings,node_profile toneRose
```

## Components

### App foundation

- [Flutter app entry](https://github.com/jsepulvedai1/clanship_client/blob/main/lib/main.dart): `lib/main.dart`
- [Startup and config](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/core/config): `lib/core/config`
- [Main dashboard](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/dashboard): `lib/features/dashboard`
- [Notifications](https://github.com/jsepulvedai1/clanship_client/blob/main/lib/core/network/firebase_notification_helper.dart): `lib/core/network/firebase_notification_helper.dart`
- [GraphQL service](https://github.com/jsepulvedai1/clanship_client/blob/main/lib/core/network/graphql_service.dart): `lib/core/network/graphql_service.dart`
- [Jobs websocket](https://github.com/jsepulvedai1/clanship_client/blob/main/lib/core/network/jobs_websocket_service.dart): `lib/core/network/jobs_websocket_service.dart`
- [Local database](https://github.com/jsepulvedai1/clanship_client/blob/main/lib/core/persistence/database_helper.dart): `lib/core/persistence/database_helper.dart`

### Professional discovery

- [Professional search](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/home): `lib/features/home`
- [Map exploration](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/explore): `lib/features/explore`
- [Saved professionals](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/favorites): `lib/features/favorites`

### Jobs and communication

- [Job requests](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/jobs): `lib/features/jobs`
- [Messaging](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/chat): `lib/features/chat`

### Account features

- [Authentication](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/auth): `lib/features/auth`
- [User settings](https://github.com/jsepulvedai1/clanship_client/tree/main/lib/features/settings): `lib/features/settings`
- [Personal information](https://github.com/jsepulvedai1/clanship_client/blob/main/lib/features/settings/presentation/pages/personal_info_page.dart): `lib/features/settings/presentation/pages/personal_info_page.dart`

### Other components

- **App user**

## Connections

- App user → Flutter app entry: opens
- Flutter app entry → Startup and config: initializes
- App user → Authentication: signs in
- Authentication → Main dashboard: enters
- Main dashboard → Professional search: explores
- Professional search → Map exploration: views map
- Professional search → Saved professionals: saves
- Professional search → Job requests: requests service
- Job requests → Messaging: communicates
- App user → User settings: manages account
- User settings → Personal information: edits details
- Professional search → GraphQL service: loads data
- Job requests → GraphQL service: loads data
- Job requests → Jobs websocket: receives updates
- Flutter app entry → Notifications: handles alerts
- User settings → Local database: persists settings
