Single Read Path 설계를 통한 DB 기반 동적 설정 시스템 구축

Context

정적 .env 파일과 DB 기반 동적 설정 사이의 정체성 충돌로 인한 관리 복잡성 발생. 설정 읽기 경로가 다원화되어 데이터 불일치 및 개발자 인지 부하가 증가하는 아키텍처적 한계 직면.

Technical Solution

• Single Read Path 유지를 위해 DB 설정을 Boot 시점에 config() 배열로 Overlay 하는 구조 설계
• spatie/laravel-settings를 활용한 Typed Class 정의로 런타임 타입 안정성 확보 및 오타로 인한 Null 참조 방지
• Framework 부트스트랩 이후 변경된 app.timezone의 실제 적용을 위해 date_default_timezone_set()을 명시적으로 호출하는 보정 로직 구현
• Migration 이전의 Fresh Install 단계에서 발생하는 Chicken-and-egg 문제를 해결하기 위해 전체 Overlay 과정을 try/catch로 래핑하여 .env 기본값으로 Fallback 처리
• 기능 비활성화 시 UI 은닉이 아닌 Route 자체를 제거하는 Surface Removal 방식을 채택하여 API 엔드포인트 노출에 따른 보안 취약점 제거
• Livewire 기반 관리 화면에서 저장 즉시 config()를 갱신하여 Request 생명주기 내 즉각적인 반영 체계 구축