“ADR索引”

📋 架构决策记录索引

塑造 XOOPS CMS 的架构决策的综合索引。

---

什么是 ADR？

架构决策记录 (ADR) 记录了 XOOPS 开发期间做出的重要架构决策。它们捕获每个选择的背景、决策和后果，为维护者和贡献者提供有价值的历史背景。

---

ADR 状态图例

状态	意义
提议	正在讨论中，尚未接受
已接受	决定已通过
已弃用	不再推荐
取代	替换为另一个 ADR

---

当前 ADR

基本决策

ADR	标题	状态	影响
ADR-001	模区块化架构	已接受	核心
ADR-002	对象-Oriented数据库访问	已接受	核心
ADR-003	Smarty模板引擎	已接受	核心

计划 ADR (XOOPS 4.0)

ADR	标题	状态	影响
ADR-004	安全系统设计	提议	安全
ADR-005	PSR-15 中间件	提议	建筑
ADR-006	依赖注入容器	提议	建筑
ADR-007	事件系统重新设计	提议	建筑

---

ADR 关系

graph TB
    subgraph "Core Architecture"
        A[ADR-001<br>Modular Architecture]
        B[ADR-002<br>Database Abstraction]
        C[ADR-003<br>Template Engine]
    end

    subgraph "Security"
        D[ADR-004<br>Security System]
    end

    subgraph "XOOPS 4.0"
        E[ADR-005<br>Middleware]
        F[ADR-006<br>DI Container]
        G[ADR-007<br>Events]
    end

    A --> B
    A --> C
    A --> D
    B --> F
    C --> E
    D --> E
    F --> G

    style A fill:#9f9,stroke:#333
    style B fill:#9f9,stroke:#333
    style C fill:#9f9,stroke:#333
    style D fill:#ff9,stroke:#333
    style E fill:#ff9,stroke:#333
    style F fill:#ff9,stroke:#333
    style G fill:#ff9,stroke:#333

---

时间轴

timeline
    title ADR Timeline
    2001-2003 : ADR-001 Modular Architecture
              : ADR-002 Database Abstraction
              : ADR-003 Template Engine
    2007 : ADR-004 Security System
    2026 : ADR-005 Middleware
         : ADR-006 DI Container
         : ADR-007 Events

---

创建新的 ADR

在提出新的架构决策时：

1. 复制ADR模板
2. 填写所有部分
3. 作为 Pull Request 提交
4. 在 GitHub 上讨论问题
5. 决定后更新状态

ADR 模板结构

# ADR-XXX: Title

## Status
Proposed | Accepted | Deprecated | Superseded

## Context
What is the issue motivating this decision?

## Decision
What is the change that we're proposing?

## Consequences
What becomes easier or harder as a result?

## Alternatives Considered
What other options were evaluated?

---

🔗 相关文档

• 核心概念
• 贡献指南
• XOOPS 4.0 路线图

---

#XOOPS #adr #architecture #index #decisions