HeuJung
0833bd1f6a
빈 번들 503 을 "에셋을 선언한 활성 확장이 있는데 결과가 비었다" 로 판정해, 스타일 규칙이 아직 없는 0바이트 CSS 만 선언된 기본 구성이 통째로 503 이 됐다. file_get_contents 는 0바이트에서 false 가 아니라 '' 를 돌려주므로 읽기 실패 분기도 타지 않는다. 선언 축 게터는 전부 file_exists 게이트라 부재를 셀 수 없어, 존재 게이트가 없는 getDeclaredAssetAbsolutePaths 를 통로로 두고 503 의 근거를 소실 축(findMissingDeclaredAssets)으로 옮긴다. 존재하되 비었으면 빈 200 이다. 곁들여: 실패 배너 항목명을 내부 구분 키에서 사용자 어휘로(engine-v1.64.7), 봇 화면이 없는 템플릿 CSS 를 링크하지 않도록 실재 게이트, 매니페스트 자산 선언 드리프트 4건 정정.
90 lines
4.2 KiB
Markdown
90 lines
4.2 KiB
Markdown
# Hello 모듈 — 프론트엔드
|
|
|
|
> 레이아웃·액션 핸들러·전역 진입점·에셋 · 진입점: [AGENTS.md](../AGENTS.md)
|
|
|
|
## 레이아웃
|
|
|
|
<!-- @generated:layouts START — ext:docgen 이 갱신. 이 블록 안은 직접 수정하지 않는다 -->
|
|
레이아웃 3개 (루트: `resources/layouts`).
|
|
|
|
| 그룹 | 개수 |
|
|
|---|---|
|
|
| `admin` | 2개 |
|
|
| `user` | 1개 |
|
|
|
|
| 레이아웃 | 그룹 | 종류 | extends |
|
|
|---|---|---|---|
|
|
| `admin_memo_form` | `admin` | 화면 | `_admin_base` |
|
|
| `admin_memo_list` | `admin` | 화면 | `_admin_base` |
|
|
| `user_memo_list` | `user` | 화면 | `_user_base` |
|
|
<!-- @generated:layouts END -->
|
|
|
|
<!-- @intent START -->
|
|
3개이며 그중 하나가 `user` 그룹인 것이 학습 포인트입니다.
|
|
|
|
| 레이아웃 | 그룹 | 무엇을 보여주는가 |
|
|
|---|---|---|
|
|
| `admin_memo_list` · `admin_memo_form` | `admin` | 관리자 목록·작성 화면의 최소 형태 (`_admin_base` 상속) |
|
|
| `user_memo_list` | `user` | **모듈도 사용자 레이아웃을 가질 수 있다** (`_user_base` 상속) |
|
|
|
|
실제 도메인 모듈(게시판·이커머스)은 방문자 화면을 소유하지 않고 템플릿에 맡깁니다 — 템플릿마다
|
|
디자인이 달라야 하기 때문입니다. 이 샘플의 `user_memo_list` 는 그 규칙의 예외가 아니라, 구조상
|
|
가능하다는 사실을 보이는 예시입니다.
|
|
|
|
모듈 레이아웃은 위치에 따라 등록 대상이 갈립니다 — `admin/` 하위는 Admin 템플릿에,
|
|
`user/` 하위는 User 템플릿에 등록됩니다.
|
|
|
|
레이아웃 JSON 만 고쳤다면 빌드 없이
|
|
`php artisan module:update gnuboard7-hello_module --force` 로 반영합니다.
|
|
<!-- @intent END -->
|
|
|
|
## 액션 핸들러
|
|
|
|
<!-- @generated:handlers START — ext:docgen 이 갱신. 이 블록 안은 직접 수정하지 않는다 -->
|
|
_등록하는 액션 핸들러가 없습니다._
|
|
<!-- @generated:handlers END -->
|
|
|
|
<!-- @intent START -->
|
|
없습니다. 이 샘플의 화면은 코어 엔진의 기본 핸들러(`apiCall` · `navigate` · `setState` 등)
|
|
만으로 충분합니다.
|
|
|
|
핸들러를 처음 추가할 때는 셋이 함께 필요합니다 — 엔트리 파일, `window.__[Name].initModule()`
|
|
재등록 진입점, 그리고 `--production` 으로 구운 `dist/` 커밋. 진입점을 빠뜨리면 로케일 전환
|
|
직후 그 핸들러들이 오류 없이 무반응이 됩니다.
|
|
<!-- @intent END -->
|
|
|
|
## 전역 진입점
|
|
|
|
<!-- @generated:frontend-entry START — ext:docgen 이 갱신. 이 블록 안은 직접 수정하지 않는다 -->
|
|
_프론트 엔트리포인트가 없습니다._
|
|
<!-- @generated:frontend-entry END -->
|
|
|
|
<!-- @intent START -->
|
|
없습니다 — 등록할 액션 핸들러가 없기 때문입니다.
|
|
|
|
핸들러를 도입하는 순간 이 진입점이 **필수**가 됩니다. 코어는 로케일 전환 시 확장의 재등록
|
|
진입점을 다시 부르는데, 그 함수가 없거나 이름이 다르면 전환 직후 그 확장의 액션이 전부
|
|
무반응이 되고 오류도 토스트도 남지 않습니다. 진입점은 핸들러 재등록만 수행하고 1회성 부팅
|
|
작업을 포함하지 않습니다.
|
|
<!-- @intent END -->
|
|
|
|
## 에셋
|
|
|
|
<!-- @generated:assets START — ext:docgen 이 갱신. 이 블록 안은 직접 수정하지 않는다 -->
|
|
_프론트 에셋이 없습니다._
|
|
<!-- @generated:assets END -->
|
|
|
|
<!-- @intent START -->
|
|
없습니다. 이 샘플의 프론트엔드는 레이아웃 JSON 3개뿐이라 빌드할 실행 코드가 없습니다.
|
|
|
|
그래서 반영이 `php artisan module:update gnuboard7-hello_module --force` 하나로 끝납니다.
|
|
JS 를 더하면 그때 빌드(`module:build --production`)·`dist/` 커밋·전역 진입점 셋이 함께
|
|
필요해집니다. 그때 `module.json` 에는 `assets.js.output` **객체 형식**으로 선언합니다
|
|
(`"assets": { "js": { "entry": "resources/js/index.ts", "output": "dist/js/....iife.js" } }`).
|
|
목록형(`"js": ["..."]`)은 어느 소비자도 읽지 않아 그 스크립트가 영영 로드되지 않는데,
|
|
오류도 경고도 남지 않습니다.
|
|
|
|
구동에 필요한 제3자 자산은 외부 CDN 에서 받지 않고 확장이 동봉합니다 — CDN 도달 실패는 예외도
|
|
서버 로그도 남기지 않고 화면 기능만 조용히 사라지기 때문입니다.
|
|
<!-- @intent END -->
|