# 게시판 — 프론트엔드 > 레이아웃·액션 핸들러·전역 진입점·에셋 · 진입점: [AGENTS.md](../AGENTS.md) ## 레이아웃 레이아웃 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 | - | 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 파일이므로 한쪽만 고치면 다른 화면은 그대로입니다 — 같은 항목을 여러 화면에 반영해야 한다면 파일을 전부 찾아 고쳐야 합니다. ## 액션 핸들러 _등록하는 액션 핸들러가 없습니다._ 이 모듈의 관리자 레이아웃은 코어 빌트인 핸들러(`apiCall`/`navigate`/`setState` 등)만으로 전부 구성됩니다 — 게시판 CRUD·신고 처리·설정 저장은 결국 REST 호출 + 표준 폼 상태 관리라 전용 핸들러를 등록할 필요가 없었습니다. 새 관리자 화면을 추가할 때도 먼저 빌트인 핸들러 조합으로 가능한지 확인하고, 그래도 부족할 때만(예: 파일 업로드 진행률 같은 복잡한 클라이언트 상태) `resources/js/` 에 전용 핸들러를 신설합니다. ## 전역 진입점 _프론트 엔트리포인트가 없습니다._ 액션 핸들러가 없는 것과 같은 이유로 `window.__[Name]` 재등록 진입점도 없습니다 — 로케일 전환 후 재등록해야 할 자체 핸들러가 이 모듈에는 없기 때문입니다. 프론트 전용 코드 (`resources/js/`)를 신설하면 그 순간부터 이 자리에 진입점을 만들어야 합니다(§코어 AGENTS.md "확장 미들웨어는..." 항목 인근의 재등록 진입점 규정 참고) — 없으면 로케일 전환 후 그 확장의 액션이 전부 무반응이 됩니다. ## 에셋 | 경로 | 구분 | |---|---| | `editor-spec.json` | 레이아웃 편집기 스펙 (manifest) | 로딩 설정: `{"strategy":"global","priority":100,"dependencies":[]}` `editor-spec.json` 이 이 모듈의 유일한 프론트 자산인 것도 위와 같은 이유입니다 — 레이아웃 편집기가 게시판 관리 화면의 컴포넌트를 인식하려면 이 선언이 필요하지만, 실행 시점에 로드할 JS/CSS 번들은 없습니다. `priority: 100` 은 다른 확장의 에셋 우선순위와 충돌하지 않는 기본값이며, `dependencies: []` 는 이 확장의 에디터 스펙이 다른 확장의 스펙 로드를 전제하지 않는다는 뜻입니다.