Actor Catalog¶
All Actors Across the NovaTrek Enterprise
29 Actors · 18 External Systems · 3 Frontend Applications · 5 Humans · 3 Infrastructures
This catalog lists every actor that interacts with the NovaTrek platform: people, frontend applications, internal microservices, external systems, and infrastructure components. Each card uses the same C4 model shapes and domain color scheme as the architecture diagrams.
Humans¶
Adventure GuideCertified outdoor guides who lead adventure trips, manage guest safety, and report incidents.Guide Management GuestNovaTrek customer who books, checks in for, and participates in adventure trips.Guest Identity Operations StaffOn-site NovaTrek employees who manage daily operations including check-in, scheduling, gear assignment, and incident response.Operations Software DeveloperImplements approved architecture designs in service source code, writes tests, and proposes API contract updates via pull request when implementation reveals contract gaps.Engineering Solution ArchitectOwns architecture metadata, API contracts, solution designs, decisions, and diagrams. Proposes and documents architectural changes to the NovaTrek platform.Architecture
Frontend Applications¶
app-guest-mobile[React Native]Native mobile application for guests to self check-in, view live trip maps, receive weather alerts, upload photos, and earn loyalty points.Guest Identity web-guest-portal[React SPA]Public-facing web application for guests to browse trips, book reservations, manage profiles, sign waivers, and view trip media.Guest Identity web-ops-dashboard[React SPA]Internal web application for operations staff to manage check-ins, daily schedules, guide assignments, safety incidents, and partner bookings.Operations
Infrastructure¶
API Gateway[Azure API Management]Central API Gateway that routes all external requests to backend microservices. Handles authentication, rate limiting, and TLS termination.Platform Event Bus[Apache Kafka]Apache Kafka cluster used for asynchronous event-driven communication between microservices. All domain events flow through dedicated Kafka topics.Platform Object Store[Azure Blob Storage]Cloud object storage for media assets including trip photos, guide profile images, and waiver documents.Platform
External Systems¶
Currency Exchange API[REST API]Real-time foreign currency exchange rate provider for converting international guest payments to the base operating currency.Support DocuSign API[DocuSign eSignature REST API]Electronic signature platform used for legally-binding adventure liability waivers and safety acknowledgments.Safety Firebase Cloud Messaging[Firebase FCM]Push notification delivery service for real-time alerts to guest mobile devices (weather warnings, check-in reminders, schedule changes).Support Fleet GPS Tracking API[REST API / WebSocket]Vehicle telematics and GPS tracking platform providing real-time location, speed, and ETA data for NovaTrek transport fleet vehicles including shuttles, vans, and boats.Logistics PCIFraud Detection API[REST API]Third-party fraud prevention service that scores payment transactions for risk before authorization.Support Google Maps Platform[Google Maps REST API]Geolocation and mapping service used for trail positioning, location tracking, and capacity management at adventure sites.Logistics IDVerify API[REST API]Identity verification service used during check-in to validate guest identity against government-issued IDs.Guest Identity Instagram Graph API[Instagram Graph REST API]Meta social media API enabling guests to share adventure trip photos and stories directly from the NovaTrek media gallery to their Instagram accounts.Support National Parks Permit API[REST API]Government parks and forestry service API for submitting trail access permits, validating permit status, and receiving seasonal trail closure notifications.Product Catalog OpenWeather API[OpenWeather REST API]Weather data provider delivering current conditions, forecasts, and severe weather alerts for trail and adventure locations.Support PCIPayment Gateway[Stripe]PCI-certified payment processing gateway that handles credit card authorization, capture, and refund transactions.Support Search and Rescue Dispatch API[REST API]Regional search and rescue coordination API for dispatching emergency response teams to backcountry locations during safety incidents.Safety SendGrid API[SendGrid REST API]Transactional email delivery service for reservation confirmations, waiver requests, and loyalty point notifications.Support Snowflake Data Cloud[Snowflake SQL API]Cloud data warehouse used for business intelligence, analytics aggregation, and historical trend analysis across all NovaTrek domains.Support PCIStripe API[Stripe REST API]Payment platform API for processing charges, managing payment methods, and handling disputes.Support Supplier Procurement Portal[REST API]External supplier ordering platform for procuring adventure gear, safety equipment, and consumable supplies from approved NovaTrek vendors.Logistics Travel Insurance API[REST API]Third-party travel insurance provider for quoting and binding adventure trip insurance policies based on activity risk level and participant profile.Booking Twilio API[Twilio REST API]SMS and messaging service for check-in reminders, schedule updates, and emergency notifications to guests and guides.Support
Internal Microservices¶
svc-reservationsBooking svc-partner-integrationsExternal svc-guest-profilesGuest Identity svc-guide-managementGuide Management svc-gear-inventoryLogistics svc-transport-logisticsLogistics svc-check-inOperations svc-scheduling-orchestratorOperations svc-trail-managementProduct Catalog svc-trip-catalogProduct Catalog svc-emergency-responseSafety svc-safety-complianceSafety svc-wildlife-trackingSafety svc-analyticsSupport svc-inventory-procurementSupport svc-location-servicesSupport svc-loyalty-rewardsSupport svc-media-gallerySupport svc-notificationsSupport svc-paymentsSupport svc-reviewsSupport svc-weatherSupport
Actor Details¶
API Gateway¶
- Type: Infrastructure
- Domain: Platform
- Description: Central API Gateway that routes all external requests to backend microservices. Handles authentication, rate limiting, and TLS termination.
- Technology: Azure API Management
Adventure Guide¶
- Type: Human
- Domain: Guide Management
- Description: Certified outdoor guides who lead adventure trips, manage guest safety, and report incidents.
Currency Exchange API¶
- Type: External System
- Domain: Support
- Description: Real-time foreign currency exchange rate provider for converting international guest payments to the base operating currency.
- Technology: REST API
Referenced by:
DocuSign API¶
- Type: External System
- Domain: Safety
- Description: Electronic signature platform used for legally-binding adventure liability waivers and safety acknowledgments.
- Technology: DocuSign eSignature REST API
Referenced by:
Event Bus¶
- Type: Infrastructure
- Domain: Platform
- Description: Apache Kafka cluster used for asynchronous event-driven communication between microservices. All domain events flow through dedicated Kafka topics.
- Technology: Apache Kafka
Referenced by:
Firebase Cloud Messaging¶
- Type: External System
- Domain: Support
- Description: Push notification delivery service for real-time alerts to guest mobile devices (weather warnings, check-in reminders, schedule changes).
- Technology: Firebase FCM
Referenced by:
Fleet GPS Tracking API¶
- Type: External System
- Domain: Logistics
- Description: Vehicle telematics and GPS tracking platform providing real-time location, speed, and ETA data for NovaTrek transport fleet vehicles including shuttles, vans, and boats.
- Technology: REST API / WebSocket
Referenced by:
Fraud Detection API¶
- Type: External System
- Domain: Support
- Description: Third-party fraud prevention service that scores payment transactions for risk before authorization.
- Technology: REST API
- Compliance: PCI DSS scope
Referenced by:
Google Maps Platform¶
- Type: External System
- Domain: Logistics
- Description: Geolocation and mapping service used for trail positioning, location tracking, and capacity management at adventure sites.
- Technology: Google Maps REST API
Referenced by:
Guest¶
- Type: Human
- Domain: Guest Identity
- Description: NovaTrek customer who books, checks in for, and participates in adventure trips.
IDVerify API¶
- Type: External System
- Domain: Guest Identity
- Description: Identity verification service used during check-in to validate guest identity against government-issued IDs.
- Technology: REST API
Referenced by:
Instagram Graph API¶
- Type: External System
- Domain: Support
- Description: Meta social media API enabling guests to share adventure trip photos and stories directly from the NovaTrek media gallery to their Instagram accounts.
- Technology: Instagram Graph REST API
Referenced by:
National Parks Permit API¶
- Type: External System
- Domain: Product Catalog
- Description: Government parks and forestry service API for submitting trail access permits, validating permit status, and receiving seasonal trail closure notifications.
- Technology: REST API
Referenced by:
Object Store¶
- Type: Infrastructure
- Domain: Platform
- Description: Cloud object storage for media assets including trip photos, guide profile images, and waiver documents.
- Technology: Azure Blob Storage
Referenced by:
OpenWeather API¶
- Type: External System
- Domain: Support
- Description: Weather data provider delivering current conditions, forecasts, and severe weather alerts for trail and adventure locations.
- Technology: OpenWeather REST API
Referenced by:
Operations Staff¶
- Type: Human
- Domain: Operations
- Description: On-site NovaTrek employees who manage daily operations including check-in, scheduling, gear assignment, and incident response.
Payment Gateway¶
- Type: External System
- Domain: Support
- Description: PCI-certified payment processing gateway that handles credit card authorization, capture, and refund transactions.
- Technology: Stripe
- Compliance: PCI DSS scope
Referenced by:
Search and Rescue Dispatch API¶
- Type: External System
- Domain: Safety
- Description: Regional search and rescue coordination API for dispatching emergency response teams to backcountry locations during safety incidents.
- Technology: REST API
Referenced by:
SendGrid API¶
- Type: External System
- Domain: Support
- Description: Transactional email delivery service for reservation confirmations, waiver requests, and loyalty point notifications.
- Technology: SendGrid REST API
Referenced by:
Snowflake Data Cloud¶
- Type: External System
- Domain: Support
- Description: Cloud data warehouse used for business intelligence, analytics aggregation, and historical trend analysis across all NovaTrek domains.
- Technology: Snowflake SQL API
Referenced by:
Software Developer¶
- Type: Human
- Domain: Engineering
- Description: Implements approved architecture designs in service source code, writes tests, and proposes API contract updates via pull request when implementation reveals contract gaps.
Solution Architect¶
- Type: Human
- Domain: Architecture
- Description: Owns architecture metadata, API contracts, solution designs, decisions, and diagrams. Proposes and documents architectural changes to the NovaTrek platform.
Stripe API¶
- Type: External System
- Domain: Support
- Description: Payment platform API for processing charges, managing payment methods, and handling disputes.
- Technology: Stripe REST API
- Compliance: PCI DSS scope
Supplier Procurement Portal¶
- Type: External System
- Domain: Logistics
- Description: External supplier ordering platform for procuring adventure gear, safety equipment, and consumable supplies from approved NovaTrek vendors.
- Technology: REST API
Referenced by:
Travel Insurance API¶
- Type: External System
- Domain: Booking
- Description: Third-party travel insurance provider for quoting and binding adventure trip insurance policies based on activity risk level and participant profile.
- Technology: REST API
Referenced by:
Twilio API¶
- Type: External System
- Domain: Support
- Description: SMS and messaging service for check-in reminders, schedule updates, and emergency notifications to guests and guides.
- Technology: Twilio REST API
Referenced by:
app-guest-mobile¶
- Type: Frontend Application
- Domain: Guest Identity
- Description: Native mobile application for guests to self check-in, view live trip maps, receive weather alerts, upload photos, and earn loyalty points.
- Technology: React Native
- Team: Guest Experience Team
Referenced by:
- svc-check-in
- svc-emergency-response
- svc-gear-inventory
- svc-guest-profiles
- svc-location-services
- svc-loyalty-rewards
- svc-media-gallery
- svc-notifications
- svc-payments
- svc-reservations
- svc-safety-compliance
- svc-scheduling-orchestrator
- svc-trail-management
- svc-trip-catalog
- svc-weather
- svc-wildlife-tracking
web-guest-portal¶
- Type: Frontend Application
- Domain: Guest Identity
- Description: Public-facing web application for guests to browse trips, book reservations, manage profiles, sign waivers, and view trip media.
- Technology: React SPA
- Team: Guest Experience Team
Referenced by:
- svc-guest-profiles
- svc-loyalty-rewards
- svc-media-gallery
- svc-notifications
- svc-payments
- svc-reservations
- svc-safety-compliance
- svc-trail-management
- svc-trip-catalog
- svc-weather
web-ops-dashboard¶
- Type: Frontend Application
- Domain: Operations
- Description: Internal web application for operations staff to manage check-ins, daily schedules, guide assignments, safety incidents, and partner bookings.
- Technology: React SPA
- Team: NovaTrek Operations Team
Referenced by:
- svc-analytics
- svc-check-in
- svc-emergency-response
- svc-gear-inventory
- svc-guest-profiles
- svc-guide-management
- svc-inventory-procurement
- svc-location-services
- svc-notifications
- svc-partner-integrations
- svc-payments
- svc-reservations
- svc-safety-compliance
- svc-scheduling-orchestrator
- svc-trail-management
- svc-transport-logistics
- svc-weather
- svc-wildlife-tracking
svc-analytics¶
- Type: Internal Microservice
- Domain: Support
- Details: svc-analytics Microservice Page
svc-check-in¶
- Type: Internal Microservice
- Domain: Operations
- Details: svc-check-in Microservice Page
svc-emergency-response¶
- Type: Internal Microservice
- Domain: Safety
- Details: svc-emergency-response Microservice Page
svc-gear-inventory¶
- Type: Internal Microservice
- Domain: Logistics
- Details: svc-gear-inventory Microservice Page
svc-guest-profiles¶
- Type: Internal Microservice
- Domain: Guest Identity
- Details: svc-guest-profiles Microservice Page
svc-guide-management¶
- Type: Internal Microservice
- Domain: Guide Management
- Details: svc-guide-management Microservice Page
svc-inventory-procurement¶
- Type: Internal Microservice
- Domain: Support
- Details: svc-inventory-procurement Microservice Page
svc-location-services¶
- Type: Internal Microservice
- Domain: Support
- Details: svc-location-services Microservice Page
svc-loyalty-rewards¶
- Type: Internal Microservice
- Domain: Support
- Details: svc-loyalty-rewards Microservice Page
svc-media-gallery¶
- Type: Internal Microservice
- Domain: Support
- Details: svc-media-gallery Microservice Page
svc-notifications¶
- Type: Internal Microservice
- Domain: Support
- Details: svc-notifications Microservice Page
svc-partner-integrations¶
- Type: Internal Microservice
- Domain: External
- Details: svc-partner-integrations Microservice Page
svc-payments¶
- Type: Internal Microservice
- Domain: Support
- Details: svc-payments Microservice Page
svc-reservations¶
- Type: Internal Microservice
- Domain: Booking
- Details: svc-reservations Microservice Page
svc-reviews¶
- Type: Internal Microservice
- Domain: Support
- Details: svc-reviews Microservice Page
svc-safety-compliance¶
- Type: Internal Microservice
- Domain: Safety
- Details: svc-safety-compliance Microservice Page
svc-scheduling-orchestrator¶
- Type: Internal Microservice
- Domain: Operations
- Details: svc-scheduling-orchestrator Microservice Page
svc-trail-management¶
- Type: Internal Microservice
- Domain: Product Catalog
- Details: svc-trail-management Microservice Page
svc-transport-logistics¶
- Type: Internal Microservice
- Domain: Logistics
- Details: svc-transport-logistics Microservice Page
svc-trip-catalog¶
- Type: Internal Microservice
- Domain: Product Catalog
- Details: svc-trip-catalog Microservice Page
svc-weather¶
- Type: Internal Microservice
- Domain: Support
- Details: svc-weather Microservice Page
svc-wildlife-tracking¶
- Type: Internal Microservice
- Domain: Safety
- Details: svc-wildlife-tracking Microservice Page