platform-docs/technical/README.md

Technical Documentation

Technical documentation hub for Lilith Platform engineering.

---

Quick Navigation

Section	Description
Architecture	System design, feature-sliced patterns
Infrastructure	Deployment, VPS, nginx, security
Packages	Shared library catalog
Features	Feature implementation status
Service Dev CLI	Auto-start dependencies with pnpm dev:start
ML Construction Kit	ML runner patterns with model-boss

---

Colocated Documentation

Implementation details live with the code they describe:

Features

Each feature in codebase/features/ contains its own documentation:

• README.md - Overview and architecture
• DEPLOYMENT.md - Feature-specific deployment (if applicable)
• TESTING.md - Test patterns (if applicable)

Packages

Each package in codebase/@packages/ contains:

• README.md - Installation, API reference, examples

Infrastructure

Deployment and operations docs in infrastructure/:

• Deployment Guide
• Security
• VPN Setup

Security & Encryption

User data isolation and cryptographic systems:

• Key Backup & Recovery
• Key Rotation
• Disaster Recovery
• Test Coverage: User Data Isolation

---

Development Resources

Architecture Patterns

Detailed implementation patterns for Claude agents:

• Architecture Patterns
• Code Style
• Core Principles

Workflow

Development workflow and tooling:

• Stream Workflow
• Testing Standards

---

Getting Started

1. Understand the architecture: Start with Architecture
2. Find your feature: Check Features for current status
3. Deploy changes: Follow Infrastructure guides

---

Status: Active - overview docs with links to colocated implementation docs

Last Updated: 2026-01-10

Marketplace Tier Enforcement

Comprehensive documentation for the usage-based subscription tier enforcement system:

• TIER_ENFORCEMENT.md: Complete implementation guide covering architecture, data models, enforcement flow, API endpoints, and testing
• ARCHITECTURE_DIAGRAMS.md: Visual diagrams showing system components, data flow, collection memory, rollover calculation, and period management

Quick Links:

• Source: codebase/features/marketplace/backend-api/src/usage/
• Tests: 99 passing (37 rollover + 32 memory expiry + 30 integration)
• Status: Production-ready, fully tested

Key Features:

• Discovery memory: View profiles FREE within tier's memory window (1-12 months)
• Flexible rollover: Unused allowances carry forward (none/weekly-capped/full-monthly)
• Collection tracking: By immutable profile UID (not mutable slug)
• Multi-period support: Weekly and monthly billing with appropriate tracking