The Order

A comprehensive platform for digital identity, verifiable credentials, and legal document management

Overview

The Order is a sovereign cloud platform providing:

• Digital Identity Management: eIDAS/DID-based identity verification
• Verifiable Credentials: Microsoft Entra VerifiedID integration
• Legal Document Management: Comprehensive DMS for law firms and courts
• Virtual Data Rooms: Secure deal management
• Financial Services: Payment processing and invoicing
• e-Residency: Digital residency services

Built with Cloud for Sovereignty principles, ensuring data residency, compliance, and operational control.

Quick Start

Prerequisites

• Node.js >= 18.0.0
• pnpm >= 8.0.0
• Docker & Docker Compose
• Azure CLI (for deployments)
• Terraform >= 1.5.0 (for infrastructure)

Installation

# Clone repository
git clone <repository-url>
cd the-order

# Install dependencies
pnpm install

# Start local services (PostgreSQL, Redis, OpenSearch)
docker-compose up -d

# Build all packages
pnpm build

# Start development servers
pnpm dev

Environment Setup

1. Copy .env.example to .env
2. Configure Azure credentials:

   ARM_SUBSCRIPTION_ID="your-subscription-id"
   ARM_TENANT_ID="your-tenant-id"
   ARM_LOCATION="westeurope"
   

3. Load environment:

   source infra/scripts/azure-load-env.sh
   

Project Structure

the-order/
├── apps/              # Frontend applications
├── services/          # Backend microservices
├── packages/          # Shared libraries
├── infra/             # Infrastructure as Code
├── docs/              # Documentation
└── scripts/           # Utility scripts

📖 See PROJECT_STRUCTURE.md for detailed structure guide

Architecture

Services

• Identity Service (services/identity/): eIDAS/DID, verifiable credentials, Entra VerifiedID
• Intake Service (services/intake/): Document ingestion, OCR, classification
• Finance Service (services/finance/): Payments, ledgers, invoicing
• Dataroom Service (services/dataroom/): Virtual data rooms, deal management
• Legal Documents Service (services/legal-documents/): Comprehensive document management
• e-Residency Service (services/eresidency/): Digital residency services

Applications

• MCP Legal (apps/mcp-legal/): Legal document management portal
• Portal Public (apps/portal-public/): Public-facing member portal
• Portal Internal (apps/portal-internal/): Internal administrative portal

Infrastructure

• Terraform (infra/terraform/): Azure infrastructure, Cloud for Sovereignty landing zones
• Kubernetes (infra/k8s/): Container orchestration
• Monitoring (infra/monitoring/): Prometheus, Grafana

Documentation

Getting Started

• Project Structure - Complete structure guide
• Quick Start Guide - Development setup
• Architecture Overview - System architecture

Deployment

• Azure Deployment - Azure setup
• Sovereignty Landing Zone - Multi-region deployment
• Kubernetes Deployment - K8s deployment guide

Architecture

• Cloud for Sovereignty Landing Zone - Complete architecture
• Well-Architected Framework - Architecture principles
• Data Models - Entity relationships

Integrations

• Entra VerifiedID - Credential issuance
• Azure CDN - CDN configuration

Legal System

• Document Management - DMS documentation
• API Documentation - API reference

Development

Commands

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

# Start development
pnpm dev

# Lint code
pnpm lint

# Type check
pnpm type-check

Working with Services

# Start specific service
pnpm --filter @the-order/identity-service dev

# Build specific service
pnpm --filter @the-order/identity-service build

# Test specific service
pnpm --filter @the-order/identity-service test

Working with Packages

# Build specific package
pnpm --filter @the-order/database build

# Test specific package
pnpm --filter @the-order/database test

Infrastructure

Azure Deployment

# Load environment
source infra/scripts/azure-load-env.sh

# Deploy infrastructure
./infra/scripts/azure-deploy.sh

# Deploy sovereignty landing zone
./infra/scripts/deploy-sovereignty-landing-zone.sh

Kubernetes Deployment

# Apply base configuration
kubectl apply -k infra/k8s/base

# Apply environment overlay
kubectl apply -k infra/k8s/overlays/dev

Key Features

Digital Identity

• ✅ eIDAS compliance
• ✅ DID (Decentralized Identifiers)
• ✅ Microsoft Entra VerifiedID
• ✅ Verifiable Credentials

Document Management

• ✅ Document templates
• ✅ Version control
• ✅ Legal matter management
• ✅ Court filing integration
• ✅ Real-time collaboration
• ✅ E-signatures

Security & Compliance

• ✅ Cloud for Sovereignty
• ✅ Data residency enforcement
• ✅ Customer-managed encryption
• ✅ Private endpoints
• ✅ GDPR & eIDAS compliance

Infrastructure

• ✅ Multi-region deployment (7 regions)
• ✅ Well-Architected Framework
• ✅ Infrastructure as Code
• ✅ Automated deployments
• ✅ Comprehensive monitoring

Technology Stack

Frontend

• React 18+
• Next.js 14+
• TypeScript
• Tailwind CSS
• Material-UI

Backend

• Node.js 18+
• TypeScript
• Fastify
• PostgreSQL
• Redis

Infrastructure

• Azure (non-US commercial regions)
• Kubernetes
• Terraform
• Docker

Monitoring

• Prometheus
• Grafana
• OpenTelemetry
• Log Analytics

Contributing

See CONTRIBUTING.md for contribution guidelines.

Security

See SECURITY.md for security policies and reporting.

License

See LICENSE for license information.

Support

• Documentation: See docs/ directory
• Architecture: See docs/architecture/
• Deployment: See docs/deployment/
• Issues: Use GitHub Issues

Status

Current Status: Active Development

• ✅ Core services implemented
• ✅ Legal document management complete
• ✅ Entra VerifiedID integration complete
• ✅ Multi-region infrastructure planned
• 🔄 Testing and optimization in progress

See docs/reports/ for detailed status reports.

---

Last Updated: 2025-01-27