# Dwilar/lita-api This documentation space, named **Dwilar/lita-api**, outlines the entire API monorepo infrastructure, covering its architecture, build system, runtime configuration, and external SDKs. It details how the core **HTTP API server** (`apps/api`) and the asynchronous **Webhook Delivery Worker** (`apps/worker`) are built and run, along with the structure of the official **Node.js, Java, and Python SDKs**. The content emphasizes the importance of **contract-first design**, detailing the **canonical processing pipeline** (Applicant → Consent → Data → Features → Score → Evidence), and how this contract is specified across multiple documentation artifacts (such as `docs-api.md` and regional OpenAPI files). Key foundational elements like tenant context propagation via middleware (`authPlugin`, `tenantPlugin`), tenant administration routes, request tracing (`X-Request-Id`), and audit logging are thoroughly documented. This space is essential for developers working on the API backend, the worker process, or maintaining the official client integration libraries. * **Core Runtime:** API server middleware stack and worker polling logic. * **Tenant Management:** API for creating tenants, the strict tenant context propagation pipeline, and idempotency enforcement. * **Regional Endpoints:** The structure of the US and JP surfaces, including consent flow and data access contracts. * **SDK Integration:** The structure and responsibilities of the Node.js, Java, and Python SDKs, including error handling and webhook verification. * **Tooling:** Scripts for local bootstrap, smoke testing, and automatic documentation generation. Request any document URL with `Accept: text/markdown` to read it as Markdown. ## Deployment, Gateway, and Infrastructure - [Kong edge routing, rate limiting, and network trust model](https://docs.docuwriter.ai/dwilarlita-api/deployment-gateway-and-infrastructure/kong-edge-routing-rate-limiting-and-network-trust-model) - [Container build strategy for API, worker, and side services](https://docs.docuwriter.ai/dwilarlita-api/deployment-gateway-and-infrastructure/container-build-strategy-for-api-worker-and-side-services) - [VM migration runbook, environment variables, and infra placeholders](https://docs.docuwriter.ai/dwilarlita-api/deployment-gateway-and-infrastructure/vm-migration-runbook-environment-variables-and-infra-placeholders) ## Internal Workspace and Project Memory - [Decision logs, team memory, and change-management discipline](https://docs.docuwriter.ai/dwilarlita-api/internal-workspace-and-project-memory/decision-logs-team-memory-and-change-management-discipline) ## Regional Data Gateways DOMAIN - [US and JP route modules, parity, and region-specific request paths](https://docs.docuwriter.ai/dwilarlita-api/regional-data-gateways-domain/us-and-jp-route-modules-parity-and-region-specific-request-paths) - [US API service internals and the US data-gateway boundary](https://docs.docuwriter.ai/dwilarlita-api/regional-data-gateways-domain/us-api-service-internals-and-the-us-data-gateway-boundary) - [JP API service internals and Japan-specific contract differences](https://docs.docuwriter.ai/dwilarlita-api/regional-data-gateways-domain/jp-api-service-internals-and-japan-specific-contract-differences) ## Consent and Evidence Management DOMAIN - [Evidence retention, async status polling, and audit use cases](https://docs.docuwriter.ai/dwilarlita-api/consent-and-evidence-management-domain/evidence-retention-async-status-polling-and-audit-use-cases) - [Consent lifecycle contracts across API docs and SDK resources](https://docs.docuwriter.ai/dwilarlita-api/consent-and-evidence-management-domain/consent-lifecycle-contracts-across-api-docs-and-sdk-resources) - [Evidence snapshots, transactions, and KYC retrieval surfaces](https://docs.docuwriter.ai/dwilarlita-api/consent-and-evidence-management-domain/evidence-snapshots-transactions-and-kyc-retrieval-surfaces) ## Authentication and Authorization DOMAIN - [Request authentication, token resolution, and trust boundaries](https://docs.docuwriter.ai/dwilarlita-api/authentication-and-authorization-domain/request-authentication-token-resolution-and-trust-boundaries) - [Authorization checks, scope enforcement, and introspection endpoints](https://docs.docuwriter.ai/dwilarlita-api/authentication-and-authorization-domain/authorization-checks-scope-enforcement-and-introspection-endpoints) - [Webhook signature verification and auth-adjacent SDK support](https://docs.docuwriter.ai/dwilarlita-api/authentication-and-authorization-domain/webhook-signature-verification-and-auth-adjacent-sdk-support) ## Architecture and Runtime Foundations - [Monorepo layout, workspace boundaries, and build graph](https://docs.docuwriter.ai/dwilarlita-api/architecture-and-runtime-foundations/monorepo-layout-workspace-boundaries-and-build-graph) - [API bootstrap, middleware stack, and process model](https://docs.docuwriter.ai/dwilarlita-api/architecture-and-runtime-foundations/api-bootstrap-middleware-stack-and-process-model) - [Contract-first documentation and regional specifications](https://docs.docuwriter.ai/dwilarlita-api/architecture-and-runtime-foundations/contract-first-documentation-and-regional-specifications) ## Tenant Management DOMAIN - [Sandbox tenant seeding and tenant-aware demo data](https://docs.docuwriter.ai/dwilarlita-api/tenant-management-domain/sandbox-tenant-seeding-and-tenant-aware-demo-data) - [Tenant administration routes and audit trail expectations](https://docs.docuwriter.ai/dwilarlita-api/tenant-management-domain/tenant-administration-routes-and-audit-trail-expectations) - [Tenant context propagation and isolation in the request pipeline](https://docs.docuwriter.ai/dwilarlita-api/tenant-management-domain/tenant-context-propagation-and-isolation-in-the-request-pipeline) ## SDKs and External Integration Surface - [Python SDK resources, shared errors, and webhook helpers](https://docs.docuwriter.ai/dwilarlita-api/sdks-and-external-integration-surface/python-sdk-resources-shared-errors-and-webhook-helpers) - [Java SDK HTTP layer, models, params, and resources](https://docs.docuwriter.ai/dwilarlita-api/sdks-and-external-integration-surface/java-sdk-http-layer-models-params-and-resources) - [Node SDK client, shared types, and resource wrappers](https://docs.docuwriter.ai/dwilarlita-api/sdks-and-external-integration-surface/node-sdk-client-shared-types-and-resource-wrappers) ## Operations, Local Development, and Test Automation - [Seeding, local keys, and reproducible sandbox data](https://docs.docuwriter.ai/dwilarlita-api/operations-local-development-and-test-automation/seeding-local-keys-and-reproducible-sandbox-data) - [Local bootstrap, health checks, and end-to-end smoke flows](https://docs.docuwriter.ai/dwilarlita-api/operations-local-development-and-test-automation/local-bootstrap-health-checks-and-end-to-end-smoke-flows) - [Documentation generation, coverage scanning, and reference sync tooling](https://docs.docuwriter.ai/dwilarlita-api/operations-local-development-and-test-automation/documentation-generation-coverage-scanning-and-reference-sync-tooling) ## Credit Scoring and Decisions DOMAIN - [Decision events, webhook fan-out, and async completion flow](https://docs.docuwriter.ai/dwilarlita-api/credit-scoring-and-decisions-domain/decision-events-webhook-fan-out-and-async-completion-flow) - [Partner scoring callbacks and scoring-orchestrator integration](https://docs.docuwriter.ai/dwilarlita-api/credit-scoring-and-decisions-domain/partner-scoring-callbacks-and-scoring-orchestrator-integration) - [Credit profile ingestion and decision persistence APIs](https://docs.docuwriter.ai/dwilarlita-api/credit-scoring-and-decisions-domain/credit-profile-ingestion-and-decision-persistence-apis)