Home

Eagle Documentation

Central documentation for the Eagle (EPIC) repositories. Eagle is the Environmental Assessment Office's (EAO) public system for publishing environmental assessment information in British Columbia.

Repositories

Repository	Description	Links
eagle-public	Public Angular application	Dev · Test · Prod
eagle-admin	Admin Angular application	Dev · Test · Prod
eagle-api	Node.js REST API	Dev · Test · Prod
eao-nginx	Reverse proxy (rproxy)	-
eagle-analytics	Product analytics and audit events (Azure)	-
eagle-demi	Central data store and search (Azure)	-
eagle-edge	Azure Front Door and observability (Bicep)	-
eagle-search	Archived and retired; search is served by DEMI	-
eagle-helper-pods	OpenShift helper scripts and functional tests	-

System Architecture

flowchart LR
    User["User"] --> Edge["Azure Front Door<br/>eagle-public bundle"]
    Edge --> Admin["eagle-admin"]
    Edge --> API["eagle-api"]
    Edge --> Analytics["demi-apim-&lt;env&gt;"]
    Edge --> DEMI["DEMI search"]
    API --> MongoDB[("MongoDB")]
    API -->|push on write| DEMI
    Analytics --> TimescaleDB[("TimescaleDB")]

Loading

Front Door holds a separate origin group per app on both test and prod; see Azure Hosting.

See Architecture Overview for the full diagram, including authentication and data flows.

Documentation

Operations

• Deployment Pipeline - CI/CD workflows, triggers, promotion
• Helm Charts - OpenShift deployment configuration
• Reverse Proxy - rproxy paths and upstreams
• Rollback Procedures - Rolling back a release
• Eagle Public Release Lines - When a change needs its own branch and preview URL, and how to ship it
• Azure Migration Strategy - What runs on Azure and in what order
• Azure Hosting - eagle-public on Front Door
• Front Door Per-App Split - per-app origin groups, rproxy retirement
• Error Logging - Application Insights, connecting a product, querying errors
• Eagle Search Archive - Frozen eagle-search estate and rollback
• Secrets Management - Key Vault, secret-sync, adding and rotating a secret

Architecture

• Architecture Overview - Components and request flow
• API Architecture - eagle-api structure
• Analytics Architecture - eagle-analytics
• Angular Patterns - Signals, loading state, RxJS, shared components
• Eagle Public Page Layout - Page container, shared masthead band, breadcrumbs (react line)
• Eagle Public Adding A Page - Steps for wiring a new page into the shared layout (react line)
• ENGAGE–EAGLE Integration - Comment period sync
• BCGW Project Export - CSV of published projects that DataBC pulls
• Eagle Search - Search backend by environment
• Document Content Search - Full-text search over document content
• Eagle DEMI - Central data store, Cosmos DB, AI Search
• Project Data Models - Track, Eagle and DEMI project schemas
• Async Jobs API - Background jobs
• Bulk Document Download - ADR, proposed

Configuration

• Configuration Management - /api/config and environment settings
• Keycloak Configuration - Authentication
• Local Development - Development environment setup

Help

• Troubleshooting - Symptoms, causes, fixes

Quick Links

• OpenShift console: console.apps.silver.devops.gov.bc.ca
• Namespaces: 6cdc9e-dev / 6cdc9e-test / 6cdc9e-prod / 6cdc9e-tools
• Image registry: image-registry.apps.silver.devops.gov.bc.ca
• Deployed versions: read from the Deploy to Prod workflow runs in each repo