# jekielyoung/cicd_coders_ca2 architecture

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

- Interactive diagram: https://gitdiagram.com/jekielyoung/cicd_coders_ca2
- Repository: https://github.com/jekielyoung/cicd_coders_ca2

## Overview

Orbit is a trip-planning web application. Users register or sign in, create trips, and manage trip details, members, itinerary activities, and trip documents; authentication and trip-access checks protect relevant API operations. The sampled source confirms the Express routing, controller/model calls, PostgreSQL access, and document upload handling. The browser page scripts and several backend modules are indexed as read but not excerpted, so their internal calls and page-to-API links are not asserted here.

Main entry points: [`server/db.js`](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/db.js) (PostgreSQL pool), [`server/routes/tripsRoutes.js`](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/routes/tripsRoutes.js) (Trip and activity routes), [`server/controllers/authController.js`](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/controllers/authController.js) (Authentication), [`server/app.js`](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/app.js) (Express application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Browser experience"]
  node_web_pages["Trip and account pages"]
  node_browser_api["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_app["Express application<br/>[app.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_auth_middleware["Token authentication<br/>[requireAuth.js]"]
  node_rate_limits["Login rate limits<br/>[rateLimiters.js]"]
  node_trip_routes["Trip and activity routes<br/>[tripsRoutes.js]"]
  node_trip_access["Trip access checks"]
  node_document_routes["Document locker<br/>[documentRoutes.js]"]
end

subgraph group_domain["Trip domain"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_trip_controller["Trip management<br/>[tripController.js]"]
  node_activity_controller["Itinerary activities"]
  node_mailer["Reset email service<br/>[mailer.js]"]
  node_validators["Input validation<br/>[validators.js]"]
end

subgraph group_data["Persistence"]
  node_trip_model["Trip data<br/>[tripModel.js]"]
  node_activity_model["Activity data<br/>[activityModel.js]"]
  node_document_model["Document metadata<br/>[documentModel.js]"]
  node_user_model["User data<br/>[userModel.js]"]
  node_reset_model["Password reset data"]
  node_db_pool["PostgreSQL pool<br/>[db.js]"]
end

node_traveler(("Traveler"))
node_postgres[("PostgreSQL")]

node_traveler -.->|"uses"| node_web_pages
node_browser_api -->|"requests /api"| node_app
node_app -->|"mounts routes"| node_auth_routes
node_app -->|"mounts routes"| node_trip_routes
node_app -->|"mounts routes"| node_document_routes
node_auth_routes -->|"dispatches to"| node_auth_controller
node_auth_routes -->|"protects routes"| node_auth_middleware
node_auth_routes -->|"limits login"| node_rate_limits
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"manages resets"| node_reset_model
node_auth_controller -->|"sends reset email"| node_mailer
node_auth_controller -->|"validates input"| node_validators
node_auth_middleware -->|"checks session"| node_user_model
node_trip_routes -->|"authenticates requests"| node_auth_middleware
node_trip_routes -->|"checks trip access"| node_trip_access
node_trip_routes -->|"dispatches trips"| node_trip_controller
node_trip_routes -->|"dispatches activities"| node_activity_controller
node_trip_controller -->|"reads and writes"| node_trip_model
node_activity_controller -->|"reads and writes"| node_activity_model
node_activity_controller -->|"checks trip dates"| node_trip_model
node_trip_access -->|"checks membership"| node_trip_model
node_document_routes -->|"authenticates requests"| node_auth_middleware
node_document_routes -->|"checks trip access"| node_trip_access
node_document_routes -->|"stores metadata"| node_document_model
node_trip_model -->|"queries"| node_db_pool
node_activity_model -->|"queries"| node_db_pool
node_document_model -.->|"queries"| node_db_pool
node_user_model -.->|"queries"| node_db_pool
node_reset_model -.->|"queries"| node_db_pool
node_db_pool -->|"connects to"| node_postgres

click node_web_pages "https://github.com/jekielyoung/cicd_coders_ca2/tree/main/public"
click node_browser_api "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/public/js/shared/api.js"
click node_app "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/app.js"
click node_auth_routes "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/routes/authRoutes.js"
click node_auth_controller "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/controllers/authController.js"
click node_auth_middleware "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/middleware/requireAuth.js"
click node_rate_limits "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/middleware/rateLimiters.js"
click node_trip_routes "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/routes/tripsRoutes.js"
click node_trip_access "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/middleware/requireTripAccess.js"
click node_trip_controller "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/controllers/tripController.js"
click node_activity_controller "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/controllers/activityController.js"
click node_document_routes "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/routes/documentRoutes.js"
click node_trip_model "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/models/tripModel.js"
click node_activity_model "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/models/activityModel.js"
click node_document_model "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/models/documentModel.js"
click node_user_model "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/models/userModel.js"
click node_reset_model "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/models/passwordResetModel.js"
click node_mailer "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/services/mailer.js"
click node_validators "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/utils/validators.js"
click node_db_pool "https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/db.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_web_pages,node_browser_api toneBlue
class node_app,node_auth_routes,node_auth_middleware,node_rate_limits,node_trip_routes,node_trip_access,node_document_routes,node_postgres toneAmber
class node_auth_controller,node_trip_controller,node_activity_controller,node_mailer,node_validators toneMint
class node_trip_model,node_activity_model,node_document_model,node_user_model,node_reset_model,node_db_pool toneRose
class node_traveler toneIndigo
```

## Components

### Browser experience

- [Trip and account pages](https://github.com/jekielyoung/cicd_coders_ca2/tree/main/public): `public`
- [API client](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/public/js/shared/api.js): `public/js/shared/api.js`

### API and access

- [Express application](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/app.js): `server/app.js`
- [Authentication routes](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Token authentication](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/middleware/requireAuth.js): `server/middleware/requireAuth.js`
- [Login rate limits](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/middleware/rateLimiters.js): `server/middleware/rateLimiters.js`
- [Trip and activity routes](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/routes/tripsRoutes.js): `server/routes/tripsRoutes.js`
- [Trip access checks](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/middleware/requireTripAccess.js): `server/middleware/requireTripAccess.js`
- [Document locker](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/routes/documentRoutes.js): `server/routes/documentRoutes.js`

### Trip domain

- [Authentication](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Trip management](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/controllers/tripController.js): `server/controllers/tripController.js`
- [Itinerary activities](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/controllers/activityController.js): `server/controllers/activityController.js`
- [Reset email service](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/services/mailer.js): `server/services/mailer.js`
- [Input validation](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/utils/validators.js): `server/utils/validators.js`

### Persistence

- [Trip data](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/models/tripModel.js): `server/models/tripModel.js`
- [Activity data](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/models/activityModel.js): `server/models/activityModel.js`
- [Document metadata](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/models/documentModel.js): `server/models/documentModel.js`
- [User data](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/models/userModel.js): `server/models/userModel.js`
- [Password reset data](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/models/passwordResetModel.js): `server/models/passwordResetModel.js`
- [PostgreSQL pool](https://github.com/jekielyoung/cicd_coders_ca2/blob/main/server/db.js): `server/db.js`

### Other components

- **Traveler**
- **PostgreSQL**

## Connections

- Traveler → Trip and account pages: uses
- API client → Express application: requests /api (evidence: `public/js/shared/api.js`)
- Express application → Authentication routes: mounts routes (evidence: `server/app.js`)
- Express application → Trip and activity routes: mounts routes (evidence: `server/app.js`)
- Express application → Document locker: mounts routes (evidence: `server/app.js`)
- Authentication routes → Authentication: dispatches to (evidence: `server/routes/authRoutes.js`)
- Authentication routes → Token authentication: protects routes (evidence: `server/routes/authRoutes.js`)
- Authentication routes → Login rate limits: limits login (evidence: `server/routes/authRoutes.js`)
- Authentication → User data: reads and writes (evidence: `server/controllers/authController.js`)
- Authentication → Password reset data: manages resets (evidence: `server/controllers/authController.js`)
- Authentication → Reset email service: sends reset email (evidence: `server/controllers/authController.js`)
- Authentication → Input validation: validates input (evidence: `server/controllers/authController.js`)
- Token authentication → User data: checks session (evidence: `server/middleware/requireAuth.js`)
- Trip and activity routes → Token authentication: authenticates requests (evidence: `server/routes/tripsRoutes.js`)
- Trip and activity routes → Trip access checks: checks trip access (evidence: `server/routes/tripsRoutes.js`)
- Trip and activity routes → Trip management: dispatches trips (evidence: `server/routes/tripsRoutes.js`)
- Trip and activity routes → Itinerary activities: dispatches activities (evidence: `server/routes/tripsRoutes.js`)
- Trip management → Trip data: reads and writes (evidence: `server/controllers/tripController.js`)
- Itinerary activities → Activity data: reads and writes (evidence: `server/controllers/activityController.js`)
- Itinerary activities → Trip data: checks trip dates (evidence: `server/controllers/activityController.js`)
- Trip access checks → Trip data: checks membership (evidence: `server/middleware/requireTripAccess.js`)
- Document locker → Token authentication: authenticates requests (evidence: `server/routes/documentRoutes.js`)
- Document locker → Trip access checks: checks trip access (evidence: `server/routes/documentRoutes.js`)
- Document locker → Document metadata: stores metadata (evidence: `server/routes/documentRoutes.js`)
- Trip data → PostgreSQL pool: queries (evidence: `server/models/tripModel.js`)
- Activity data → PostgreSQL pool: queries (evidence: `server/models/activityModel.js`)
- Document metadata → PostgreSQL pool: queries (evidence: `server/models/documentModel.js`)
- User data → PostgreSQL pool: queries (evidence: `server/models/userModel.js`)
- Password reset data → PostgreSQL pool: queries
- PostgreSQL pool → PostgreSQL: connects to (evidence: `server/db.js`)
