RFCs

Architecture and design decision records for the arolariu.ro monorepo. Each RFC captures one durable decision — the problem it solved, the options considered, and what landed.

How to add a new RFC

1. Copy RFC_TEMPLATE.md into docs/rfc/ with a fresh number (e.g. 2002-<short-slug>.md). Numbering convention:
   • 0xxx — process / CI / governance
   • 1xxx — frontend
   • 2xxx — backend
2. Fill in Status, Context, Decision, Consequences.
3. Open a PR against main. The docs site re-mirrors docs/ on every build, so your RFC appears in the sidebar automatically once merged.

Index

Process

• 0001 — GitHub Actions workflows

Frontend

• 1001 — OpenTelemetry observability system
• 1002 — Comprehensive JSDoc documentation standard
• 1003 — Internationalization system
• 1004 — Metadata & SEO system
• 1005 — State management (Zustand)
• 1006 — Component library architecture
• 1007 — Advanced frontend patterns
• 1008 — SCSS system architecture

Backend

• 2001 — Domain-Driven Design architecture
• 2002 — OpenTelemetry backend observability
• 2003 — The Standard implementation
• 2004 — Comprehensive XML documentation standard