adr

Architecture Decision Records

This directory contains Architecture Decision Records (ADRs) documenting key architectural choices made during devJournal development.

Table of Contents

• 1. About ADRs
• 2. ADR Index
• 3. ADR Template

1. About ADRs

Architecture Decision Records capture important architectural decisions made during the project's evolution. Each ADR describes the context, decision drivers, alternatives considered, and consequences of a specific architectural choice.

2. ADR Index

ID	Title	Status	Date
001	Fat-Free Stack	Accepted	2026-01-15
002	Data Persistence with D1	Accepted	2026-01-15
003	Authentication Strategy	Superseded	2026-01-16
004	Temporal API Deferred	Accepted	2026-01-16
005	Factory Pattern for Test Mocking	Accepted	2026-01-25
006	FreshBooks OAuth Authentication	Accepted	2026-01-25

3. ADR Template

When creating a new ADR, use this structure:

# ADR-XXX: [Title] <!-- omit in toc -->

**Status**: [Proposed | Accepted | Deprecated | Superseded]

**Date**: YYYY-MM-DD

**Context**: [Optional: GitHub Issue or related work]

## Table of Contents <!-- omit in toc -->

- Context and Problem Statement
- Decision Drivers
- Considered Options
- Decision Outcome
- Consequences
- Related Decisions

[← Back to ADR Index](./README.md)

---

← Back to Reference Documentation