HV is a document intelligence platform for mortgage underwriting. It ingests loan and collateral documents, extracts structured sections, runs AI-assisted analysis, and routes results to automated policy checks or human review.

• services/ui and services/ui-server: React + Node entrypoints for users, auth/session, and API aggregation.
• services/orchestrator: Go service for document registration, delta detection, workflow orchestration, and policy routing.
• services/intelligence: Python service for document ontology, ingestion/OCR/parsing, context assembly, and AI worker analysis.
• api/openapi.yaml: single API contract used for multi-language code generation.

• docs/: architecture, domain, workflows, services, and integrations.
• api/: OpenAPI spec and API/codegen notes.
• services/: deployable services by responsibility.
• packages/: shared workspace packages (currently TypeScript API types).
• scripts/: setup and codegen helpers.

Start here:

• Architecture Overview

Core references:

• Monorepo Structure
• Temporal Workflows
• Document Model
• Document Ontology

Service docs:

• Document Orchestrator (Go)
• Ingestion Service (Python)
• Analysis Dispatcher (Python)
• UI Server (Node.js)

Integration docs:

• LOS Integration
• UCDP Integration
• Textract Integration

API and codegen:

• OpenAPI Spec
• Parsers and Codegen Notes

• bash scripts/setup-dev.sh for development environment setup.
• bash scripts/setup-db.sh to start/initialize local Postgres (idempotent).
• bash scripts/codegen.sh to regenerate API models across TypeScript, Go, and Python.
• make dev to start local Postgres + orchestrator + intelligence via Docker Compose.