# poornima2330/vouch architecture

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

- Interactive diagram: https://gitdiagram.com/poornima2330/vouch
- Repository: https://github.com/poornima2330/vouch

## Overview

Vouch is a Flutter app for workers and clients to build mutual, evidence-backed reliability records. The main user journey spans role-based onboarding, job creation and completion with proof, reciprocal ratings, and Trust Ledger profiles; clients can also discover workers. The graph includes the documented Firebase-backed data layer, client-side scoring, and server-enforced Firestore protections. Relationship detail is limited because the sampled source excerpts cover only the Linux runner, not the Dart runtime implementation.

Main entry points: [`lib/data/services/job_service.dart`](https://github.com/poornima2330/vouch/blob/main/lib/data/services/job_service.dart) (Job service), [`lib/data/services/auth_service.dart`](https://github.com/poornima2330/vouch/blob/main/lib/data/services/auth_service.dart) (Authentication service), [`lib/data/services/portfolio_service.dart`](https://github.com/poornima2330/vouch/blob/main/lib/data/services/portfolio_service.dart) (Portfolio service), [`lib/features/auth/screens/auth_screen.dart`](https://github.com/poornima2330/vouch/blob/main/lib/features/auth/screens/auth_screen.dart) (Onboarding and auth)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app_entry["App entry<br/>[main.dart]"]
  node_auth["Onboarding and auth<br/>[auth_screen.dart]"]
  node_onboarding["Profile onboarding"]
  node_dashboard["Role dashboards"]
  node_discover["Worker discovery"]
  node_settings["Theme settings"]
end

subgraph group_work_trust["Work and trust"]
  node_job_create["Job creation"]
  node_job_detail["Job lifecycle"]
  node_ratings["Two-way ratings<br/>[rating_screen.dart]"]
  node_trust_profiles["Public Trust Ledger"]
  node_worker_profile["Worker profile"]
  node_client_profile["Client profile"]
end

subgraph group_data["Data and policy"]
  node_auth_service["Authentication service<br/>[auth_service.dart]"]
  node_job_service["Job service<br/>[job_service.dart]"]
  node_portfolio_service["Portfolio service"]
  node_score_engine["Reliability scoring<br/>[score_engine.dart]"]
  node_job_model["Job records<br/>[job_model.dart]"]
  node_user_model["User records<br/>[user_model.dart]"]
  node_portfolio_model["Portfolio records"]
  node_firestore_rules["Firestore protections<br/>[firestore.rules]"]
end

subgraph group_shared["Shared UI"]
  node_reliability_ring["Reliability Ring"]
  node_adaptive_shell["Adaptive navigation"]
end

node_user(("Worker or client"))
node_firebase[("Firebase Auth and Firestore")]

node_user -->|"opens app"| node_app_entry
node_user -->|"signs in"| node_auth
node_user -->|"sets up profile"| node_onboarding
node_user -->|"uses dashboard"| node_dashboard
node_user -->|"browses workers"| node_discover
node_user -->|"creates job"| node_job_create
node_user -->|"updates job"| node_job_detail
node_user -->|"rates counterparty"| node_ratings
node_user -->|"views ledger"| node_trust_profiles
node_user -->|"changes theme"| node_settings
node_auth -.->|"uses"| node_auth_service
node_auth_service -->|"authenticates with"| node_firebase
node_job_create -.->|"uses"| node_job_service
node_job_detail -.->|"uses"| node_job_service
node_ratings -.->|"records ratings"| node_job_service
node_job_service -.->|"stores job data"| node_firebase
node_portfolio_service -.->|"stores portfolio data"| node_firebase
node_score_engine -.->|"scores completed jobs"| node_job_model
node_job_service -.->|"uses records"| node_job_model
node_portfolio_service -.->|"uses records"| node_portfolio_model
node_auth_service -.->|"uses records"| node_user_model
node_firestore_rules -->|"enforces access and locks"| node_firebase
node_trust_profiles -.->|"shows score"| node_reliability_ring
node_dashboard -.->|"uses navigation"| node_adaptive_shell

click node_app_entry "https://github.com/poornima2330/vouch/blob/main/lib/main.dart"
click node_auth "https://github.com/poornima2330/vouch/blob/main/lib/features/auth/screens/auth_screen.dart"
click node_onboarding "https://github.com/poornima2330/vouch/blob/main/lib/features/auth/screens/onboarding_screen.dart"
click node_dashboard "https://github.com/poornima2330/vouch/blob/main/lib/features/dashboard/screens/home_shell_screen.dart"
click node_discover "https://github.com/poornima2330/vouch/blob/main/lib/features/discover/screens/client_discover_screen.dart"
click node_job_create "https://github.com/poornima2330/vouch/blob/main/lib/features/job/screens/job_creation_screen.dart"
click node_job_detail "https://github.com/poornima2330/vouch/blob/main/lib/features/job/screens/job_detail_screen.dart"
click node_ratings "https://github.com/poornima2330/vouch/blob/main/lib/features/job/screens/rating_screen.dart"
click node_trust_profiles "https://github.com/poornima2330/vouch/blob/main/lib/features/profile/screens/public_worker_profile_screen.dart"
click node_worker_profile "https://github.com/poornima2330/vouch/blob/main/lib/features/profile/screens/worker_profile_screen.dart"
click node_client_profile "https://github.com/poornima2330/vouch/blob/main/lib/features/profile/screens/client_profile_screen.dart"
click node_settings "https://github.com/poornima2330/vouch/blob/main/lib/features/settings/screens/settings_screen.dart"
click node_auth_service "https://github.com/poornima2330/vouch/blob/main/lib/data/services/auth_service.dart"
click node_job_service "https://github.com/poornima2330/vouch/blob/main/lib/data/services/job_service.dart"
click node_portfolio_service "https://github.com/poornima2330/vouch/blob/main/lib/data/services/portfolio_service.dart"
click node_score_engine "https://github.com/poornima2330/vouch/blob/main/lib/data/services/score_engine.dart"
click node_job_model "https://github.com/poornima2330/vouch/blob/main/lib/data/models/job_model.dart"
click node_user_model "https://github.com/poornima2330/vouch/blob/main/lib/data/models/user_model.dart"
click node_portfolio_model "https://github.com/poornima2330/vouch/blob/main/lib/data/models/portfolio_item_model.dart"
click node_firestore_rules "https://github.com/poornima2330/vouch/blob/main/firestore.rules"
click node_reliability_ring "https://github.com/poornima2330/vouch/blob/main/lib/shared/widgets/reliability_ring.dart"
click node_adaptive_shell "https://github.com/poornima2330/vouch/blob/main/lib/shared/widgets/adaptive_shell.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_entry,node_auth,node_onboarding,node_dashboard,node_discover,node_settings toneBlue
class node_job_create,node_job_detail,node_ratings,node_trust_profiles,node_worker_profile,node_client_profile,node_firebase toneAmber
class node_auth_service,node_job_service,node_portfolio_service,node_score_engine,node_job_model,node_user_model,node_portfolio_model,node_firestore_rules toneMint
class node_reliability_ring,node_adaptive_shell,node_user toneRose
```

## Components

### App experience

- [App entry](https://github.com/poornima2330/vouch/blob/main/lib/main.dart): `lib/main.dart`
- [Onboarding and auth](https://github.com/poornima2330/vouch/blob/main/lib/features/auth/screens/auth_screen.dart): `lib/features/auth/screens/auth_screen.dart`
- [Profile onboarding](https://github.com/poornima2330/vouch/blob/main/lib/features/auth/screens/onboarding_screen.dart): `lib/features/auth/screens/onboarding_screen.dart`
- [Role dashboards](https://github.com/poornima2330/vouch/blob/main/lib/features/dashboard/screens/home_shell_screen.dart): `lib/features/dashboard/screens/home_shell_screen.dart`
- [Worker discovery](https://github.com/poornima2330/vouch/blob/main/lib/features/discover/screens/client_discover_screen.dart): `lib/features/discover/screens/client_discover_screen.dart`
- [Theme settings](https://github.com/poornima2330/vouch/blob/main/lib/features/settings/screens/settings_screen.dart): `lib/features/settings/screens/settings_screen.dart`

### Work and trust

- [Job creation](https://github.com/poornima2330/vouch/blob/main/lib/features/job/screens/job_creation_screen.dart): `lib/features/job/screens/job_creation_screen.dart`
- [Job lifecycle](https://github.com/poornima2330/vouch/blob/main/lib/features/job/screens/job_detail_screen.dart): `lib/features/job/screens/job_detail_screen.dart`
- [Two-way ratings](https://github.com/poornima2330/vouch/blob/main/lib/features/job/screens/rating_screen.dart): `lib/features/job/screens/rating_screen.dart`
- [Public Trust Ledger](https://github.com/poornima2330/vouch/blob/main/lib/features/profile/screens/public_worker_profile_screen.dart): `lib/features/profile/screens/public_worker_profile_screen.dart`
- [Worker profile](https://github.com/poornima2330/vouch/blob/main/lib/features/profile/screens/worker_profile_screen.dart): `lib/features/profile/screens/worker_profile_screen.dart`
- [Client profile](https://github.com/poornima2330/vouch/blob/main/lib/features/profile/screens/client_profile_screen.dart): `lib/features/profile/screens/client_profile_screen.dart`

### Data and policy

- [Authentication service](https://github.com/poornima2330/vouch/blob/main/lib/data/services/auth_service.dart): `lib/data/services/auth_service.dart`
- [Job service](https://github.com/poornima2330/vouch/blob/main/lib/data/services/job_service.dart): `lib/data/services/job_service.dart`
- [Portfolio service](https://github.com/poornima2330/vouch/blob/main/lib/data/services/portfolio_service.dart): `lib/data/services/portfolio_service.dart`
- [Reliability scoring](https://github.com/poornima2330/vouch/blob/main/lib/data/services/score_engine.dart): `lib/data/services/score_engine.dart`
- [Job records](https://github.com/poornima2330/vouch/blob/main/lib/data/models/job_model.dart): `lib/data/models/job_model.dart`
- [User records](https://github.com/poornima2330/vouch/blob/main/lib/data/models/user_model.dart): `lib/data/models/user_model.dart`
- [Portfolio records](https://github.com/poornima2330/vouch/blob/main/lib/data/models/portfolio_item_model.dart): `lib/data/models/portfolio_item_model.dart`
- [Firestore protections](https://github.com/poornima2330/vouch/blob/main/firestore.rules): `firestore.rules`

### Shared UI

- [Reliability Ring](https://github.com/poornima2330/vouch/blob/main/lib/shared/widgets/reliability_ring.dart): `lib/shared/widgets/reliability_ring.dart`
- [Adaptive navigation](https://github.com/poornima2330/vouch/blob/main/lib/shared/widgets/adaptive_shell.dart): `lib/shared/widgets/adaptive_shell.dart`

### Other components

- **Worker or client**
- **Firebase Auth and Firestore**

## Connections

- Worker or client → App entry: opens app (evidence: `README.md`)
- Worker or client → Onboarding and auth: signs in (evidence: `README.md`)
- Worker or client → Profile onboarding: sets up profile (evidence: `README.md`)
- Worker or client → Role dashboards: uses dashboard (evidence: `README.md`)
- Worker or client → Worker discovery: browses workers (evidence: `README.md`)
- Worker or client → Job creation: creates job (evidence: `README.md`)
- Worker or client → Job lifecycle: updates job (evidence: `README.md`)
- Worker or client → Two-way ratings: rates counterparty (evidence: `README.md`)
- Worker or client → Public Trust Ledger: views ledger (evidence: `README.md`)
- Worker or client → Theme settings: changes theme (evidence: `README.md`)
- Onboarding and auth → Authentication service: uses
- Authentication service → Firebase Auth and Firestore: authenticates with (evidence: `README.md`)
- Job creation → Job service: uses
- Job lifecycle → Job service: uses
- Two-way ratings → Job service: records ratings
- Job service → Firebase Auth and Firestore: stores job data
- Portfolio service → Firebase Auth and Firestore: stores portfolio data
- Reliability scoring → Job records: scores completed jobs
- Job service → Job records: uses records
- Portfolio service → Portfolio records: uses records
- Authentication service → User records: uses records
- Firestore protections → Firebase Auth and Firestore: enforces access and locks (evidence: `README.md`)
- Public Trust Ledger → Reliability Ring: shows score
- Role dashboards → Adaptive navigation: uses navigation
