mirror of
https://github.com/TheGrandWazoo/freenas-proxmox.git
synced 2026-09-30 03:51:27 +02:00
Kevin AdamsandClaude Sonnet 4.6
95b71e9c7d
Establishes the pattern for distributing optional packages (starting with truenas-proxmox-multipath) via apt components within existing dist tracks. Users add 'multipath' to their sources.list component list to opt in; standard users are never affected by apt upgrade. References: #256 (multipath), #272 (testing track) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Architecture Decision Records
ADRs document significant decisions made about this project. They follow an RFC-style lifecycle.
Lifecycle
| Status | Meaning |
|---|---|
| Draft | Being written or discussed. Not yet binding. May change freely. |
| Accepted | Agreed upon and in effect. Guides implementation. |
| Superseded | Replaced by a newer ADR. The old record is preserved as history. The header notes which ADR supersedes it. |
| Rejected | Proposed but explicitly decided against. Preserved so we remember why. |
| Deprecated | Was accepted but no longer applicable (e.g., a feature was dropped). Not replaced. |
Rules
- Never edit the Decision section of an Accepted ADR. If the decision changes, write a new ADR and mark the old one
Superseded by ADR-XXX. - Draft ADRs can be edited freely — they are working documents.
- Numbering is sequential and permanent. A superseded ADR keeps its number; the new one gets the next number.
- Context and Consequences sections may be lightly edited for clarity even after acceptance (fix typos, add links), but the decision itself is immutable.
Index
| ADR | Title | Status |
|---|---|---|
| ADR-001 | Consolidate Build Pipeline into Main Repo | Accepted |
| ADR-002 | UI Integration Strategy | Accepted |
| ADR-003 | APT Repository Hosting | Accepted |
| ADR-004 | Transactional Cleanup on API Operation Failure | Accepted |
| ADR-005 | Bearer Token Authentication as Primary Auth Method | Accepted |
| ADR-006 | Package Versioning Strategy | Accepted |
| ADR-007 | FreeNAS vs TrueNAS Module Naming | Accepted |