Architecture Decision Records (ADRs)

This repository contains a public, sanitized subset of Architecture Decision Records (ADRs) from the Forge Platform.

ADRs document consequential engineering decisions—context, constraints, alternatives, and rationale—as a durable record of why the system is shaped as it is.

Scope and redaction

Not all ADRs are published. The records included here:

• Represent decisions relevant to Forge Platform consumers
• Exclude sensitive details (e.g. security mechanisms, internal topology, proprietary workflows)
• May be abstracted or generalized from their original form

Interpretation notes

• ADRs are historical artifacts, and are not always reflective of the current implementation
• Decisions may evolve; superseding ADRs will be linked where applicable
• Trade-offs and rejected alternatives are preserved to aid understanding

ADR index

• 0001-record-architecture-decisions.md
• 0002-adoption-of-quarkus-for-api-and-controller-tier.md
• 0003-authentication-and-user-management-approach.md
• 0004-use-aws-cognito-across-all-environments.md
• 0005-implement-service-auth-sts-assumerolewithwebidentity.md
• 0006-internal-third-party-api-wrapper-standalone-service-vs-library.md
• 0007-observability-strategy.md
• 0008-decoupling-micro-services-transitioning-from-rest-to-sqs.md
• 0009-user-profile-storage-strategy.md
• 0010-rest-api-design-standards.md
• 0011-stateless-jwt-authentication.md
• 0012-clean-architecture-package-structure.md
• 0013-migration-from-mapstruct-to-manual-mappers.md
• 0014-application-caching-strategy.md
• 0015-notification-service-fire-and-forget-pattern.md
• 0016-notification-service-rate-limiting-strategy.md
• 0017-notification-service-template-implementation.md
• 0018-notification-service-template-engine.md
• 0019-notification-service-unsubscribe-token-security.md
• 0020-single-vpc-per-environment.md
• 0021-user-environment-aware-removal-policies-for-cdk-managed-resources.md
• 0022-public-alb-edge-and-origin-protection.md
• 0023-dnssec-route53-hosted-zones-baseline.md
• 0024-internal-alb-tls-east-west-optional.md