# muniendavid-oss/staybnb architecture

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

- Interactive diagram: https://gitdiagram.com/muniendavid-oss/staybnb
- Repository: https://github.com/muniendavid-oss/staybnb

## Overview

Staybnb is an ASP.NET Core MVC lodging marketplace. Guests browse active listings, request bookings, and complete document-based check-in; prospective hosts apply, then manage listings and booking reviews after approval. Admins review applications, verify documents, manage users, and inspect activity logs. Messaging and notifications support communication across these workflows. The sampled controllers show booking, host-application, and administration behavior; other documented capabilities are included where the README supports them. Source-index references provide evidence for several unsampled connections.

Main entry points: [`Data/ApplicationDbContext.cs`](https://github.com/muniendavid-oss/staybnb/blob/main/Data/ApplicationDbContext.cs) (EF data context), [`Services/ActivityLogger.cs`](https://github.com/muniendavid-oss/staybnb/blob/main/Services/ActivityLogger.cs) (Activity logging), [`Controllers/BookingsController.cs`](https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/BookingsController.cs) (Booking workflow), [`Controllers/AdminController.cs`](https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/AdminController.cs) (Admin operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_account["Accounts"]
  node_roles["Role seeding<br/>[RoleSeeder.cs]"]
  node_communication["Inbox and alerts"]
end

subgraph group_marketplace["Listings and bookings"]
  node_properties["Property search"]
  node_booking["Booking workflow"]
end

subgraph group_hosting["Host operations"]
  node_application["Host applications"]
  node_checkin["Check-in instructions<br/>[CheckInProcess.cs]"]
end

subgraph group_admin["Administration"]
  node_adminops["Admin operations<br/>[AdminController.cs]"]
  node_logging["Activity logging<br/>[ActivityLogger.cs]"]
end

subgraph group_data["Persistence and records"]
  node_property["Property records<br/>[Property.cs]"]
  node_propertyimage["Property images<br/>[PropertyImage.cs]"]
  node_bookingrecord["Booking records<br/>[Booking.cs]"]
  node_hostrecord["Application records<br/>[HostApplication.cs]"]
  node_documents["Guest documents<br/>[GuestDocument.cs]"]
  node_messages["Messages<br/>[Message.cs]"]
  node_notifications["Notifications<br/>[Notification.cs]"]
  node_activityrecord["Activity records<br/>[ActivityLog.cs]"]
  node_userrecord["User records<br/>[ApplicationUser.cs]"]
  node_context["EF data context"]
end

node_guest(("Guest"))
node_host(("Host"))
node_adminuser(("Admin"))
node_sql[("SQL Server")]

node_guest -->|"registers or signs in"| node_account
node_account -->|"logs activity"| node_logging
node_roles -->|"seeds roles"| node_userrecord
node_guest -->|"searches listings"| node_properties
node_properties -->|"queries listings"| node_context
node_guest -->|"requests stay"| node_booking
node_booking -->|"reads and writes"| node_context
node_booking -->|"logs activity"| node_logging
node_booking -->|"creates alerts"| node_notifications
node_host -->|"applies and manages"| node_application
node_application -->|"reads and writes"| node_context
node_application -->|"logs activity"| node_logging
node_adminuser -->|"reviews and administers"| node_adminops
node_adminops -->|"reads and writes"| node_context
node_adminops -->|"logs activity"| node_logging
node_adminops -->|"changes roles"| node_userrecord
node_host -->|"sets instructions"| node_checkin
node_guest -->|"uploads documents"| node_booking
node_host -->|"verifies documents"| node_application
node_booking -->|"checks verification"| node_context
node_guest -->|"messages and reads alerts"| node_communication
node_communication -->|"reads and writes"| node_context
node_communication -->|"logs activity"| node_logging
node_context -->|"persists records"| node_sql
node_context -->|"maps entity"| node_property
node_context -->|"maps entity"| node_propertyimage
node_context -->|"maps entity"| node_bookingrecord
node_context -->|"maps entity"| node_hostrecord
node_context -->|"maps entity"| node_documents
node_context -->|"maps entity"| node_checkin
node_context -->|"maps entity"| node_messages
node_context -->|"maps entity"| node_notifications
node_context -->|"maps entity"| node_activityrecord
node_context -->|"maps identity"| node_userrecord
node_logging -->|"writes log entries"| node_context
node_logging -->|"creates records"| node_activityrecord

click node_account "https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/AccountController.cs"
click node_roles "https://github.com/muniendavid-oss/staybnb/blob/main/Data/RoleSeeder.cs"
click node_properties "https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/PropertiesController.cs"
click node_booking "https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/BookingsController.cs"
click node_property "https://github.com/muniendavid-oss/staybnb/blob/main/Models/Property.cs"
click node_propertyimage "https://github.com/muniendavid-oss/staybnb/blob/main/Models/PropertyImage.cs"
click node_bookingrecord "https://github.com/muniendavid-oss/staybnb/blob/main/Models/Booking.cs"
click node_application "https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/HostApplicationsController.cs"
click node_hostrecord "https://github.com/muniendavid-oss/staybnb/blob/main/Models/HostApplication.cs"
click node_checkin "https://github.com/muniendavid-oss/staybnb/blob/main/Models/CheckInProcess.cs"
click node_documents "https://github.com/muniendavid-oss/staybnb/blob/main/Models/GuestDocument.cs"
click node_adminops "https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/AdminController.cs"
click node_communication "https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/CommunicationController.cs"
click node_messages "https://github.com/muniendavid-oss/staybnb/blob/main/Models/Message.cs"
click node_notifications "https://github.com/muniendavid-oss/staybnb/blob/main/Models/Notification.cs"
click node_logging "https://github.com/muniendavid-oss/staybnb/blob/main/Services/ActivityLogger.cs"
click node_activityrecord "https://github.com/muniendavid-oss/staybnb/blob/main/Models/ActivityLog.cs"
click node_userrecord "https://github.com/muniendavid-oss/staybnb/blob/main/Models/ApplicationUser.cs"
click node_context "https://github.com/muniendavid-oss/staybnb/blob/main/Data/ApplicationDbContext.cs"

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_account,node_roles,node_communication toneBlue
class node_properties,node_booking,node_sql toneAmber
class node_application,node_checkin toneMint
class node_adminops,node_logging toneRose
class node_property,node_propertyimage,node_bookingrecord,node_hostrecord,node_documents,node_messages,node_notifications,node_activityrecord,node_userrecord,node_context,node_guest,node_host,node_adminuser toneIndigo
```

## Components

### Identity and access

- [Accounts](https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/AccountController.cs): `Controllers/AccountController.cs`
- [Role seeding](https://github.com/muniendavid-oss/staybnb/blob/main/Data/RoleSeeder.cs): `Data/RoleSeeder.cs`
- [Inbox and alerts](https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/CommunicationController.cs): `Controllers/CommunicationController.cs`

### Listings and bookings

- [Property search](https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/PropertiesController.cs): `Controllers/PropertiesController.cs`
- [Booking workflow](https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/BookingsController.cs): `Controllers/BookingsController.cs`

### Host operations

- [Host applications](https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/HostApplicationsController.cs): `Controllers/HostApplicationsController.cs`
- [Check-in instructions](https://github.com/muniendavid-oss/staybnb/blob/main/Models/CheckInProcess.cs): `Models/CheckInProcess.cs`

### Administration

- [Admin operations](https://github.com/muniendavid-oss/staybnb/blob/main/Controllers/AdminController.cs): `Controllers/AdminController.cs`
- [Activity logging](https://github.com/muniendavid-oss/staybnb/blob/main/Services/ActivityLogger.cs): `Services/ActivityLogger.cs`

### Persistence and records

- [Property records](https://github.com/muniendavid-oss/staybnb/blob/main/Models/Property.cs): `Models/Property.cs`
- [Property images](https://github.com/muniendavid-oss/staybnb/blob/main/Models/PropertyImage.cs): `Models/PropertyImage.cs`
- [Booking records](https://github.com/muniendavid-oss/staybnb/blob/main/Models/Booking.cs): `Models/Booking.cs`
- [Application records](https://github.com/muniendavid-oss/staybnb/blob/main/Models/HostApplication.cs): `Models/HostApplication.cs`
- [Guest documents](https://github.com/muniendavid-oss/staybnb/blob/main/Models/GuestDocument.cs): `Models/GuestDocument.cs`
- [Messages](https://github.com/muniendavid-oss/staybnb/blob/main/Models/Message.cs): `Models/Message.cs`
- [Notifications](https://github.com/muniendavid-oss/staybnb/blob/main/Models/Notification.cs): `Models/Notification.cs`
- [Activity records](https://github.com/muniendavid-oss/staybnb/blob/main/Models/ActivityLog.cs): `Models/ActivityLog.cs`
- [User records](https://github.com/muniendavid-oss/staybnb/blob/main/Models/ApplicationUser.cs): `Models/ApplicationUser.cs`
- [EF data context](https://github.com/muniendavid-oss/staybnb/blob/main/Data/ApplicationDbContext.cs): `Data/ApplicationDbContext.cs`

### Other components

- **Guest**
- **Host**
- **Admin**
- **SQL Server**

## Connections

- Guest → Accounts: registers or signs in (evidence: `README.md`)
- Accounts → Activity logging: logs activity (evidence: `Controllers/AccountController.cs`)
- Role seeding → User records: seeds roles (evidence: `Data/RoleSeeder.cs`)
- Guest → Property search: searches listings (evidence: `README.md`)
- Property search → EF data context: queries listings (evidence: `Controllers/PropertiesController.cs`)
- Guest → Booking workflow: requests stay (evidence: `Controllers/BookingsController.cs`)
- Booking workflow → EF data context: reads and writes (evidence: `Controllers/BookingsController.cs`)
- Booking workflow → Activity logging: logs activity (evidence: `Controllers/BookingsController.cs`)
- Booking workflow → Notifications: creates alerts (evidence: `Controllers/BookingsController.cs`)
- Host → Host applications: applies and manages (evidence: `Controllers/HostApplicationsController.cs`)
- Host applications → EF data context: reads and writes (evidence: `Controllers/HostApplicationsController.cs`)
- Host applications → Activity logging: logs activity (evidence: `Controllers/HostApplicationsController.cs`)
- Admin → Admin operations: reviews and administers (evidence: `README.md`)
- Admin operations → EF data context: reads and writes (evidence: `Controllers/AdminController.cs`)
- Admin operations → Activity logging: logs activity (evidence: `Controllers/AdminController.cs`)
- Admin operations → User records: changes roles (evidence: `Controllers/AdminController.cs`)
- Host → Check-in instructions: sets instructions
- Guest → Booking workflow: uploads documents (evidence: `Controllers/BookingsController.cs`)
- Host → Host applications: verifies documents (evidence: `Controllers/HostApplicationsController.cs`)
- Booking workflow → EF data context: checks verification (evidence: `Controllers/BookingsController.cs`)
- Guest → Inbox and alerts: messages and reads alerts (evidence: `README.md`)
- Inbox and alerts → EF data context: reads and writes (evidence: `Controllers/CommunicationController.cs`)
- Inbox and alerts → Activity logging: logs activity (evidence: `Controllers/CommunicationController.cs`)
- EF data context → SQL Server: persists records (evidence: `README.md`)
- EF data context → Property records: maps entity (evidence: `Data/ApplicationDbContext.cs`)
- EF data context → Property images: maps entity (evidence: `Data/ApplicationDbContext.cs`)
- EF data context → Booking records: maps entity (evidence: `Data/ApplicationDbContext.cs`)
- EF data context → Application records: maps entity (evidence: `Data/ApplicationDbContext.cs`)
- EF data context → Guest documents: maps entity (evidence: `Data/ApplicationDbContext.cs`)
- EF data context → Check-in instructions: maps entity (evidence: `Data/ApplicationDbContext.cs`)
- EF data context → Messages: maps entity (evidence: `Data/ApplicationDbContext.cs`)
- EF data context → Notifications: maps entity (evidence: `Data/ApplicationDbContext.cs`)
- EF data context → Activity records: maps entity (evidence: `Data/ApplicationDbContext.cs`)
- EF data context → User records: maps identity (evidence: `Data/ApplicationDbContext.cs`)
- Activity logging → EF data context: writes log entries (evidence: `Services/ActivityLogger.cs`)
- Activity logging → Activity records: creates records (evidence: `Services/ActivityLogger.cs`)
