# kishoresharmaks/cowork30 architecture

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

## Overview

Cowork30 is a coworking-space management platform with public, member, staff, and admin portals backed by a NestJS API. The principal workflow is a user exploring rooms or pricing, submitting a booking, and managing payment and booking status; the backend also supports branches, services, floor maps, CMS content, reports, and notifications. The tree and source index establish these capabilities, but no README is supplied and many frontend/API interactions were not excerpted, so unverified links are omitted.

Main entry points: [`backend/src/app.module.ts`](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/app.module.ts) (API composition), [`frontend-vite/src/App.tsx`](https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/App.tsx) (Portal routing), [`backend/src/shared/prisma/prisma.service.ts`](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/shared/prisma/prisma.service.ts) (Application database), [`backend/src/modules/notifications/notifications.service.ts`](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/notifications/notifications.service.ts) (Notifications and email)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["User portals"]
  node_portal["Portal routing<br/>[App.tsx]"]
  node_room_browse["Room browsing"]
  node_pricing_view["Pricing view<br/>[PricingPage.tsx]"]
  node_member_dashboard["Member dashboard<br/>[DashboardPage.tsx]"]
  node_staff_console["Staff console"]
  node_admin_console["Admin console"]
end

subgraph group_booking["Booking operations"]
  node_booking_ops["Desk and tour bookings"]
  node_meeting_ops["Meeting room bookings"]
  node_room_catalog["Meeting room catalog"]
  node_branch_ops["Branch management"]
  node_floor_map["Floor maps"]
end

subgraph group_money["Pricing and billing"]
  node_pricing_ops["Pricing and quotes<br/>[pricing.service.ts]"]
  node_wallet_ops["Wallet and payments"]
  node_invoice_ops["Invoices<br/>[invoice.service.ts]"]
  node_razorpay["Razorpay integration"]
end

subgraph group_platform["Platform services"]
  node_api_root["API composition<br/>[app.module.ts]"]
  node_auth["Authentication and roles<br/>[auth.service.ts]"]
  node_role_guard["Role authorization<br/>[roles.guard.ts]"]
  node_cms["CMS and gallery<br/>[cms.service.ts]"]
  node_services_ops["Coworking services"]
  node_reports["Reports<br/>[reports.service.ts]"]
  node_notifications["Notifications and email"]
  node_database[("Application database<br/>[prisma.service.ts]")]
end

node_member(("Member"))
node_staff(("Staff"))
node_admin(("Administrator"))

node_member -->|"uses"| node_portal
node_staff -->|"uses"| node_portal
node_admin -->|"uses"| node_portal
node_portal -->|"routes to"| node_room_browse
node_portal -->|"routes to"| node_pricing_view
node_portal -->|"routes to"| node_member_dashboard
node_portal -->|"routes to"| node_staff_console
node_portal -->|"routes to"| node_admin_console
node_api_root -->|"registers"| node_auth
node_api_root -->|"registers"| node_booking_ops
node_api_root -->|"registers"| node_meeting_ops
node_api_root -->|"registers"| node_pricing_ops
node_api_root -->|"registers"| node_wallet_ops
node_api_root -->|"registers"| node_cms
node_api_root -->|"registers"| node_floor_map
node_api_root -->|"registers"| node_notifications
node_api_root -->|"registers"| node_reports
node_auth -->|"reads and writes"| node_database
node_auth -->|"uses"| node_notifications
node_booking_ops -->|"reads and writes"| node_database
node_booking_ops -->|"uses"| node_notifications
node_booking_ops -->|"uses"| node_meeting_ops
node_meeting_ops -->|"reads and writes"| node_database
node_meeting_ops -->|"uses"| node_notifications
node_pricing_ops -->|"reads and writes"| node_database
node_pricing_ops -->|"uses"| node_razorpay
node_wallet_ops -->|"creates invoices"| node_invoice_ops
node_wallet_ops -.->|"uses"| node_razorpay
node_cms -->|"reads and writes"| node_database
node_floor_map -->|"reads and writes"| node_database
node_services_ops -->|"reads and writes"| node_database
node_services_ops -->|"uses"| node_notifications
node_notifications -->|"reads and writes"| node_database
node_role_guard -->|"checks roles"| node_auth
node_booking_ops -->|"guarded by"| node_role_guard
node_cms -->|"guarded by"| node_role_guard

