Skip to content

📋 Architecture Decision Records Index

Comprehensive index of architectural decisions that shaped XOOPS CMS.

What are ADRs?

Architecture Decision Records (ADRs) document significant architectural decisions made during the development of XOOPS. They capture the context, decision, and consequences of each choice, providing valuable historical context for maintainers and contributors.

ADR Status Legend

Status Meaning
Proposed Under discussion, not yet accepted
Accepted Decision has been adopted
Deprecated No longer recommended
Superseded Replaced by another ADR

Current ADRs

Foundational Decisions

ADR Title Status Impact
ADR-001 Modular Architecture Accepted Core
ADR-002 Object-Oriented Database Access Accepted Core
ADR-003 Smarty Template Engine Accepted Core

Planned ADRs (XOOPS 2026)

ADR Title Status Impact
ADR-004 Security System Design Proposed Security
ADR-005 PSR-15 Middleware Proposed Architecture
ADR-006 Dependency Injection Container Proposed Architecture
ADR-007 Event System Redesign Proposed Architecture

ADR Relationships

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 2026"
        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

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

Creating New ADRs

When proposing a new architectural decision:

  1. Copy the ADR Template
  2. Fill in all sections
  3. Submit as Pull Request
  4. Discuss in GitHub Issues
  5. Update status after decision

ADR Template Structure

# 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 #adr #architecture #index #decisions