# teamsternritters-a11y/requora architecture

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

- Interactive diagram: https://gitdiagram.com/teamsternritters-a11y/requora
- Repository: https://github.com/teamsternritters-a11y/requora

## Overview

ReverseMarket is a needs-first marketplace: customers publish requirements, providers discover them and submit offers, and customers compare matches before choosing a provider. The app then supports payment, order delivery, completion, and reviews. Supabase provides authentication and persistence; hooks expose auth and notifications to the UI, while services encapsulate marketplace operations. The graph preserves the documented matching and real-time notification capabilities. Some pages and service implementations were not sampled, so their edges reflect indexed imports or documented behavior only.

Main entry points: [`src/lib/supabase.ts`](https://github.com/teamsternritters-a11y/requora/blob/main/src/lib/supabase.ts) (Supabase client), [`src/App.tsx`](https://github.com/teamsternritters-a11y/requora/blob/main/src/App.tsx) (Route application), [`src/services/offersService.ts`](https://github.com/teamsternritters-a11y/requora/blob/main/src/services/offersService.ts) (Offer service), [`src/services/requirementsService.ts`](https://github.com/teamsternritters-a11y/requora/blob/main/src/services/requirementsService.ts) (Requirement service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["App and access"]
  node_app["Route application<br/>[App.tsx]"]
  node_auth["Auth context<br/>[useAuth.tsx]"]
end

subgraph group_marketplace["Marketplace workflow"]
  node_customerreq["Customer requirements"]
  node_reqservice["Requirement service"]
  node_browse["Requirement discovery"]
  node_provideroffer["Provider offer submission"]
  node_offerservice["Offer service<br/>[offersService.ts]"]
  node_matching["Match scoring<br/>[matchingEngine.ts]"]
  node_compare["Offer comparison"]
  node_categories["Category service"]
  node_dashboard["Role dashboards"]
end

subgraph group_orders["Orders and trust"]
  node_payment["Customer payment<br/>[PaymentPage.tsx]"]
  node_orderdetail["Order details"]
  node_delivery["Provider delivery"]
  node_orderservice["Order service<br/>[ordersService.ts]"]
  node_reviews["Review service<br/>[reviewsService.ts]"]
  node_reviewui["Review interface<br/>[ReviewModal.tsx]"]
end

subgraph group_platform["Shared platform"]
  node_authservice["Authentication service<br/>[authService.ts]"]
  node_notifications["Notification hook"]
  node_notifservice["Notification service"]
  node_layout["Dashboard layout"]
  node_supabaseclient["Supabase client<br/>[supabase.ts]"]
  node_database[("Supabase services")]
  node_datatypes["Database types<br/>[database.ts]"]
  node_email["Email function<br/>[index.ts]"]
end

node_customer(("Customer"))
node_provider(("Provider"))

node_customer -->|"opens marketplace"| node_app
node_provider -->|"opens marketplace"| node_app
node_app -->|"provides auth"| node_auth
node_app -->|"routes to"| node_browse
node_app -->|"routes to"| node_customerreq
node_app -->|"routes to"| node_provideroffer
node_app -->|"routes to"| node_orderdetail
node_auth -->|"loads profiles"| node_authservice
node_auth -->|"reads session"| node_supabaseclient
node_customerreq -->|"creates requirement"| node_reqservice
node_browse -->|"loads requirements"| node_reqservice
node_browse -->|"loads categories"| node_categories
node_provideroffer -->|"loads requirement"| node_reqservice
node_provideroffer -->|"submits offer"| node_offerservice
node_compare -->|"loads requirement"| node_reqservice
node_compare -->|"manages offers"| node_offerservice
node_offerservice -->|"calculates scores"| node_matching
node_dashboard -->|"loads offers"| node_offerservice
node_dashboard -->|"loads requirements"| node_reqservice
node_payment -->|"handles payment"| node_orderservice
node_orderdetail -->|"loads order"| node_orderservice
node_orderdetail -->|"loads reviews"| node_reviews
node_orderdetail -->|"renders review"| node_reviewui
node_delivery -->|"submits delivery"| node_orderservice
node_reviewui -->|"submits review"| node_reviews
node_notifications -->|"loads and updates"| node_notifservice
node_layout -->|"shows unread count"| node_notifications
node_authservice -->|"uses client"| node_supabaseclient
node_reqservice -->|"queries data"| node_supabaseclient
node_offerservice -->|"queries data"| node_supabaseclient
node_orderservice -->|"queries data"| node_supabaseclient
node_reviews -->|"queries data"| node_supabaseclient
node_notifservice -->|"queries data"| node_supabaseclient
node_supabaseclient -->|"connects to"| node_database
node_orderservice -->|"invokes"| node_email
node_offerservice -->|"uses domain types"| node_datatypes

click node_app "https://github.com/teamsternritters-a11y/requora/blob/main/src/App.tsx"
click node_auth "https://github.com/teamsternritters-a11y/requora/blob/main/src/hooks/useAuth.tsx"
click node_authservice "https://github.com/teamsternritters-a11y/requora/blob/main/src/services/authService.ts"
click node_customerreq "https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/customer/CreateRequirementPage.tsx"
click node_reqservice "https://github.com/teamsternritters-a11y/requora/blob/main/src/services/requirementsService.ts"
click node_browse "https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/ExploreRequirementsPage.tsx"
click node_provideroffer "https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/provider/SubmitOfferPage.tsx"
click node_offerservice "https://github.com/teamsternritters-a11y/requora/blob/main/src/services/offersService.ts"
click node_matching "https://github.com/teamsternritters-a11y/requora/blob/main/src/utils/matchingEngine.ts"
click node_compare "https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/customer/RequirementDetailPage.tsx"
click node_categories "https://github.com/teamsternritters-a11y/requora/blob/main/src/services/categoriesService.ts"
click node_dashboard "https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/customer/CustomerDashboard.tsx"
click node_payment "https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/customer/PaymentPage.tsx"
click node_orderdetail "https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/OrderDetailPage.tsx"
click node_delivery "https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/provider/ProviderDeliverPage.tsx"
click node_orderservice "https://github.com/teamsternritters-a11y/requora/blob/main/src/services/ordersService.ts"
click node_reviews "https://github.com/teamsternritters-a11y/requora/blob/main/src/services/reviewsService.ts"
click node_reviewui "https://github.com/teamsternritters-a11y/requora/blob/main/src/components/ReviewModal.tsx"
click node_notifications "https://github.com/teamsternritters-a11y/requora/blob/main/src/hooks/useNotifications.ts"
click node_notifservice "https://github.com/teamsternritters-a11y/requora/blob/main/src/services/notificationsService.ts"
click node_layout "https://github.com/teamsternritters-a11y/requora/blob/main/src/components/DashboardLayout.tsx"
click node_supabaseclient "https://github.com/teamsternritters-a11y/requora/blob/main/src/lib/supabase.ts"
click node_datatypes "https://github.com/teamsternritters-a11y/requora/blob/main/src/types/database.ts"
click node_email "https://github.com/teamsternritters-a11y/requora/blob/main/supabase/functions/send-email/index.ts"

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_auth toneBlue
class node_customerreq,node_reqservice,node_browse,node_provideroffer,node_offerservice,node_matching,node_compare,node_categories,node_dashboard toneAmber
class node_payment,node_orderdetail,node_delivery,node_orderservice,node_reviews,node_reviewui toneMint
class node_authservice,node_notifications,node_notifservice,node_layout,node_supabaseclient,node_database,node_datatypes,node_email toneRose
class node_customer,node_provider toneIndigo
```

## Components

### App and access

- [Route application](https://github.com/teamsternritters-a11y/requora/blob/main/src/App.tsx): `src/App.tsx`
- [Auth context](https://github.com/teamsternritters-a11y/requora/blob/main/src/hooks/useAuth.tsx): `src/hooks/useAuth.tsx`

### Marketplace workflow

- [Customer requirements](https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/customer/CreateRequirementPage.tsx): `src/pages/customer/CreateRequirementPage.tsx`
- [Requirement service](https://github.com/teamsternritters-a11y/requora/blob/main/src/services/requirementsService.ts): `src/services/requirementsService.ts`
- [Requirement discovery](https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/ExploreRequirementsPage.tsx): `src/pages/ExploreRequirementsPage.tsx`
- [Provider offer submission](https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/provider/SubmitOfferPage.tsx): `src/pages/provider/SubmitOfferPage.tsx`
- [Offer service](https://github.com/teamsternritters-a11y/requora/blob/main/src/services/offersService.ts): `src/services/offersService.ts`
- [Match scoring](https://github.com/teamsternritters-a11y/requora/blob/main/src/utils/matchingEngine.ts): `src/utils/matchingEngine.ts`
- [Offer comparison](https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/customer/RequirementDetailPage.tsx): `src/pages/customer/RequirementDetailPage.tsx`
- [Category service](https://github.com/teamsternritters-a11y/requora/blob/main/src/services/categoriesService.ts): `src/services/categoriesService.ts`
- [Role dashboards](https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/customer/CustomerDashboard.tsx): `src/pages/customer/CustomerDashboard.tsx`

### Orders and trust

- [Customer payment](https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/customer/PaymentPage.tsx): `src/pages/customer/PaymentPage.tsx`
- [Order details](https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/OrderDetailPage.tsx): `src/pages/OrderDetailPage.tsx`
- [Provider delivery](https://github.com/teamsternritters-a11y/requora/blob/main/src/pages/provider/ProviderDeliverPage.tsx): `src/pages/provider/ProviderDeliverPage.tsx`
- [Order service](https://github.com/teamsternritters-a11y/requora/blob/main/src/services/ordersService.ts): `src/services/ordersService.ts`
- [Review service](https://github.com/teamsternritters-a11y/requora/blob/main/src/services/reviewsService.ts): `src/services/reviewsService.ts`
- [Review interface](https://github.com/teamsternritters-a11y/requora/blob/main/src/components/ReviewModal.tsx): `src/components/ReviewModal.tsx`

### Shared platform

- [Authentication service](https://github.com/teamsternritters-a11y/requora/blob/main/src/services/authService.ts): `src/services/authService.ts`
- [Notification hook](https://github.com/teamsternritters-a11y/requora/blob/main/src/hooks/useNotifications.ts): `src/hooks/useNotifications.ts`
- [Notification service](https://github.com/teamsternritters-a11y/requora/blob/main/src/services/notificationsService.ts): `src/services/notificationsService.ts`
- [Dashboard layout](https://github.com/teamsternritters-a11y/requora/blob/main/src/components/DashboardLayout.tsx): `src/components/DashboardLayout.tsx`
- [Supabase client](https://github.com/teamsternritters-a11y/requora/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- **Supabase services**
- [Database types](https://github.com/teamsternritters-a11y/requora/blob/main/src/types/database.ts): `src/types/database.ts`
- [Email function](https://github.com/teamsternritters-a11y/requora/blob/main/supabase/functions/send-email/index.ts): `supabase/functions/send-email/index.ts`

### Other components

- **Customer**
- **Provider**

## Connections

- Customer → Route application: opens marketplace (evidence: `src/App.tsx`)
- Provider → Route application: opens marketplace (evidence: `src/App.tsx`)
- Route application → Auth context: provides auth (evidence: `src/App.tsx`)
- Route application → Requirement discovery: routes to (evidence: `src/App.tsx`)
- Route application → Customer requirements: routes to (evidence: `src/App.tsx`)
- Route application → Provider offer submission: routes to (evidence: `src/App.tsx`)
- Route application → Order details: routes to (evidence: `src/App.tsx`)
- Auth context → Authentication service: loads profiles (evidence: `src/hooks/useAuth.tsx`)
- Auth context → Supabase client: reads session (evidence: `src/hooks/useAuth.tsx`)
- Customer requirements → Requirement service: creates requirement (evidence: `src/pages/customer/CreateRequirementPage.tsx`)
- Requirement discovery → Requirement service: loads requirements (evidence: `src/pages/ExploreRequirementsPage.tsx`)
- Requirement discovery → Category service: loads categories (evidence: `src/pages/ExploreRequirementsPage.tsx`)
- Provider offer submission → Requirement service: loads requirement (evidence: `src/pages/provider/SubmitOfferPage.tsx`)
- Provider offer submission → Offer service: submits offer (evidence: `src/pages/provider/SubmitOfferPage.tsx`)
- Offer comparison → Requirement service: loads requirement (evidence: `src/pages/customer/RequirementDetailPage.tsx`)
- Offer comparison → Offer service: manages offers (evidence: `src/pages/customer/RequirementDetailPage.tsx`)
- Offer service → Match scoring: calculates scores (evidence: `src/services/offersService.ts`)
- Role dashboards → Offer service: loads offers
- Role dashboards → Requirement service: loads requirements
- Customer payment → Order service: handles payment (evidence: `src/pages/customer/PaymentPage.tsx`)
- Order details → Order service: loads order (evidence: `src/pages/OrderDetailPage.tsx`)
- Order details → Review service: loads reviews (evidence: `src/pages/OrderDetailPage.tsx`)
- Order details → Review interface: renders review (evidence: `src/pages/OrderDetailPage.tsx`)
- Provider delivery → Order service: submits delivery (evidence: `src/pages/provider/ProviderDeliverPage.tsx`)
- Review interface → Review service: submits review (evidence: `src/components/ReviewModal.tsx`)
- Notification hook → Notification service: loads and updates (evidence: `src/hooks/useNotifications.ts`)
- Dashboard layout → Notification hook: shows unread count (evidence: `src/components/DashboardLayout.tsx`)
- Authentication service → Supabase client: uses client (evidence: `src/services/authService.ts`)
- Requirement service → Supabase client: queries data (evidence: `src/services/requirementsService.ts`)
- Offer service → Supabase client: queries data (evidence: `src/services/offersService.ts`)
- Order service → Supabase client: queries data (evidence: `src/services/ordersService.ts`)
- Review service → Supabase client: queries data (evidence: `src/services/reviewsService.ts`)
- Notification service → Supabase client: queries data (evidence: `src/services/notificationsService.ts`)
- Supabase client → Supabase services: connects to (evidence: `src/lib/supabase.ts`)
- Order service → Email function: invokes (evidence: `src/services/ordersService.ts`)
- Offer service → Database types: uses domain types (evidence: `src/services/offersService.ts`)
