Human Signal Index
Documentation

Developer Overview

High-level architecture of Human Signal Index for developers: frontend, backend, database, RBAC, pipelines, testing, and deployment.

A high-level view of how HSI is built. No secrets, environment values, or credentials are listed here.

Frontend

A Next.js App Router application with a shared design system. Public marketing pages and the authenticated dashboard share components.

Backend

Server components and server actions handle data access. Read paths degrade gracefully and avoid throwing to the page.

Database

A managed Postgres database with row-level security. Schema changes are versioned as migrations.

RBAC

Roles are resolved from the database and enforced both in middleware (route gates) and navigation visibility.

Source pipeline

Sources are imported and reviewed, then monitored. Capture is human-gated; nothing activates automatically.

Research pipeline

Signals, evidence, narratives, and forecasts are linked through an evidence graph that records provenance.

Testing

Deterministic unit tests cover the pure logic layers; the suite runs in CI before deploy.

Deployment

The app deploys to a managed platform with preview and production environments.

Environment management

Configuration is provided through environment variables. Values and secrets are never published.