# joelessoh2006-hue/mon-coloc architecture

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

- Interactive diagram: https://gitdiagram.com/joelessoh2006-hue/mon-coloc
- Repository: https://github.com/joelessoh2006-hue/mon-coloc

## Overview

Mon-Coloc is a Flutter student-flatshare app backed by Firebase. Its documented user journey starts in the app, supports account/profile management, lets students find and inspect listings, and lets landlords publish housing; users can also communicate. Firestore synchronizes app data, while Paystack is a test-only payment experiment. The README describes these capabilities, but no Dart implementation excerpts were provided, so internal screen-to-service calls and navigation are shown only as unverified dashed links where useful.

Main entry points: [`lib/main.dart`](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/main.dart) (App entry), [`lib/screens/auth`](https://github.com/joelessoh2006-hue/mon-coloc/tree/main/lib/screens/auth) (Authentication), [`lib/screens/etudiant/logements_list_screen.dart`](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/etudiant/logements_list_screen.dart) (Listing search), [`lib/services/auth_service.dart`](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/auth_service.dart) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and accounts"]
  node_entry["App entry<br/>[main.dart]"]
  node_auth["Authentication"]
  node_account["Profile management"]
  node_auth_service["Auth service<br/>[auth_service.dart]"]
  node_user_service["User service<br/>[user_service.dart]"]
  node_models["Domain models"]
end

subgraph group_housing["Housing discovery"]
  node_discovery["Listing search"]
  node_listing_detail["Listing details"]
  node_housing_service["Matching service"]
  node_landlord["Listing publication"]
  node_landlord_management["Listing management"]
  node_admin["Admin oversight"]
end

subgraph group_engagement["Communication and integrations"]
  node_messaging["User messaging<br/>[chat_screen.dart]"]
  node_chat_service["Chat service<br/>[chat_service.dart]"]
  node_team["Colocation teams"]
  node_team_service["Team service"]
  node_visits["Visit scheduling"]
  node_visit_service["Visit service"]
  node_firebase[("Firebase services")]
  node_paystack{{"Paystack test API"}}
end

node_user(("App user"))

node_user -->|"opens app"| node_entry
node_entry -.->|"routes to"| node_auth
node_entry -.->|"routes to"| node_discovery
node_user -->|"publishes listing"| node_landlord
node_user -->|"searches listings"| node_discovery
node_discovery -.->|"opens listing"| node_listing_detail
node_user -->|"authenticates"| node_auth
node_auth -.->|"uses"| node_auth_service
node_auth_service -->|"authenticates with"| node_firebase
node_account -.->|"uses"| node_user_service
node_user_service -->|"syncs data"| node_firebase
node_housing_service -->|"syncs data"| node_firebase
node_landlord_management -.->|"syncs data"| node_firebase
node_messaging -.->|"uses"| node_chat_service
node_chat_service -->|"syncs data"| node_firebase
node_team -.->|"uses"| node_team_service
node_visits -.->|"uses"| node_visit_service
node_user -->|"exchanges messages"| node_messaging
node_user -->|"tests payment flow"| node_paystack

click node_entry "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/main.dart"
click node_auth "https://github.com/joelessoh2006-hue/mon-coloc/tree/main/lib/screens/auth"
click node_account "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/mon_profil_screen.dart"
click node_auth_service "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/auth_service.dart"
click node_user_service "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/user_service.dart"
click node_models "https://github.com/joelessoh2006-hue/mon-coloc/tree/main/lib/models"
click node_discovery "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/etudiant/logements_list_screen.dart"
click node_listing_detail "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/etudiant/logement_detail_screen.dart"
click node_housing_service "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/matching_service.dart"
click node_landlord "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/bailleur/add_logement_screen.dart"
click node_landlord_management "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/bailleur/manage_logements_screen.dart"
click node_admin "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/admin/admin_dashboard_screen.dart"
click node_messaging "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/chat_screen.dart"
click node_chat_service "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/chat_service.dart"
click node_team "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/etudiant/mon_equipe_screen.dart"
click node_team_service "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/equipe_service.dart"
click node_visits "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/bailleur/bailleur_visits_screen.dart"
click node_visit_service "https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/visite_service.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_entry,node_auth,node_account,node_auth_service,node_user_service,node_models,node_user toneBlue
class node_discovery,node_listing_detail,node_housing_service,node_landlord,node_landlord_management,node_admin toneAmber
class node_messaging,node_chat_service,node_team,node_team_service,node_visits,node_visit_service,node_firebase,node_paystack toneMint
```

## Components

### App and accounts

- [App entry](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/main.dart): `lib/main.dart`
- [Authentication](https://github.com/joelessoh2006-hue/mon-coloc/tree/main/lib/screens/auth): `lib/screens/auth`
- [Profile management](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/mon_profil_screen.dart): `lib/screens/mon_profil_screen.dart`
- [Auth service](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/auth_service.dart): `lib/services/auth_service.dart`
- [User service](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/user_service.dart): `lib/services/user_service.dart`
- [Domain models](https://github.com/joelessoh2006-hue/mon-coloc/tree/main/lib/models): `lib/models`

### Housing discovery

- [Listing search](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/etudiant/logements_list_screen.dart): `lib/screens/etudiant/logements_list_screen.dart`
- [Listing details](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/etudiant/logement_detail_screen.dart): `lib/screens/etudiant/logement_detail_screen.dart`
- [Matching service](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/matching_service.dart): `lib/services/matching_service.dart`
- [Listing publication](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/bailleur/add_logement_screen.dart): `lib/screens/bailleur/add_logement_screen.dart`
- [Listing management](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/bailleur/manage_logements_screen.dart): `lib/screens/bailleur/manage_logements_screen.dart`
- [Admin oversight](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/admin/admin_dashboard_screen.dart): `lib/screens/admin/admin_dashboard_screen.dart`

### Communication and integrations

- [User messaging](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/chat_screen.dart): `lib/screens/chat_screen.dart`
- [Chat service](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/chat_service.dart): `lib/services/chat_service.dart`
- [Colocation teams](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/etudiant/mon_equipe_screen.dart): `lib/screens/etudiant/mon_equipe_screen.dart`
- [Team service](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/equipe_service.dart): `lib/services/equipe_service.dart`
- [Visit scheduling](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/screens/bailleur/bailleur_visits_screen.dart): `lib/screens/bailleur/bailleur_visits_screen.dart`
- [Visit service](https://github.com/joelessoh2006-hue/mon-coloc/blob/main/lib/services/visite_service.dart): `lib/services/visite_service.dart`
- **Firebase services**
- **Paystack test API**

### Other components

- **App user**

## Connections

- App user → App entry: opens app (evidence: `README.md`)
- App entry → Authentication: routes to
- App entry → Listing search: routes to
- App user → Listing publication: publishes listing (evidence: `README.md`)
- App user → Listing search: searches listings (evidence: `README.md`)
- Listing search → Listing details: opens listing
- App user → Authentication: authenticates (evidence: `README.md`)
- Authentication → Auth service: uses
- Auth service → Firebase services: authenticates with (evidence: `README.md`)
- Profile management → User service: uses
- User service → Firebase services: syncs data (evidence: `README.md`)
- Matching service → Firebase services: syncs data (evidence: `README.md`)
- Listing management → Firebase services: syncs data
- User messaging → Chat service: uses
- Chat service → Firebase services: syncs data (evidence: `README.md`)
- Colocation teams → Team service: uses
- Visit scheduling → Visit service: uses
- App user → User messaging: exchanges messages (evidence: `README.md`)
- App user → Paystack test API: tests payment flow (evidence: `README.md`)
