Specifications Overview

This section contains technical specifications and documentation for the Law Firm Backstage API System - a unified backend comprising Admin API (provisioning) and User API (portal operations).

📋 Documentation Structure

Backstage API Technical Specification ⭐ START HERE

Complete unified technical specification for the Backstage API System - covering all internal law firm operations:

• Admin API (37 endpoints) - Firm provisioning, user management, access grants, support access
• User API (41 endpoints) - Cases, clients, documents, time tracking, invoices, notifications
• Authentication & Authorization (Logto OIDC/OAuth 2.0)
• Data models & schemas (100+ tables across 23 slices)
• Error handling & performance targets
• Security & compliance (GDPR, SOC 2, HIPAA)
• Deployment & monitoring strategy

API Reference (OpenAPI Documentation)

Interactive API documentation with try-it-out functionality:

• Admin API - 37 administrative endpoints
• User API - 41 user-facing endpoints

🔗 Related Documentation

Architecture Documentation

• Backstage API C4 Models - Complete C4 architecture documentation
  • System Context, Container, Component, and Code levels
  • Deployment architecture (AWS multi-AZ)
  • Security architecture (defense in depth)
  • Monitoring & observability stack

Data & Schema

• Database Schema - Complete ERD with 23 slices and 100+ tables

Getting Started

• Introduction - System overview
• C4 Architecture Models - Architecture documentation