click node_portal "https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/App.tsx"
click node_room_browse "https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/pages/MeetingRoomsPage.tsx"
click node_pricing_view "https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/pages/PricingPage.tsx"
click node_member_dashboard "https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/pages/DashboardPage.tsx"
click node_staff_console "https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/pages/StaffBookingsPage.tsx"
click node_admin_console "https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/pages/AdminBookingsPage.tsx"
click node_api_root "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/app.module.ts"
click node_auth "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/auth/auth.service.ts"
click node_role_guard "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/auth/guards/roles.guard.ts"
click node_booking_ops "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/bookings/bookings.service.ts"
click node_meeting_ops "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/meeting-rooms/meeting-rooms.service.ts"
click node_room_catalog "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/meeting-rooms/dto/meeting-room.dto.ts"
click node_branch_ops "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/branches/branches.service.ts"
click node_floor_map "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/floor-map/floor-map.service.ts"
click node_pricing_ops "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/pricing/pricing.service.ts"
click node_wallet_ops "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/wallet-billing/wallet-billing.service.ts"
click node_invoice_ops "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/wallet-billing/invoice.service.ts"
click node_razorpay "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/wallet-billing/razorpay.service.ts"
click node_cms "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/cms/cms.service.ts"
click node_services_ops "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/services/services.service.ts"
click node_reports "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/reports/reports.service.ts"
click node_notifications "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/notifications/notifications.service.ts"
click node_database "https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/shared/prisma/prisma.service.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_portal,node_room_browse,node_pricing_view,node_member_dashboard,node_staff_console,node_admin_console toneBlue
class node_booking_ops,node_meeting_ops,node_room_catalog,node_branch_ops,node_floor_map toneAmber
class node_pricing_ops,node_wallet_ops,node_invoice_ops,node_razorpay toneMint
class node_api_root,node_auth,node_role_guard,node_cms,node_services_ops,node_reports,node_notifications,node_database toneRose
class node_member,node_staff,node_admin toneIndigo
```

## Components

### User portals

- [Portal routing](https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/App.tsx): `frontend-vite/src/App.tsx`
- [Room browsing](https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/pages/MeetingRoomsPage.tsx): `frontend-vite/src/pages/MeetingRoomsPage.tsx`
- [Pricing view](https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/pages/PricingPage.tsx): `frontend-vite/src/pages/PricingPage.tsx`
- [Member dashboard](https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/pages/DashboardPage.tsx): `frontend-vite/src/pages/DashboardPage.tsx`
- [Staff console](https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/pages/StaffBookingsPage.tsx): `frontend-vite/src/pages/StaffBookingsPage.tsx`
- [Admin console](https://github.com/kishoresharmaks/cowork30/blob/main/frontend-vite/src/pages/AdminBookingsPage.tsx): `frontend-vite/src/pages/AdminBookingsPage.tsx`

### Booking operations

- [Desk and tour bookings](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/bookings/bookings.service.ts): `backend/src/modules/bookings/bookings.service.ts`
- [Meeting room bookings](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/meeting-rooms/meeting-rooms.service.ts): `backend/src/modules/meeting-rooms/meeting-rooms.service.ts`
- [Meeting room catalog](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/meeting-rooms/dto/meeting-room.dto.ts): `backend/src/modules/meeting-rooms/dto/meeting-room.dto.ts`
- [Branch management](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/branches/branches.service.ts): `backend/src/modules/branches/branches.service.ts`
- [Floor maps](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/floor-map/floor-map.service.ts): `backend/src/modules/floor-map/floor-map.service.ts`

### Pricing and billing

- [Pricing and quotes](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/pricing/pricing.service.ts): `backend/src/modules/pricing/pricing.service.ts`
- [Wallet and payments](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/wallet-billing/wallet-billing.service.ts): `backend/src/modules/wallet-billing/wallet-billing.service.ts`
- [Invoices](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/wallet-billing/invoice.service.ts): `backend/src/modules/wallet-billing/invoice.service.ts`
- [Razorpay integration](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/wallet-billing/razorpay.service.ts): `backend/src/modules/wallet-billing/razorpay.service.ts`

### Platform services

- [API composition](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/app.module.ts): `backend/src/app.module.ts`
- [Authentication and roles](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/auth/auth.service.ts): `backend/src/modules/auth/auth.service.ts`
- [Role authorization](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/auth/guards/roles.guard.ts): `backend/src/modules/auth/guards/roles.guard.ts`
- [CMS and gallery](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/cms/cms.service.ts): `backend/src/modules/cms/cms.service.ts`
- [Coworking services](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/services/services.service.ts): `backend/src/modules/services/services.service.ts`
- [Reports](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/reports/reports.service.ts): `backend/src/modules/reports/reports.service.ts`
- [Notifications and email](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/modules/notifications/notifications.service.ts): `backend/src/modules/notifications/notifications.service.ts`
- [Application database](https://github.com/kishoresharmaks/cowork30/blob/main/backend/src/shared/prisma/prisma.service.ts): `backend/src/shared/prisma/prisma.service.ts`

### Other components

- **Member**
- **Staff**
- **Administrator**

## Connections

- Member → Portal routing: uses (evidence: `frontend-vite/src/App.tsx`)
- Staff → Portal routing: uses (evidence: `frontend-vite/src/App.tsx`)
- Administrator → Portal routing: uses (evidence: `frontend-vite/src/App.tsx`)
- Portal routing → Room browsing: routes to (evidence: `frontend-vite/src/App.tsx`)
- Portal routing → Pricing view: routes to (evidence: `frontend-vite/src/App.tsx`)
- Portal routing → Member dashboard: routes to (evidence: `frontend-vite/src/App.tsx`)
- Portal routing → Staff console: routes to (evidence: `frontend-vite/src/App.tsx`)
- Portal routing → Admin console: routes to (evidence: `frontend-vite/src/App.tsx`)
- API composition → Authentication and roles: registers (evidence: `backend/src/app.module.ts`)
- API composition → Desk and tour bookings: registers (evidence: `backend/src/app.module.ts`)
- API composition → Meeting room bookings: registers (evidence: `backend/src/app.module.ts`)
- API composition → Pricing and quotes: registers (evidence: `backend/src/app.module.ts`)
- API composition → Wallet and payments: registers (evidence: `backend/src/app.module.ts`)
- API composition → CMS and gallery: registers (evidence: `backend/src/app.module.ts`)
- API composition → Floor maps: registers (evidence: `backend/src/app.module.ts`)
- API composition → Notifications and email: registers (evidence: `backend/src/app.module.ts`)
- API composition → Reports: registers (evidence: `backend/src/app.module.ts`)
- Authentication and roles → Application database: reads and writes (evidence: `backend/src/modules/auth/auth.service.ts`)
- Authentication and roles → Notifications and email: uses (evidence: `backend/src/modules/auth/auth.service.ts`)
- Desk and tour bookings → Application database: reads and writes (evidence: `backend/src/modules/bookings/bookings.service.ts`)
- Desk and tour bookings → Notifications and email: uses (evidence: `backend/src/modules/bookings/bookings.service.ts`)
- Desk and tour bookings → Meeting room bookings: uses (evidence: `backend/src/modules/bookings/bookings.service.ts`)
- Meeting room bookings → Application database: reads and writes (evidence: `backend/src/modules/meeting-rooms/meeting-rooms.service.ts`)
- Meeting room bookings → Notifications and email: uses (evidence: `backend/src/modules/meeting-rooms/meeting-rooms.service.ts`)
- Pricing and quotes → Application database: reads and writes (evidence: `backend/src/modules/pricing/pricing.service.ts`)
- Pricing and quotes → Razorpay integration: uses (evidence: `backend/src/modules/pricing/pricing.service.ts`)
- Wallet and payments → Invoices: creates invoices (evidence: `backend/src/modules/wallet-billing/wallet-billing.controller.ts`)
- Wallet and payments → Razorpay integration: uses
- CMS and gallery → Application database: reads and writes (evidence: `backend/src/modules/cms/cms.service.ts`)
- Floor maps → Application database: reads and writes (evidence: `backend/src/modules/floor-map/floor-map.service.ts`)
- Coworking services → Application database: reads and writes (evidence: `backend/src/modules/services/services.service.ts`)
- Coworking services → Notifications and email: uses (evidence: `backend/src/modules/services/services.service.ts`)
- Notifications and email → Application database: reads and writes (evidence: `backend/src/modules/notifications/notifications.service.ts`)
- Role authorization → Authentication and roles: checks roles (evidence: `backend/src/modules/auth/guards/roles.guard.ts`)
- Desk and tour bookings → Role authorization: guarded by (evidence: `backend/src/modules/bookings/bookings.controller.ts`)
- CMS and gallery → Role authorization: guarded by (evidence: `backend/src/modules/cms/cms.controller.ts`)
