Internal · Infrastructure Map
Avium Infrastructure
Every service, every layer, every connection. Top-to-bottom, from user click to persisted data.
Updated · 2026-05-21
App version · v2.4.0
Owner · Brian Akers
01
Audience
End User
Engineering managers, PMOs, and sprint leads running engineering teams on Jira or any work management tool. They open Avium when they need to know who's working on what, whether the team has capacity, and where delivery is at risk.
Chrome Safari Firefox Desktop primary Mobile responsive (planned)
HTTPS · TLS · www.getavium.com
02
Surface
Front End · React
A single-page application served as static assets directly from Railway. Tailwind for styling, React Router for client-side navigation, Zustand for auth state.
Login · Setup · Password Reset Dashboard Workload (Board · Phases · Matrix · List) Rollup (hierarchy tree — Logged · Committed · Estimated) Intelligence (Sprint Matrix · Patterns) Knowledge Graph (/intelligence/graph · React Flow) Docs · Admin · Billing
REST · JSON · JWT
03
Engine
Middleware · Express on Node 22
The brain of the platform. Authenticates every request, enforces plan-tier gates, applies rate limiting, and routes traffic to the right domain handler. Every business rule lives here. Authentication is dual-mode through one entry point — a human JWT or a machine API key both resolve to the same org context — and every request runs inside a tenant-isolation envelope a Prisma extension enforces, so a query physically cannot return another organization's data. Human sign-ins are server-tracked sessions with enterprise session hygiene: 15-minute access tokens silently renewed while the user is active (refresh credential in an httpOnly cookie scoped to the one renewal endpoint), a 60-minute sliding idle timeout enforced server-side, a 7-day absolute cap, and instant server-side revocation on sign-out — with idle expiries recorded in the audit trail. Every account also records privacy-policy consent — the version accepted and when — captured at sign-up and re-confirmed if the policy materially changes; the policy text renders from a single source file, so the sign-in consent step, the acceptance prompt, and the public /privacy page can never drift.
auth · org · super-admin jira · tickets · planning allocations · phases · dashboard demo-data · import/export stripe webhook + checkout /v1 API · per-key rate limit (Enterprise)
✦ Avium Signals Engine · Proprietary
Avium IP · not a vendor
The deterministic rules library that produces every insight card on the Insights page. No LLM, no vendor — domain-specific rules authored against real engineering teams. This is the moat. Customers on Team+ get the full engine; the AI layer (Anthropic, layer 4) is additive narrative on top. The catalog is admin-tunable per organization — a Signal Catalog (Settings) turns any Signal on/off and renames it without a deploy; new Signals ship into every organization automatically (one code registry, per-org override layer).
Milestone Risk (sprint · release · custom date) Kanban Flow Health (Delivery Time Target · throughput · WIP · work-item age) Regime + Re-baseline (set a date you can hit) Over-Allocation Rebalance (same-dept) Velocity Drift (cliff · trend swing · committed above the projected pace) Blocked / Stale Data Quality Lead Time (configurable) Time in Status (configurable) Dwell card Reopen Rate (configurable) Sprint Scope-Change (configurable) Sprint Creep card Flow Efficiency (configurable) Hand-off Cost (configurable) Workflow Sankey (configurable) Ping-Pong card (configurable) Dashboard KPI strip
server/src/lib/intelligenceEngine.ts server/src/lib/velocityForecastService.ts · defaultsVelocityForecast.ts — the Projected Delivery Band (velocity + Kanban throughput), read live at /v1/forecast/velocity server/src/lib/targetDeadline.ts · milestoneForecast.ts · milestoneRegime.ts · MilestoneBaseline model (/intelligence/rebaseline) server/src/lib/actionItems.ts · Avium Agents levers (/intelligence/action-items) server/src/lib/leadTimeService.ts server/src/lib/timeInStatusService.ts server/src/lib/reopenRateService.ts server/src/lib/sprintScopeChangeService.ts server/src/lib/flowEfficiencyService.ts server/src/lib/handOffCostService.ts server/src/lib/workflowSankeyService.ts server/src/lib/pingPongService.ts server/src/lib/signalSnapshots.ts — daily per-org snapshot capture (keys incl. wip-count, cycle-time-median) read via GET /intelligence/signal-history; grounds the rescaled Dashboard/Workload KPI-gauge baselines and the Brief's sparklines pure functions · unit-tested runs without an Anthropic key Team+ tier
ReportConfig model (Phase 5) TicketTransition + TicketFieldChange via expand=changelog TicketDependency via issuelinks (blocks / relates / duplicates) org default · per-user views · ad-hoc in-place rename · delete · clear org default unified page-level Date Range filter (presets + custom) never truncates output
04
Reach
↘ In-Data · Imports
External Sources
Where customer data enters the platform. Every record carries its origin tag.
Jira REST API · Azure DevOps REST API · Asana REST API · per-org token / PAT Excel / CSV upload (1k Free · 5k paid) In-app ticket create (Avium-native) GitHub auto-deploy webhooks
↓ Core · Persistence
Database
The system of record. Every ticket, allocation, time log, and resource lives here.
PostgreSQL (Railway) Prisma ORM · migrations postgres:18 image Append-only audit log · DB-trigger immutable · retry-durable writes (SOC 2) Nightly retention prune · bounds operational-log growth (send logs, webhook & delivery logs, expired cache, idempotency keys) Daily pg_dump → Cloudflare R2 (off-platform) · weekly tested restore drill · backup-liveness alarm Avium Files — org document storage on R2 (separate scoped bucket · presigned URLs · per-plan quotas)
↗ Out-Comms · Integrations
Outbound Services
Where Avium reaches out — for emails, payments, AI, and operational comms.
Resend · transactional email + daily briefing digest + closed-loop assignee nudges Instatus · public status page Stripe · checkout + billing Squarespace · DNS (getavium.com) Avium Signals · proprietary detection engine Avium API for Enterprise · outbound webhooks (signal · blocker · briefing · lever) — HMAC-SHA256 signed · exponential-backoff retry pump · SSRF-validated · replayable Connector auto-sync scheduler (Jira · Azure DevOps · Asana) — per-source cadence, OFF by default, plan caps + watermarks on every trigger path Real-time inbound webhooks · verified doorbell → debounced incremental sync — payloads never ingested; per-source verification (capability token · basic auth · handshake HMAC) Avium Automations · event + scheduled rules → email / outbound webhook — atomic episode claim · membership-checked delivery · daily-digest + hourly-cap controls