7.0.9 페이로드 대비 버전이 오른 패키지 31종과 코어의 CHANGELOG 최상단 절 날짜를 2026-09-04 로 맞췄다. 이어서 릴리즈 스크립트의 게이트를 브랜치 생성 없이 전수 실행한 결과, 파일 본문 누출 검사가 error 25건으로 릴리즈를 막고 있었다. 전부 이번 사이클에 들어온 것이다. - 확장 문서·코어 주석 20건이 공개 배포본에 없는 를 가리켰다. 공개되는 AGENTS.md 참조로 바꾸고, 참조된 9개 절의 실재를 전수 확인했다. 유일하게 빠져 있던 「독립 레이아웃의 글로벌 호스트 컴포넌트」절은 원래 동기화 대상이었으므로 AGENTS.md 에 반영했다. - 시나리오 매니페스트의 내부 문서 포인터는 소비자가 하나도 없어 제거했다. - 공개 테스트 3건이 내부 검사 스크립트를 열어 도구 간 리터럴을 대조하고 있었다. tests/** 는 배포 페이로드에 포함되고 는 제외되므로 배포본에서 원리상 성립할 수 없는 검사다. 대조를 그 도구 옆으로 옮기고 공개 테스트에는 자기 동작 단언만 남겼다. 존재 가드로 무마하지 않은 것은 그 경우 배포본에서 검사가 조용히 건너뛰어져 "검사하지 않음" 과 "통과" 가 구분되지 않기 때문이다. 옮긴 대조는 돌지 않으면 잠그지 못하므로 대상 파일 편집 시 자동 실행되도록 등록했다. 누출 검사 자체도 릴리즈 시점에만 돌아 위반이 다음 릴리즈까지 드러나지 않았으므로, 룰을 복제하지 않고 실행 시점만 세션 종료로 앞당겼다. 같은 검증 중 드러난 선행 결함 하나(이커머스 문서의 집계 블록 드리프트)도 함께 정리했다.
122 lines
6.4 KiB
Markdown
122 lines
6.4 KiB
Markdown
# 게시판 — 프론트엔드
|
|
|
|
> 레이아웃·액션 핸들러·전역 진입점·에셋 · 진입점: [AGENTS.md](../AGENTS.md)
|
|
|
|
## 레이아웃
|
|
|
|
<!-- @generated:layouts START — ext:docgen 이 갱신. 이 블록 안은 직접 수정하지 않는다 -->
|
|
레이아웃 46개 (루트: `resources/layouts`).
|
|
|
|
| 그룹 | 개수 |
|
|
|---|---|
|
|
| `admin` | 46개 |
|
|
|
|
| 레이아웃 | 그룹 | 종류 | extends |
|
|
|---|---|---|---|
|
|
| `admin_board_form` | `admin` | 화면 | `_admin_base` |
|
|
| `admin_board_index` | `admin` | 화면 | `_admin_base` |
|
|
| `admin_board_post_detail` | `admin` | 화면 | `_admin_base` |
|
|
| `admin_board_post_form` | `admin` | 화면 | `_admin_base` |
|
|
| `admin_board_posts_index` | `admin` | 화면 | `_admin_base` |
|
|
| `admin_board_reports_detail` | `admin` | 화면 | `_admin_base` |
|
|
| `admin_board_reports_index` | `admin` | 화면 | `_admin_base` |
|
|
| `admin_board_settings` | `admin` | 화면 | `_admin_base` |
|
|
| `_board_type_manage_modal` | `admin` | partial | - |
|
|
| `_tab_basic` | `admin` | partial | - |
|
|
| `_tab_list` | `admin` | partial | - |
|
|
| `_tab_notification` | `admin` | partial | - |
|
|
| `_tab_permissions` | `admin` | partial | - |
|
|
| `_tab_post` | `admin` | partial | - |
|
|
| `_comment` | `admin` | partial | - |
|
|
| `_comments` | `admin` | partial | - |
|
|
| `_post_card_content` | `admin` | partial | - |
|
|
| `_reply_card_content` | `admin` | partial | - |
|
|
| `_attachments` | `admin` | partial | - |
|
|
| `_form_fields` | `admin` | partial | - |
|
|
| `_parent_post` | `admin` | partial | - |
|
|
| `_alert_status` | `admin` | partial | - |
|
|
| `_card_history` | `admin` | partial | - |
|
|
| `_card_report_info` | `admin` | partial | - |
|
|
| `_bulk_apply_modal` | `admin` | partial | - |
|
|
| `_modal_identity_policy_delete` | `admin` | partial | - |
|
|
| `_modal_identity_policy_form` | `admin` | partial | - |
|
|
| `_modal_mail_template_edit` | `admin` | partial | - |
|
|
| `_modal_notification_definition_reset` | `admin` | partial | - |
|
|
| `_modal_notification_template_edit` | `admin` | partial | - |
|
|
| `_modal_notification_template_preview` | `admin` | partial | - |
|
|
| `_tab_board_settings_attachment` | `admin` | partial | - |
|
|
| `_tab_board_settings_basic` | `admin` | partial | - |
|
|
| `_tab_board_settings_bulk_apply` | `admin` | partial | - |
|
|
| `_tab_board_settings_comment` | `admin` | partial | - |
|
|
| `_tab_board_settings_list` | `admin` | partial | - |
|
|
| `_tab_board_settings_notification` | `admin` | partial | - |
|
|
| `_tab_board_settings_permissions` | `admin` | partial | - |
|
|
| `_tab_board_settings_post` | `admin` | partial | - |
|
|
| `_tab_board_settings_reply` | `admin` | partial | - |
|
|
| `_tab_general` | `admin` | partial | - |
|
|
| `_tab_identity_policies` | `admin` | partial | - |
|
|
| `_tab_notification_definitions` | `admin` | partial | - |
|
|
| `_tab_report_policy` | `admin` | partial | - |
|
|
| `_tab_seo` | `admin` | partial | - |
|
|
| `_tab_spam_security` | `admin` | partial | - |
|
|
<!-- @generated:layouts END -->
|
|
|
|
<!-- @intent START -->
|
|
46개 레이아웃이 **전부** `admin` 그룹입니다 — 이것은 이 모듈이 방문자 화면을 그리지 않는다는
|
|
증거입니다(§1, §architecture.md 참고). 새로 방문자용 게시판 화면(예: 다른 스타일의 목록)이
|
|
필요하면 이 디렉토리가 아니라 그 화면을 쓸 템플릿의 `layouts/` 에 추가합니다. `_tab_*` partial
|
|
이 24개로 가장 많은 것은 이 모듈에 탭 구조를 쓰는 화면이 최소 세 곳이기 때문입니다 —
|
|
게시판 생성/수정 폼(`_tab_basic`/`list`/`post`/`permissions`/`notification`), 게시판별
|
|
개별 설정 화면(`_tab_board_settings_*` 9개 — attachment/basic/bulk_apply/comment/list/
|
|
notification/permissions/post/reply), 모듈 전역 환경설정 화면(`_tab_general`/
|
|
`identity_policies`/`notification_definitions`/`report_policy`/`seo`/`spam_security`).
|
|
세 화면의 탭 이름이 겹치더라도(`_tab_basic`, `_tab_board_settings_basic` 등) 서로 다른
|
|
partial 파일이므로 한쪽만 고치면 다른 화면은 그대로입니다 — 같은 항목을 여러 화면에
|
|
반영해야 한다면 파일을 전부 찾아 고쳐야 합니다.
|
|
<!-- @intent END -->
|
|
|
|
## 액션 핸들러
|
|
|
|
<!-- @generated:handlers START — ext:docgen 이 갱신. 이 블록 안은 직접 수정하지 않는다 -->
|
|
_등록하는 액션 핸들러가 없습니다._
|
|
<!-- @generated:handlers END -->
|
|
|
|
<!-- @intent START -->
|
|
이 모듈의 관리자 레이아웃은 코어 빌트인 핸들러(`apiCall`/`navigate`/`setState` 등)만으로
|
|
전부 구성됩니다 — 게시판 CRUD·신고 처리·설정 저장은 결국 REST 호출 + 표준 폼 상태 관리라
|
|
전용 핸들러를 등록할 필요가 없었습니다. 새 관리자 화면을 추가할 때도 먼저 빌트인 핸들러
|
|
조합으로 가능한지 확인하고, 그래도 부족할 때만(예: 파일 업로드 진행률 같은 복잡한 클라이언트
|
|
상태) `resources/js/` 에 전용 핸들러를 신설합니다.
|
|
<!-- @intent END -->
|
|
|
|
## 전역 진입점
|
|
|
|
<!-- @generated:frontend-entry START — ext:docgen 이 갱신. 이 블록 안은 직접 수정하지 않는다 -->
|
|
_프론트 엔트리포인트가 없습니다._
|
|
<!-- @generated:frontend-entry END -->
|
|
|
|
<!-- @intent START -->
|
|
액션 핸들러가 없는 것과 같은 이유로 `window.__[Name]` 재등록 진입점도 없습니다 — 로케일
|
|
전환 후 재등록해야 할 자체 핸들러가 이 모듈에는 없기 때문입니다. 프론트 전용 코드
|
|
(`resources/js/`)를 신설하면 그 순간부터 이 자리에 진입점을 만들어야 합니다(§코어 AGENTS.md
|
|
"확장 미들웨어는..." 항목 인근의 재등록 진입점 규정 참고) — 없으면 로케일 전환 후 그 확장의
|
|
액션이 전부 무반응이 됩니다.
|
|
<!-- @intent END -->
|
|
|
|
## 에셋
|
|
|
|
<!-- @generated:assets START — ext:docgen 이 갱신. 이 블록 안은 직접 수정하지 않는다 -->
|
|
| 경로 | 구분 |
|
|
|---|---|
|
|
| `editor-spec.json` | 레이아웃 편집기 스펙 (manifest) |
|
|
|
|
로딩 설정: `{"strategy":"global","priority":100,"dependencies":[]}`
|
|
<!-- @generated:assets END -->
|
|
|
|
<!-- @intent START -->
|
|
`editor-spec.json` 이 이 모듈의 유일한 프론트 자산인 것도 위와 같은 이유입니다 — 레이아웃
|
|
편집기가 게시판 관리 화면의 컴포넌트를 인식하려면 이 선언이 필요하지만, 실행 시점에 로드할
|
|
JS/CSS 번들은 없습니다. `priority: 100` 은 다른 확장의 에셋 우선순위와 충돌하지 않는 기본값이며,
|
|
`dependencies: []` 는 이 확장의 에디터 스펙이 다른 확장의 스펙 로드를 전제하지 않는다는 뜻입니다.
|
|
<!-- @intent END -->
|