code-gen form-field 개발자 가이드¶

_hera-code-gen/src/main/resources/application-codegen-form-field.yml

code-generator:
  mode: form-field
  run-mode: output-module

  source:
    dir: "D:\\dev_home\\04.repo\\genexon\\anybiz5-erp-ssffin"  # 원본 프로젝트 루트
    domain-code: acm0101-m01                                     # 포팅할 원본 파일 기준 코드

  target:
    modal-type: offcanvas      # offcanvas 고정 (현재 modal 미지원)
    page-type: input           # input | view
    parent-page-id: acm0101    # 오픈 버튼을 삽입할 부모 페이지 ID

# application.yml
spring:
  profiles:
    active: form-field  # ← 이 값이어야 함

./gradlew :_hera-code-gen:bootRun

{sourceDir}/anybiz-webapp/src/main/resources/templates/{root3}/{domainCode}.html
{sourceDir}/src/main/resources/templates/{root3}/{domainCode}.html
{sourceDir}/templates/{root3}/{domainCode}.html
{sourceDir}/{root3}/{domainCode}.html
{sourceDir}/{domainCode}.html

source:
  domain-code: acm0101-m01
target:
  page-type: input
  parent-page-id: acm0101

hera-webapp/src/main/resources/templates/acm/acm0101-o01.html

source:
  domain-code: acm0101-m01    # 동일한 원본 파일 사용 가능
target:
  page-type: view              # ← 변경
  parent-page-id: acm0101

hera-webapp/src/main/resources/templates/acm/acm0101-o01-ro.html  ← -ro suffix 자동 부여

<div class="tab_wrapper">
  <ul class="tab_list">
    <li id="tab1">기본 정보</li>
    <li id="tab2">추가 정보</li>
  </ul>
  <div class="content_wrapper">
    <div class="tab_content">...</div>
    <div class="tab_content">...</div>
  </div>
</div>

<div class="tx-wrap">
  <div class="panel tabs-style-1">
    <div class="tab-menu-heading">
      <ul class="nav panel-tabs main-nav-line" role="tablist">
        <li class="nav-item"><a class="nav-link active" ...>기본 정보</a></li>
        <li class="nav-item"><a class="nav-link" ...>추가 정보</a></li>
      </ul>
    </div>
    <div class="panel-body tabs-menu-body">
      <div class="tab-content">
        <div class="tab-pane active" ...>...</div>
        <div class="tab-pane" ...>...</div>
      </div>
    </div>
  </div>
</div>

<!-- <th:block layout:insert="~{sys/sys0101-grid :: grid-wrapper}"/> -->

<button type="button" class="btn btn-action btn-sm"
        id="acm0101RegOffcanvasOpenBtn"
        data-bs-toggle="offcanvas"
        data-bs-target="#acm0101RegOffcanvas"
        aria-controls="acm0101RegOffcanvas">
  {원본 제목}
</button>

<th:block layout:insert="~{acm/acm0101-o01 :: offcanvas}"/>

document.addEventListener('DOMContentLoaded', () => {

    // [ INIT ]
    initAcm0101RegOffcanvas();

    // [ ACTION ]
    onClickSaveBtnAcm0101Btn();

});

// [ INIT ]
const initAcm0101RegOffcanvas = () => {

};

// [ ACTION ]
const onClickSaveBtnAcm0101Btn = () => {
    $('#saveBtnAcm0101').on('click', evt => {

    });
};

<!-- TODO(ffv4): original th:if="${scrnAtrtMap.inpt == 'Y'}" -->
<button type="button" class="btn btn-action btn-sm" id="saveBtn">저장</button>

<!-- TODO(ffv4): original dynamic options
<option th:each="item : ${aplcDvsn}" th:text="${item.value}" th:value="${item.key}"></option>
-->

{root3}/{base}-{typeCode}{seq}[-ro].html

예시)
  acm0101-m01 + offcanvas + input  →  acm/acm0101-o01.html
  acm0101-m01 + offcanvas + view   →  acm/acm0101-o01-ro.html
  acm0101-m02 + offcanvas + input  →  acm/acm0101-o02.html

{base}{actionSuffix}{ModalType}

예시)
  acm0101 + 저장 버튼  →  acm0101RegOffcanvas
  acm0101 + 수정 버튼  →  acm0101EditOffcanvas
  acm0101 + view 모드  →  acm0101ViewOffcanvas

height = (form-table tr 수 × 42px) + 200px
max-height = calc(100vh - 215px)

# ✅ input / view를 각각 별도 실행으로 두 파일 생성
# 1차 실행
target:
  page-type: input

# 2차 실행
target:
  page-type: view

<!-- ✅ 부모 페이지에 offcanvasScript fragment도 함께 선언 -->
<th:block layout:insert="~{acm/acm0101-o01 :: offcanvas}"/>
<th:block layout:insert="~{acm/acm0101-o01 :: offcanvasScript}"/>

// ✅ 원본 domainCode는 원본 파일명 기준으로 그대로 입력
domain-code: acm0101-m01   // 원본 파일: .../acm/acm0101-m01.html

# ❌ modal-type: modal 은 현재 미지원 (예외 발생)
target:
  modal-type: modal

# ❌ 원본 파일이 없는 경로 지정 시 5개 경로 모두 탐색 후 실패
source:
  dir: "D:\\잘못된\\경로"
  domain-code: acm0101-m01

<!-- ❌ 그리드 insert 주석을 그냥 두지 말고 개발자가 활성화해야 함 -->
<!-- <th:block layout:insert="~{.../grid-wrapper :: ...}"/> -->
<!-- ↑ 검토 후 주석 해제 또는 삭제 -->

// ❌ JS skeleton을 그대로 배포하지 말 것 — 반드시 로직 채우기
const initAcm0101RegOffcanvas = () => {
    // TODO: 초기화 로직 작성 필요
};

IllegalStateException: [FORM-FIELD] source html not found: [...]

<!-- 생성 결과 -->
<div class="offcanvas offcanvas-end offcanvas-round"
     style="height:494px; max-height:calc(100vh - 215px); width:auto; margin-top:48px">

<!-- 직접 수정 -->
<div class="offcanvas offcanvas-end offcanvas-round"
     style="height:600px; max-height:calc(100vh - 215px); width:680px; margin-top:48px">

# application.yml
spring:
  profiles:
    active: form-field  # ← 반드시 이 값