🏗️ Architecture Principles

🎯 SOLID Principles

S - Single Responsibility:

// ✅ GOOD: One responsibility
class AudioFileReader {
    Buffer read(const std::string& path);
};

// ❌ BAD: Multiple responsibilities
class AudioFileReaderAndProcessorAndWriter { ... };

O - Open/Closed:

// ✅ GOOD: Extensible via inheritance
class Effect {
public:
    virtual void process(Buffer& buffer) = 0;
};

L - Liskov Substitution:

// ✅ GOOD: Subtypes are substitutable
class Reverb : public Effect {
    void process(Buffer& buffer) override;
};

I - Interface Segregation:

// ✅ GOOD: Focused interfaces
class Loadable { virtual void load() = 0; };
class Saveable { virtual void save() = 0; };

D - Dependency Inversion:

// ✅ GOOD: Depend on abstractions
class Processor {
    std::unique_ptr<AudioSource> source_;  // Interface
};

🎵 Real-time Constraints

╔════════════════════════════════════════════════════════════╗ ║ Audio thread: ║ ║ • Zero allocations ║ ║ • No locks ║ ║ • Bounded execution time ║ ║ • No system calls ║ ╚════════════════════════════════════════════════════════════╝

🧪 Testability

// ✅ GOOD: Dependency injection for testability
class Processor {
public:
    Processor(std::unique_ptr<AudioSource> source)
        : source_(std::move(source)) {}

private:
    std::unique_ptr<AudioSource> source_;
};

// In tests:
auto mock_source = std::make_unique<MockAudioSource>();
Processor processor(std::move(mock_source));