documenso-reference-architecture

# Documenso Reference Architecture ## Overview Production-ready architecture for Documenso document signing integrations. Covers project layout, layered service architecture, webhook processing, and data flow. ## Prerequisites - Understanding of layered architecture principles - Documenso SDK knowledge (see `documenso-sdk-patterns`) - TypeScript project with Node.js 18+ ## Recommended Project Structure ``` my-signing-app/ ├── src/ │ ├── documenso/ │ │ ├── client.ts # Singleton SDK client │ │ ├── errors.ts # Custom error classes │ │ ├── retry.ts # Retry/backoff logic │ │ └── types.ts # Shared types │ ├── services/ │ │ ├── document-service.ts # Document CRUD operations │ │ ├── template-service.ts # Template-based workflows │ │ └── signing-service.ts # Orchestrates signing flows │ ├── webhooks/ │ │ ├── handler.ts # Express webhook router │ │ ├── verify.ts # Secret verification │ │ └── processors/ │ │ ├── document-completed.ts │ │ ├── document-signed.ts │ │ └── document-rejected.ts │ ├── api/ │ │ ├── health.ts # Health check endpoint │ │ └── routes.ts # API routes │ └── config/ │ └── index.ts # Environment configuration ├── scripts/ │ ├── verify-connection.ts # Quick health check │ ├── create-test-doc.ts # Test document generator │ └── clean...