How dartmouth-outing-club/doc-trailhead works
DOC Trailhead is a server-rendered trip-management web application. Users browse and sign up for trips, manage profiles and gear or vehicle requests, and receive HTML responses tailored to their permissions. Leaders and OPO staff handle trip, gear, profile, and fleet approvals. The documented architecture uses Express routes, Nunjucks views, HTMX interactivity, and SQLite. The graph reflects README and indexed references; unsampled route implementations are represented at their exact paths, and their internal call details are not inferred.
Main entry points: router.js Route dispatch · server.js HTTP server · mailer.js Mail delivery · trip.js Trip management
Components 22
Web runtime
- HTTP server
src/server.js - Route dispatch
src/router.js - HTML views
src/templates
Trip operations
- Trip management
src/routes/trip.js - Trip cards
src/routes/trip/trip-card.js - Trip members
src/routes/trip/trip-members.js - Trip requests
src/routes/trip/trip-requests.js - Check-in/out
src/routes/trip/check-in.js - Gear requests
src/routes/trip/gear/gear.js - Vehicle requests
src/routes/vehicle-request.js
Approvals and profiles
- User profiles
src/routes/profile.js - Club oversight
src/routes/chair/trip-overview.js - Gear approvals
src/routes/opo/gear-approvals.js - Profile approvals
src/routes/opo/profile-approvals.js - Fleet requests
src/routes/opo/vehicle-requests.js
Data and messaging
- SQLite database
src/services/sqlite.js - Email workflows
src/emails.js - Mail delivery
src/services/mailer.js - Scheduled notices
src/app.js
Other components
- Browser user
- Microsoft Graph
- OIDC identity
Connections 28
- Browser user → HTTP server: requests pages
README.md - HTTP server → OIDC identity: configures OIDC
src/server.js - HTTP server → Route dispatch: dispatches routes
src/server.js - Route dispatch → Trip management: routes trip actions
src/router.js - Route dispatch → User profiles: routes profile actions
src/router.js - Route dispatch → Trip members: routes membership
src/router.js - Route dispatch → Trip requests: routes trip requests
src/router.js - Route dispatch → Check-in/out: routes check-in
src/router.js - Route dispatch → Gear requests: routes gear
src/router.js - Route dispatch → Gear approvals: routes approvals
src/router.js - Route dispatch → Profile approvals: routes approvals
src/router.js - Route dispatch → Fleet requests: routes fleet
src/router.js - Route dispatch → Club oversight: routes oversight
src/router.js - HTTP server → SQLite database: attaches database
src/server.js - HTTP server → HTML views: configures rendering
src/server.js - Trip management → SQLite database: reads and writes
src/routes/trip.js - Trip management → Trip cards: renders trip cards
src/routes/trip.js - Trip cards → Vehicle requests: loads vehicle data
src/routes/trip/trip-card.js - Gear approvals → Trip cards: renders leader card
src/routes/opo/gear-approvals.js - Gear approvals → Vehicle requests: renders request table
src/routes/opo/gear-approvals.js - User profiles → SQLite database: reads and writes
src/routes/profile.js - Vehicle requests → SQLite database: reads request data
src/routes/vehicle-request.js - Trip members → Mail delivery: sends notices
src/routes/trip/trip-members.js - Trip management → Mail delivery: sends notices
src/routes/trip.js - Gear approvals → Mail delivery: sends notices
src/routes/opo/gear-approvals.js - Mail delivery → Microsoft Graph: sends email
src/services/mailer.js - Scheduled notices → Email workflows: selects scheduled notices
src/app.js - Scheduled notices → Mail delivery: schedules delivery
src/app.js