βš™οΈ

Backend API & Services

Resilient, scalable services powering every field operation β€” from mobile sync to ESRI integration, background jobs, and structured observability

ASP.NET Core 10 Polly Resilience Multi-Tenant Hangfire Jobs EF Core Spatial ESRI Connector

Core Capabilities

The server-side backbone that connects mobile field apps to web dashboards, ESRI, and organizational systems

🌐

ASP.NET Core REST API

Standards-compliant REST API built on ASP.NET Core 10 with full OpenAPI 3.1 / Swagger documentation. All endpoints are versioned (URI versioning), support content negotiation, and return structured ProblemDetails error responses. HTTP client SDKs are auto-generated from the OpenAPI spec.

πŸ›‘οΈ

Polly Resilience Policies

Every outbound HTTP call β€” to ESRI ArcGIS, authentication providers, and external notification services β€” is wrapped with Polly 8.x resilience policies: exponential backoff retry (3 attempts), circuit breaker (5 failures / 30s open), timeout (30s per call), and bulkhead isolation to prevent cascade failures.

🏒

Multi-Tenant Data Isolation

Tenant-scoped repositories enforce row-level data isolation at the EF Core query interceptor level β€” no cross-tenant data leakage is possible even through developer error. Each tenant has its own configuration, feature flag set, GNSS accuracy thresholds, and ESRI portal credentials.

⏰

Background Job Processing

Hangfire 1.x manages scheduled and triggered background jobs: nightly compliance certificate generation, scheduled analytics report email delivery, periodic ESRI feature service sync, SLA breach detection sweeps, and audit log archival. Jobs are persistent, retryable, and visible in the Hangfire dashboard.

πŸ“‹

Serilog Structured Logging

Every request, background job, and domain event is logged with Serilog 3.x structured log entries. Each entry carries correlation ID, tenant ID, user identity, GNSS position (where applicable), request duration, and outcome β€” enabling precise log queries in any sink (Seq, Elasticsearch, Application Insights, CloudWatch).

πŸ—„οΈ

Entity Framework Core Spatial

EF Core 10 with NetTopologySuite (NTS) provides full spatial type support for geometry columns: Point, LineString, Polygon, and multi-variants stored in SQLite/SpatiaLite, SQL Server, or PostgreSQL/PostGIS. Spatial LINQ queries translate to native ST_ functions at the database β€” no manual SQL required.

πŸ”„

ESRI ArcGIS Connector

Managed typed HttpClient for ESRI ArcGIS REST API with token refresh, attachment sync, domain value cache, feature service version management, and geodatabase-to-GeoPackage conversion pipeline. Supports both named user and application credential auth flows for ArcGIS Online and Enterprise portals.

πŸ“’

Domain Event Architecture

MediatR-based domain event pipeline decouples core business logic from side effects. Compliance encroachment detected β†’ raises DomainEvent β†’ handled by: AuditHandler (log entry), WorkOrderHandler (auto-create WO), NotificationHandler (push alert to dispatch). New integrations add handlers without touching domain code.

Technical Specifications

Framework versions, library choices, and database compatibility

FrameworkASP.NET Core 10 / .NET 10
ORMEF Core 10 + NetTopologySuite
DatabasesSQLite/SpatiaLite, SQL Server, PostgreSQL/PostGIS
ResiliencePolly 8.x (retry, CB, timeout, bulkhead)
Background JobsHangfire 1.x with persistent job store
LoggingSerilog 3.x + structured enrichers
MessagingMediatR 12.x domain events / CQRS
API DocsOpenAPI 3.1 / Swashbuckle 7.x
Real-TimeASP.NET Core SignalR (WebSocket / SSE)
Auth ServerToken validation + Entra ID / OIDC integration

Service Integrations

External systems the backend connects and orchestrates

🌐

ESRI ArcGIS

Feature service sync, attachment upload, geodatabase

πŸ”‘

Entra ID / Okta

OIDC token validation & user provisioning

πŸ“§

SMTP / SendGrid

Scheduled report delivery & alert emails

πŸ“Š

Seq / App Insights

Structured log ingestion & monitoring

πŸ“¦

Azure Blob / S3

Evidence photo and certificate file storage

πŸ””

Push Notifications

FCM (Android) & WNS (Windows) via abstraction layer

Related Platform Features

Built for Scale, Reliability, and Auditability

Learn how the backend services integrate with your existing ESRI infrastructure and identity provider