# hellypatel026/tripmate architecture

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

- Interactive diagram: https://gitdiagram.com/hellypatel026/tripmate
- Repository: https://github.com/hellypatel026/tripmate

## Overview

TripMate is a trip-management and shared-expense application. Its intended user journey spans account access, trip and membership management, planning and bookings, then collaboration and expense tracking through settlements. The backend exposes REST routes and a Socket.IO chat service, with MongoDB models for domain data. The shown client currently renders socket-test components in App rather than the commented-out login/dashboard routes, so the graph distinguishes documented product areas from the client entry point actually shown. Some domain links rely on the SOURCE INDEX; unsampled behavior is not inferred.

Main entry points: [`server/src/server.js`](https://github.com/hellypatel026/tripmate/blob/main/server/src/server.js) (API and socket server), [`server/src/models/TripMember.js`](https://github.com/hellypatel026/tripmate/blob/main/server/src/models/TripMember.js) (Membership records), [`server/src/controllers/expenseController.js`](https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/expenseController.js) (Expense tracking), [`server/src/routes/tripRoutes.js`](https://github.com/hellypatel026/tripmate/blob/main/server/src/routes/tripRoutes.js) (Trip endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client"]
  node_app["Client entry<br/>[App.jsx]"]
  node_authpages["Login and register<br/>[Login.jsx]"]
  node_authstate["Auth state<br/>[authStore.js]"]
  node_api_client["HTTP client<br/>[api.js]"]
  node_socket_client["Socket client<br/>[socket.js]"]
  node_chat_ui["Chat views<br/>[SocketTest.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
end

subgraph group_api["API and access"]
  node_server["API and socket server<br/>[server.js]"]
  node_auth_routes["Auth endpoints<br/>[authRoutes.js]"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_auth_middleware["Request authentication<br/>[authMiddleware.js]"]
end

subgraph group_trips["Trip planning"]
  node_trip_routes["Trip endpoints<br/>[tripRoutes.js]"]
  node_trip_controller["Trip management<br/>[tripController.js]"]
  node_member_controller["Trip membership"]
  node_itinerary_controller["Itinerary"]
  node_booking_controller["Bookings"]
end

subgraph group_collaboration["Collaboration"]
  node_gallery_controller["Trip gallery"]
  node_message_controller["Messages"]
  node_chat_socket["Realtime chat<br/>[chatSocket.js]"]
  node_notification_controller["Notifications"]
end

subgraph group_finance["Shared finances"]
  node_expense_controller["Expense tracking"]
  node_settlement_controller["Settlements"]
end

subgraph group_data["Domain storage"]
  node_expense_store[("Expense records<br/>[Expense.js]")]
  node_trip_store[("Trip records<br/>[Trip.js]")]
  node_member_store[("Membership records<br/>[TripMember.js]")]
  node_user_store[("User records<br/>[User.js]")]
  node_itinerary_store[("Itinerary records<br/>[Itinerary.js]")]
  node_booking_store[("Booking records<br/>[Booking.js]")]
  node_gallery_store[("Gallery records<br/>[Gallery.js]")]
  node_message_store[("Message records<br/>[Message.js]")]
  node_notification_store[("Notification records<br/>[Notification.js]")]
  node_settlement_store[("Settlement records<br/>[Settlement.js]")]
end

node_traveler(("Traveler"))

node_traveler -->|"uses"| node_app
node_app -->|"renders"| node_chat_ui
node_authpages -->|"calls"| node_authstate
node_authstate -->|"requests"| node_api_client
node_chat_ui -->|"uses"| node_socket_client
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_trip_routes
node_server -->|"initializes"| node_chat_socket
node_server -->|"mounts endpoints"| node_itinerary_controller
node_server -->|"mounts endpoints"| node_booking_controller
node_server -->|"mounts endpoints"| node_expense_controller
node_server -->|"mounts endpoints"| node_settlement_controller
node_server -->|"mounts endpoints"| node_message_controller
node_server -->|"mounts endpoints"| node_notification_controller
node_server -->|"mounts endpoints"| node_gallery_controller
node_auth_routes -.->|"dispatches"| node_auth_controller
node_trip_routes -->|"dispatches"| node_trip_controller
node_trip_routes -->|"protects"| node_auth_middleware
node_trip_controller -->|"reads and writes"| node_trip_store
node_trip_controller -->|"checks membership"| node_member_store
node_auth_controller -->|"reads and writes"| node_user_store
node_expense_controller -->|"reads and writes"| node_expense_store
node_expense_controller -->|"checks members"| node_member_store
node_expense_controller -->|"loads users"| node_user_store
node_settlement_controller -->|"reads and writes"| node_settlement_store
node_settlement_controller -->|"checks members"| node_member_store
node_itinerary_controller -->|"reads and writes"| node_itinerary_store
node_booking_controller -.->|"uses"| node_booking_store
node_gallery_controller -->|"reads and writes"| node_gallery_store
node_gallery_controller -->|"checks membership"| node_member_store
node_chat_socket -->|"reads and writes"| node_message_store
node_chat_socket -->|"checks membership"| node_member_store
node_notification_controller -->|"manages"| node_notification_store

click node_app "https://github.com/hellypatel026/tripmate/blob/main/client/src/App.jsx"
click node_authpages "https://github.com/hellypatel026/tripmate/blob/main/client/src/pages/auth/Login.jsx"
click node_authstate "https://github.com/hellypatel026/tripmate/blob/main/client/src/store/authStore.js"
click node_api_client "https://github.com/hellypatel026/tripmate/blob/main/client/src/services/api.js"
click node_socket_client "https://github.com/hellypatel026/tripmate/blob/main/client/src/services/socket.js"
click node_chat_ui "https://github.com/hellypatel026/tripmate/blob/main/client/src/pages/chat/SocketTest.jsx"
click node_dashboard "https://github.com/hellypatel026/tripmate/blob/main/client/src/pages/dashboard/Dashboard.jsx"
click node_server "https://github.com/hellypatel026/tripmate/blob/main/server/src/server.js"
click node_auth_routes "https://github.com/hellypatel026/tripmate/blob/main/server/src/routes/authRoutes.js"
click node_auth_controller "https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/authController.js"
click node_auth_middleware "https://github.com/hellypatel026/tripmate/blob/main/server/src/middleware/authMiddleware.js"
click node_trip_routes "https://github.com/hellypatel026/tripmate/blob/main/server/src/routes/tripRoutes.js"
click node_trip_controller "https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/tripController.js"
click node_member_controller "https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/tripMemberController.js"
click node_itinerary_controller "https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/itineraryController.js"
click node_booking_controller "https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/bookingController.js"
click node_gallery_controller "https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/galleryController.js"
click node_message_controller "https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/messageController.js"
click node_chat_socket "https://github.com/hellypatel026/tripmate/blob/main/server/src/sockets/chatSocket.js"
click node_notification_controller "https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/notificationController.js"
click node_expense_controller "https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/expenseController.js"
click node_settlement_controller "https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/settlementController.js"
click node_expense_store "https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Expense.js"
click node_trip_store "https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Trip.js"
click node_member_store "https://github.com/hellypatel026/tripmate/blob/main/server/src/models/TripMember.js"
click node_user_store "https://github.com/hellypatel026/tripmate/blob/main/server/src/models/User.js"
click node_itinerary_store "https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Itinerary.js"
click node_booking_store "https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Booking.js"
click node_gallery_store "https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Gallery.js"
click node_message_store "https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Message.js"
click node_notification_store "https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Notification.js"
click node_settlement_store "https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Settlement.js"

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_authpages,node_authstate,node_api_client,node_socket_client,node_chat_ui,node_dashboard toneBlue
class node_server,node_auth_routes,node_auth_controller,node_auth_middleware toneAmber
class node_trip_routes,node_trip_controller,node_member_controller,node_itinerary_controller,node_booking_controller toneMint
class node_gallery_controller,node_message_controller,node_chat_socket,node_notification_controller toneRose
class node_expense_controller,node_settlement_controller,node_traveler toneIndigo
class node_expense_store,node_trip_store,node_member_store,node_user_store,node_itinerary_store,node_booking_store,node_gallery_store,node_message_store,node_notification_store,node_settlement_store toneTeal
```

## Components

### Client

- [Client entry](https://github.com/hellypatel026/tripmate/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Login and register](https://github.com/hellypatel026/tripmate/blob/main/client/src/pages/auth/Login.jsx): `client/src/pages/auth/Login.jsx`
- [Auth state](https://github.com/hellypatel026/tripmate/blob/main/client/src/store/authStore.js): `client/src/store/authStore.js`
- [HTTP client](https://github.com/hellypatel026/tripmate/blob/main/client/src/services/api.js): `client/src/services/api.js`
- [Socket client](https://github.com/hellypatel026/tripmate/blob/main/client/src/services/socket.js): `client/src/services/socket.js`
- [Chat views](https://github.com/hellypatel026/tripmate/blob/main/client/src/pages/chat/SocketTest.jsx): `client/src/pages/chat/SocketTest.jsx`
- [Dashboard](https://github.com/hellypatel026/tripmate/blob/main/client/src/pages/dashboard/Dashboard.jsx): `client/src/pages/dashboard/Dashboard.jsx`

### API and access

- [API and socket server](https://github.com/hellypatel026/tripmate/blob/main/server/src/server.js): `server/src/server.js`
- [Auth endpoints](https://github.com/hellypatel026/tripmate/blob/main/server/src/routes/authRoutes.js): `server/src/routes/authRoutes.js`
- [Authentication](https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/authController.js): `server/src/controllers/authController.js`
- [Request authentication](https://github.com/hellypatel026/tripmate/blob/main/server/src/middleware/authMiddleware.js): `server/src/middleware/authMiddleware.js`

### Trip planning

- [Trip endpoints](https://github.com/hellypatel026/tripmate/blob/main/server/src/routes/tripRoutes.js): `server/src/routes/tripRoutes.js`
- [Trip management](https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/tripController.js): `server/src/controllers/tripController.js`
- [Trip membership](https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/tripMemberController.js): `server/src/controllers/tripMemberController.js`
- [Itinerary](https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/itineraryController.js): `server/src/controllers/itineraryController.js`
- [Bookings](https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/bookingController.js): `server/src/controllers/bookingController.js`

### Collaboration

- [Trip gallery](https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/galleryController.js): `server/src/controllers/galleryController.js`
- [Messages](https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/messageController.js): `server/src/controllers/messageController.js`
- [Realtime chat](https://github.com/hellypatel026/tripmate/blob/main/server/src/sockets/chatSocket.js): `server/src/sockets/chatSocket.js`
- [Notifications](https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/notificationController.js): `server/src/controllers/notificationController.js`

### Shared finances

- [Expense tracking](https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/expenseController.js): `server/src/controllers/expenseController.js`
- [Settlements](https://github.com/hellypatel026/tripmate/blob/main/server/src/controllers/settlementController.js): `server/src/controllers/settlementController.js`

### Domain storage

- [Expense records](https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Expense.js): `server/src/models/Expense.js`
- [Trip records](https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Trip.js): `server/src/models/Trip.js`
- [Membership records](https://github.com/hellypatel026/tripmate/blob/main/server/src/models/TripMember.js): `server/src/models/TripMember.js`
- [User records](https://github.com/hellypatel026/tripmate/blob/main/server/src/models/User.js): `server/src/models/User.js`
- [Itinerary records](https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Itinerary.js): `server/src/models/Itinerary.js`
- [Booking records](https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Booking.js): `server/src/models/Booking.js`
- [Gallery records](https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Gallery.js): `server/src/models/Gallery.js`
- [Message records](https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Message.js): `server/src/models/Message.js`
- [Notification records](https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Notification.js): `server/src/models/Notification.js`
- [Settlement records](https://github.com/hellypatel026/tripmate/blob/main/server/src/models/Settlement.js): `server/src/models/Settlement.js`

### Other components

- **Traveler**

## Connections

- Traveler → Client entry: uses (evidence: `client/src/App.jsx`)
- Client entry → Chat views: renders (evidence: `client/src/App.jsx`)
- Login and register → Auth state: calls (evidence: `client/src/pages/auth/Login.jsx`)
- Auth state → HTTP client: requests (evidence: `client/src/store/authStore.js`)
- Chat views → Socket client: uses (evidence: `client/src/pages/chat/SocketTest.jsx`)
- API and socket server → Auth endpoints: mounts (evidence: `server/src/server.js`)
- API and socket server → Trip endpoints: mounts (evidence: `server/src/server.js`)
- API and socket server → Realtime chat: initializes (evidence: `server/src/server.js`)
- API and socket server → Itinerary: mounts endpoints (evidence: `server/src/server.js`)
- API and socket server → Bookings: mounts endpoints (evidence: `server/src/server.js`)
- API and socket server → Expense tracking: mounts endpoints (evidence: `server/src/server.js`)
- API and socket server → Settlements: mounts endpoints (evidence: `server/src/server.js`)
- API and socket server → Messages: mounts endpoints (evidence: `server/src/server.js`)
- API and socket server → Notifications: mounts endpoints (evidence: `server/src/server.js`)
- API and socket server → Trip gallery: mounts endpoints (evidence: `server/src/server.js`)
- Auth endpoints → Authentication: dispatches
- Trip endpoints → Trip management: dispatches (evidence: `server/src/routes/tripRoutes.js`)
- Trip endpoints → Request authentication: protects (evidence: `server/src/routes/tripRoutes.js`)
- Trip management → Trip records: reads and writes (evidence: `server/src/controllers/tripController.js`)
- Trip management → Membership records: checks membership (evidence: `server/src/controllers/tripController.js`)
- Authentication → User records: reads and writes (evidence: `server/src/controllers/authController.js`)
- Expense tracking → Expense records: reads and writes (evidence: `server/src/controllers/expenseController.js`)
- Expense tracking → Membership records: checks members (evidence: `server/src/controllers/expenseController.js`)
- Expense tracking → User records: loads users (evidence: `server/src/controllers/expenseController.js`)
- Settlements → Settlement records: reads and writes (evidence: `server/src/controllers/settlementController.js`)
- Settlements → Membership records: checks members (evidence: `server/src/controllers/settlementController.js`)
- Itinerary → Itinerary records: reads and writes (evidence: `server/src/controllers/itineraryController.js`)
- Bookings → Booking records: uses
- Trip gallery → Gallery records: reads and writes (evidence: `server/src/controllers/galleryController.js`)
- Trip gallery → Membership records: checks membership (evidence: `server/src/controllers/galleryController.js`)
- Realtime chat → Message records: reads and writes (evidence: `server/src/sockets/chatSocket.js`)
- Realtime chat → Membership records: checks membership (evidence: `server/src/sockets/chatSocket.js`)
- Notifications → Notification records: manages (evidence: `server/src/controllers/notificationController.js`)
