코드 구조와 요청 흐름

디렉터리 지도

요청 흐름

1. www/index.php에서 설정과 autoload를 읽어 Kernel을 구성합니다.
2. 미들웨어가 세션·사용자·뷰·오류 응답 등 요청 기반 정보를 준비합니다.
3. 라우트가 컨트롤러로 연결하고 입력·CSRF·권한을 확인합니다.
4. 서비스가 업무 규칙과 트랜잭션을 적용하고 저장소가 DB를 처리합니다.
5. 뷰가 논리 템플릿 이름을 선택 테마에서 해석해 HTML을 렌더링합니다.
6. 외부 알림은 관련 업무 트랜잭션이 완료된 뒤 발송 엔진을 통해 처리합니다.

수정 위치 결정

URL과 HTTP 응답은 Web·Shop Routes/Controller, 주문 상태와 재고·환불 규칙은 해당 서비스, 화면 배치는 PHP 템플릿, 색·반응형은 테마 자산에서 수정합니다. 컨트롤러에서 주문 DB를 직접 수정해 서비스 검사를 우회하지 않습니다.

쇼핑몰·알리고·결제는 코어입니다. 옛 modules/shop 또는 별도 PG 플러그인 코드를 되살려 중복 라우트와 테이블을 추가하지 않습니다. 새로운 업무는 확장 Context의 등록 API를 사용합니다.

소스 확인 순서

먼저 루트 AGENTS.md와 하위 지침을 읽습니다. 현재 기능은 AGENTS의 기능 지도, 공개 계약은 docs/, 실제 경로는 Routes.php, 최종 동작은 서비스와 템플릿에서 확인합니다. 오래된 설계 문서를 현재 화면보다 우선하지 않습니다.