HeuJung
6c63536f81
번들 확장 20개 전부에 AGENTS.md · README.md · docs/ 를 채우고, 코어가 들고 있던 확장 소유 문서 두 갈래를 그 확장으로 옮긴다. 번들 템플릿의 컴포넌트· 핸들러·레이아웃 상세와 확장이 구독하는 활동 로그 훅 목록이 그 대상이며, 코어에는 총계와 링크만 남아 확장이 기능을 늘릴 때 코어 문서를 고쳐야 하던 역방향 의존이 사라진다. 전수 완비를 확인하고 강제를 조인다 — 문서 동반 룰을 대상 목록 없는 error 로 승격하고, 검사 스크립트가 문서 미보유를 실패로 올리며, 미채움 마커 baseline 을 0 으로 기록한다. 한쪽만 조이면 "새 확장이 문서 없이 들어와도 초록" 인 상태가 남는데 그 결과는 이상 0건과 구분되지 않는다. 집필 과정에서 드러난 생성기 결함 셋을 함께 고친다. 스케줄 주기 열이 계약 키를 읽지 않아 모든 확장에서 '-' 였고, 네임스페이스를 붙인 핸들러 등록 키가 수집에서 통째로 빠졌으며, README 골격이 폐기된 히어로 배지를 계속 찍어내고 있었다. 셋 다 산출물이 아니라 원천이 틀린 것이라, 가드의 모집단에 생성기 출력 자체를 넣어 다음 확장이 같은 상태로 태어나는 경로를 막는다.
4.1 KiB
마케팅 동의 — 프론트엔드
레이아웃·액션 핸들러·전역 진입점·에셋 · 진입점: AGENTS.md
레이아웃
레이아웃 1개 (루트: resources/layouts).
| 그룹 | 개수 |
|---|---|
admin |
1개 |
| 레이아웃 | 그룹 | 종류 | extends |
|---|---|---|---|
plugin_settings |
admin |
화면 | _admin_base |
관리자 설정 화면(plugin_settings) 하나뿐입니다. 이 플러그인의 실제 UI 는 레이아웃이 아니라
확장 조각 5개이며, 그것들은 다른 화면 안에 들어갑니다.
plugin_settings.json 은 파일 이름이 계약입니다. 코어가 플러그인 디렉토리의 이 고정 경로를
찾아 설정 화면을 그리므로, 이름을 바꾸면 설정 화면 자체가 사라집니다.
레이아웃 JSON 만 고쳤다면 빌드는 필요 없고 php artisan plugin:update sirsoft-marketing --force
로 반영합니다. 새로 쓴 Tailwind 클래스가 빌드된 CSS 에 없으면 그 스타일만 조용히 빠지므로,
기존 레이아웃에 없던 클래스를 도입할 때는 확인이 필요합니다.
액션 핸들러
등록하는 액션 핸들러가 없습니다.
없습니다. 동의 항목은 일반 체크박스이고 저장은 코어 회원 API 를 타므로, 자체 핸들러가 필요하지 않습니다.
체크박스를 다룰 때 주의할 점이 하나 있습니다 — 저장값이 null 일 수 있는 체크박스는
name 자동바인딩만으로 묶으면 값이 null 로 고착됩니다. 조각에서 동의 체크박스를 손볼 때는
autoBinding: false + checked 표현식 + change 액션 형태를 유지합니다.
핸들러를 처음 추가한다면 전역 진입점(window.__SirsoftMarketing.initPlugin())과 빌드 산출물
(dist/)이 함께 필요합니다.
전역 진입점
프론트 엔트리포인트가 없습니다.
없습니다 — 등록할 액션 핸들러가 없기 때문입니다.
핸들러를 도입하는 순간 이 진입점이 필수가 됩니다. 코어는 로케일 전환 시 확장의 재등록 진입점을 다시 부르는데, 그 함수가 없거나 이름이 다르면 전환 직후 그 확장의 액션이 전부 무반응이 되고 오류도 토스트도 남지 않습니다. 진입점은 핸들러 재등록만 수행하고 1회성 부팅 작업을 포함하지 않습니다.
에셋
| 경로 | 구분 |
|---|---|
editor-spec.json |
레이아웃 편집기 스펙 (manifest) |
로딩 설정: {"strategy":"global","priority":100,"dependencies":[]}
JS·CSS 산출물이 없고 editor-spec.json 하나만 있습니다 — 레이아웃 편집기가 이 플러그인의
화면을 편집할 때 쓰는 팔레트·중첩 규칙 선언이며 실행 코드가 아닙니다. 이 플러그인의 프론트엔드는
전부 선언형 JSON(레이아웃 조각 5개 + 설정 화면 1개 + 편집기 스펙)입니다.
그래서 빌드 단계가 없고, 변경 반영은 php artisan plugin:update sirsoft-marketing --force
하나로 끝납니다. 나중에 JS 를 더하면 그때 빌드·dist/ 커밋·전역 진입점 셋이 함께 필요해집니다.
구동에 필요한 제3자 자산은 외부 CDN 에서 받지 않고 확장이 동봉합니다 — CDN 도달 실패는 예외도 서버 로그도 남기지 않고 화면 기능만 조용히 사라지기 때문입니다.