# team-dong-dantes/accommo-mobile architecture

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

- Interactive diagram: https://gitdiagram.com/team-dong-dantes/accommo-mobile
- Repository: https://github.com/team-dong-dantes/accommo-mobile

## Overview

Accommo Mobile is a student and accommodation-manager client for web and Android. Its main workflow is role-based sign-in, followed by student accommodation discovery and stay management or manager property and tenant operations. Separate capabilities include messaging, payments, accreditation and permit handling, announcements, notifications, and support. The graph follows the routing and calls shown in excerpts or the SOURCE INDEX; unsampled feature wiring is not inferred, and the shared utility node groups core helpers whose individual interactions are not all shown.

Main entry points: [`src/utils/supabase.ts`](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/utils/supabase.ts) (Supabase client), [`src/pages/manager/ManagerTenantsPage.vue`](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/manager/ManagerTenantsPage.vue) (Tenant operations), [`src/utils`](https://github.com/team-dong-dantes/accommo-mobile/tree/main/src/utils) (Core shared helpers), [`src/router/manager.ts`](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/router/manager.ts) (Manager routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_routes["App routing<br/>[routes.ts]"]
  node_manager_routes["Manager routes<br/>[manager.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_pages["Sign-in screens"]
  node_auth_store["Authentication<br/>[auth.ts]"]
end

subgraph group_student["Student experience"]
  node_student_discovery["Property discovery"]
  node_student_stay["Student stay"]
  node_student_profile["Manager profile view"]
end

subgraph group_manager["Manager operations"]
  node_manager_dashboard["Manager dashboard"]
  node_manager_tenants["Tenant operations"]
  node_accommodation_detail["Property management"]
  node_manager_accommodations["Accommodation listings"]
  node_payments["Payment review"]
  node_accreditation["Accreditation and permits"]
end

subgraph group_shared["Shared services"]
  node_messaging["Messaging<br/>[MessagesPage.vue]"]
  node_announcements["Announcements"]
  node_notifications["Notifications"]
  node_support["Support and concerns"]
  node_supabase[("Supabase client<br/>[supabase.ts]")]
  node_live_data["Live data freshness<br/>[useLiveData.ts]"]
  node_lease_api["Lease API<br/>[leases.ts]"]
  node_shared_helpers["Core shared helpers"]
  node_db_types["Database types<br/>[database.gen.ts]"]
  node_empty_state["Empty state view<br/>[EmptyState.vue]"]
  node_error_card["Error view<br/>[ErrorCard.vue]"]
end

node_user(("Student or manager"))

node_user -->|"opens app"| node_routes
node_routes -->|"routes auth"| node_auth_pages
node_routes -->|"loads routes"| node_manager_routes
node_manager_routes -->|"routes to"| node_manager_dashboard
node_manager_routes -->|"routes to"| node_manager_tenants
node_manager_routes -->|"routes to"| node_accommodation_detail
node_auth_store -->|"uses client"| node_supabase
node_auth_store -->|"uploads documents"| node_shared_helpers
node_manager_tenants -->|"loads tenant data"| node_supabase
node_manager_tenants -->|"responds to applications"| node_lease_api
node_manager_tenants -->|"requires PIN"| node_shared_helpers
node_manager_dashboard -->|"loads dashboard data"| node_supabase
node_manager_dashboard -->|"formats assets"| node_shared_helpers
node_student_profile -->|"loads profile data"| node_supabase
node_student_profile -->|"formats listing data"| node_shared_helpers
node_accreditation -->|"uploads permits"| node_shared_helpers
node_lease_api -->|"queries leases"| node_supabase
node_live_data -->|"subscribes to changes"| node_supabase
node_live_data -->|"loads cached data"| node_shared_helpers
node_payments -->|"reviews payment"| node_supabase
node_payments -->|"formats payment"| node_shared_helpers
node_db_types -->|"types client data"| node_supabase
node_manager_dashboard -->|"renders errors"| node_error_card
node_manager_tenants -->|"renders empty state"| node_empty_state
node_manager_tenants -->|"renders errors"| node_error_card

click node_routes "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/router/routes.ts"
click node_manager_routes "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/router/manager.ts"
click node_auth_pages "https://github.com/team-dong-dantes/accommo-mobile/tree/main/src/pages/auth"
click node_auth_store "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/stores/auth.ts"
click node_student_discovery "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/student/StudentDiscoverPage.vue"
click node_student_stay "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/student/StudentStayPage.vue"
click node_student_profile "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/student/StudentManagerPage.vue"
click node_manager_dashboard "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/manager/ManagerDashboard.vue"
click node_manager_tenants "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/manager/ManagerTenantsPage.vue"
click node_accommodation_detail "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/components/manager/AccommodationDetail.vue"
click node_manager_accommodations "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/manager/ManagerAccommodationsPage.vue"
click node_payments "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/components/manager/PaymentReviewSheet.vue"
click node_accreditation "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/manager/ManagerOsasPage.vue"
click node_messaging "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/shared/MessagesPage.vue"
click node_announcements "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/shared/AnnouncementPage.vue"
click node_notifications "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/shared/NotificationsPage.vue"
click node_support "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/manager/ManagerConcernsPage.vue"
click node_supabase "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/utils/supabase.ts"
click node_live_data "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/utils/useLiveData.ts"
click node_lease_api "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/api/leases.ts"
click node_shared_helpers "https://github.com/team-dong-dantes/accommo-mobile/tree/main/src/utils"
click node_db_types "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/types/database.gen.ts"
click node_empty_state "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/components/shared/EmptyState.vue"
click node_error_card "https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/components/shared/ErrorCard.vue"

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_routes,node_manager_routes toneBlue
class node_auth_pages,node_auth_store toneAmber
class node_student_discovery,node_student_stay,node_student_profile toneMint
class node_manager_dashboard,node_manager_tenants,node_accommodation_detail,node_manager_accommodations,node_payments,node_accreditation toneRose
class node_messaging,node_announcements,node_notifications,node_support,node_supabase,node_live_data,node_lease_api,node_shared_helpers,node_db_types,node_empty_state,node_error_card,node_user toneIndigo
```

## Components

### App entry

- [App routing](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/router/routes.ts): `src/router/routes.ts`
- [Manager routes](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/router/manager.ts): `src/router/manager.ts`

### Identity and access

- [Sign-in screens](https://github.com/team-dong-dantes/accommo-mobile/tree/main/src/pages/auth): `src/pages/auth`
- [Authentication](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/stores/auth.ts): `src/stores/auth.ts`

### Student experience

- [Property discovery](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/student/StudentDiscoverPage.vue): `src/pages/student/StudentDiscoverPage.vue`
- [Student stay](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/student/StudentStayPage.vue): `src/pages/student/StudentStayPage.vue`
- [Manager profile view](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/student/StudentManagerPage.vue): `src/pages/student/StudentManagerPage.vue`

### Manager operations

- [Manager dashboard](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/manager/ManagerDashboard.vue): `src/pages/manager/ManagerDashboard.vue`
- [Tenant operations](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/manager/ManagerTenantsPage.vue): `src/pages/manager/ManagerTenantsPage.vue`
- [Property management](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/components/manager/AccommodationDetail.vue): `src/components/manager/AccommodationDetail.vue`
- [Accommodation listings](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/manager/ManagerAccommodationsPage.vue): `src/pages/manager/ManagerAccommodationsPage.vue`
- [Payment review](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/components/manager/PaymentReviewSheet.vue): `src/components/manager/PaymentReviewSheet.vue`
- [Accreditation and permits](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/manager/ManagerOsasPage.vue): `src/pages/manager/ManagerOsasPage.vue`

### Shared services

- [Messaging](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/shared/MessagesPage.vue): `src/pages/shared/MessagesPage.vue`
- [Announcements](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/shared/AnnouncementPage.vue): `src/pages/shared/AnnouncementPage.vue`
- [Notifications](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/shared/NotificationsPage.vue): `src/pages/shared/NotificationsPage.vue`
- [Support and concerns](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/pages/manager/ManagerConcernsPage.vue): `src/pages/manager/ManagerConcernsPage.vue`
- [Supabase client](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/utils/supabase.ts): `src/utils/supabase.ts`
- [Live data freshness](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/utils/useLiveData.ts): `src/utils/useLiveData.ts`
- [Lease API](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/api/leases.ts): `src/api/leases.ts`
- [Core shared helpers](https://github.com/team-dong-dantes/accommo-mobile/tree/main/src/utils): `src/utils`
- [Database types](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/types/database.gen.ts): `src/types/database.gen.ts`
- [Empty state view](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/components/shared/EmptyState.vue): `src/components/shared/EmptyState.vue`
- [Error view](https://github.com/team-dong-dantes/accommo-mobile/blob/main/src/components/shared/ErrorCard.vue): `src/components/shared/ErrorCard.vue`

### Other components

- **Student or manager**

## Connections

- Student or manager → App routing: opens app (evidence: `src/router/routes.ts`)
- App routing → Sign-in screens: routes auth (evidence: `src/router/routes.ts`)
- App routing → Manager routes: loads routes (evidence: `src/router/routes.ts`)
- Manager routes → Manager dashboard: routes to (evidence: `src/router/manager.ts`)
- Manager routes → Tenant operations: routes to (evidence: `src/router/manager.ts`)
- Manager routes → Property management: routes to (evidence: `src/router/manager.ts`)
- Authentication → Supabase client: uses client (evidence: `src/stores/auth.ts`)
- Authentication → Core shared helpers: uploads documents (evidence: `src/stores/auth.ts`)
- Tenant operations → Supabase client: loads tenant data (evidence: `src/pages/manager/ManagerTenantsPage.vue`)
- Tenant operations → Lease API: responds to applications (evidence: `src/pages/manager/ManagerTenantsPage.vue`)
- Tenant operations → Core shared helpers: requires PIN (evidence: `src/pages/manager/ManagerTenantsPage.vue`)
- Manager dashboard → Supabase client: loads dashboard data (evidence: `src/pages/manager/ManagerDashboard.vue`)
- Manager dashboard → Core shared helpers: formats assets (evidence: `src/pages/manager/ManagerDashboard.vue`)
- Manager profile view → Supabase client: loads profile data (evidence: `src/pages/student/StudentManagerPage.vue`)
- Manager profile view → Core shared helpers: formats listing data (evidence: `src/pages/student/StudentManagerPage.vue`)
- Accreditation and permits → Core shared helpers: uploads permits (evidence: `src/pages/manager/ManagerOsasPage.vue`)
- Lease API → Supabase client: queries leases (evidence: `src/api/leases.ts`)
- Live data freshness → Supabase client: subscribes to changes (evidence: `src/utils/useLiveData.ts`)
- Live data freshness → Core shared helpers: loads cached data (evidence: `src/utils/useLiveData.ts`)
- Payment review → Supabase client: reviews payment (evidence: `src/components/manager/PaymentReviewSheet.vue`)
- Payment review → Core shared helpers: formats payment (evidence: `src/components/manager/PaymentReviewSheet.vue`)
- Database types → Supabase client: types client data (evidence: `src/utils/supabase.ts`)
- Manager dashboard → Error view: renders errors (evidence: `src/pages/manager/ManagerDashboard.vue`)
- Tenant operations → Empty state view: renders empty state (evidence: `src/pages/manager/ManagerTenantsPage.vue`)
- Tenant operations → Error view: renders errors (evidence: `src/pages/manager/ManagerTenantsPage.vue`)
