Actor Catalog¶

This catalog lists every actor that interacts with the NovaTrek platform: people, frontend applications, internal microservices, external systems, and infrastructure components. Each actor links to its detailed page where available.

Humans¶

Frontend Applications¶

Infrastructures¶

External Systems¶

Internal Microservices¶

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.

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:

• svc-safety-compliance

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:

• svc-guest-profiles
• svc-reservations

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:

• svc-notifications

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:

• svc-payments

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:

• svc-location-services
• svc-media-gallery
• svc-transport-logistics

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:

• svc-guest-profiles

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:

• svc-media-gallery

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:

• svc-weather

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:

• svc-payments

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:

• svc-notifications

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:

• svc-analytics

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

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:

• svc-notifications

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-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