Ruby의 Class, Module, Inheritance, Mixin 구조를 활용하여 AI 개발 코드를 읽고 구성하는 방법을 설명한다.

Context

Ruby와 Rails 코드베이스에서 AI 라이브러리를 분석하려면 객체지향 구조를 이해해야 한다. Python이나 JavaScript 배경 개발자에게 Ruby의 객체 모델은 낯선 부분이 존재한다. Deep inheritance tree는 코드 변경 시적인 영향을 발생시킨다.

Technical Solution

• Class → def initialize로 인스턴스 변수를 설정하고 @ 접두사로 상태를 저장한다
• attr_reader/attr_accessor → getter와 setter 메서드를 자동 생성한다
• < 기호 → LLMClient 클래스의 headers 메서드를 OpenAIClient가 상속받는다
• super 키워드 → 부모 메서드를 호출하면서 확장할 수 있다
• include → JsonRenderable 모듈의 as_json 메서드를 EmbeddingResult에서 활용한다
• extend → Slugifiable 모듈의 slugify 메서드를 인스턴스가 아닌 클래스에서 호출한다

Impact

(수치 기반 성능 변화 없음)

Key Takeaway

Deep inheritance보다 작은 단일 책임 클래스를 구성(composition)하는 것이 코드의 테스트 용이성과 유지보수성을 높인다.