Files
HeuJung 6c63536f81 docs(core,extensions): 확장 20개 개발자 문서 완비와 문서 소유 이관
번들 확장 20개 전부에 AGENTS.md · README.md · docs/ 를 채우고, 코어가 들고
있던 확장 소유 문서 두 갈래를 그 확장으로 옮긴다. 번들 템플릿의 컴포넌트·
핸들러·레이아웃 상세와 확장이 구독하는 활동 로그 훅 목록이 그 대상이며,
코어에는 총계와 링크만 남아 확장이 기능을 늘릴 때 코어 문서를 고쳐야 하던
역방향 의존이 사라진다.

전수 완비를 확인하고 강제를 조인다 — 문서 동반 룰을 대상 목록 없는 error 로
승격하고, 검사 스크립트가 문서 미보유를 실패로 올리며, 미채움 마커 baseline 을
0 으로 기록한다. 한쪽만 조이면 "새 확장이 문서 없이 들어와도 초록" 인 상태가
남는데 그 결과는 이상 0건과 구분되지 않는다.

집필 과정에서 드러난 생성기 결함 셋을 함께 고친다. 스케줄 주기 열이 계약 키를
읽지 않아 모든 확장에서 '-' 였고, 네임스페이스를 붙인 핸들러 등록 키가 수집에서
통째로 빠졌으며, README 골격이 폐기된 히어로 배지를 계속 찍어내고 있었다.
셋 다 산출물이 아니라 원천이 틀린 것이라, 가드의 모집단에 생성기 출력 자체를
넣어 다음 확장이 같은 상태로 태어나는 경로를 막는다.
2026-08-31 22:57:36 +09:00

3.0 KiB

Daum 우편번호 — 데이터 모델

모델·소유 테이블·마이그레이션·Enum · 진입점: AGENTS.md

모델

소유 모델이 없습니다.

없습니다. 이 플러그인은 아무것도 저장하지 않습니다.

선택된 주소는 화면의 입력 칸에 채워질 뿐이며, 그 값을 어디에 어떻게 저장할지는 주소 입력 화면을 소유한 확장(이커머스의 배송지 등)이 정합니다. 여기서 저장을 맡으면 소비하는 확장마다 저장 형식 분기가 늘어나고, 그 확장의 데이터 소유권도 흐려집니다.

소유 테이블

소유 테이블이 없습니다.

없습니다. 저장하는 데이터가 없으므로 테이블도 없습니다.

이 플러그인을 삭제해도 정리할 데이터가 없다는 뜻이기도 합니다 — 주소 검색만 사라지고 이미 입력된 주소는 그 주소를 소유한 확장에 그대로 남습니다.

마이그레이션

마이그레이션이 없습니다.

없습니다. 스키마가 없으므로 마이그레이션도 없습니다.

나중에 저장할 것이 생긴다면(예: 검색 사용 통계) 먼저 "그것이 정말 이 플러그인의 데이터인가"를 따져야 합니다 — 이 플러그인이 상태를 갖지 않는 것은 누락이 아니라 설계입니다.

Enum

Enum 이 없습니다.

없습니다. 설정의 display_mode(layer / popup)만 닫힌 어휘를 갖는데, 설정 스키마의 enum 타입으로 선언되어 있어 별도 PHP Enum 을 두지 않았습니다.

이 값을 코드에서 분기로 비교하는 자리가 프론트 핸들러 한 곳뿐이라 어휘가 갈라질 여지가 없습니다. 비교 지점이 늘어나기 시작하면 그때 Enum 으로 올리는 것이 맞습니다.

Repository

Repository 가 없습니다.

없습니다. 데이터 접근 자체가 없습니다.

이 플러그인의 PHP 코드는 plugin.php 하나이며, 메서드 넷(getMetadata · getSettingsSchema · getConfigValues · getHooks)이 전부입니다 — 설정 제공과 훅 선언 외에 서버가 하는 일이 없다는 사실이 그대로 드러납니다.