model.Util.tsx

Util 파일은 module의 작은 client-side helper component를 담습니다. action button, toolbox, dialog trigger, query control, context-aware navigation 조각을 두기에 좋습니다.

Util은 Page, Zone, Unit, Template, View 파일이 각자 역할에 집중하도록 돕습니다. Util component는 interaction UI를 묶되 핵심 business rule을 소유하지 않습니다.

파일 규칙

Util 파일은 보통 client hook과 event handler를 사용하므로 use client directive로 시작합니다. action 또는 helper를 명확히 설명하는 named component를 export합니다.

Path

lib/[model]/[Model].Util.tsx

Directive

"use client"

Exports

Remove, Toolbox, SetOrg, QueryMaker, BackButton

많은 Util component는 generated model wrapper 주변의 작은 control입니다. toolbox는 edit, remove 등 model action을 모아서 Unit 또는 Zone 파일이 복잡해지지 않도록 합니다.

Project.Util.tsx

__Model__.Util.tsx

action에 dialog, confirmation UI, 작은 local state가 필요하면 Util을 사용합니다. 해당 interaction에만 속하는 값이라면 local component state를 사용해도 괜찮습니다.

BizLicense.Util.tsx

Report.Util.tsx

Util 파일은 query panel이나 route-aware helper UI에도 유용합니다. store state와 route context를 읽고 generated store action 또는 router helper를 호출할 수 있습니다.

Ticket.Util.tsx

Board.Util.tsx

action text를 hard-code하지 말고 usePage로 label을 가져옵니다.

Util component에서는 st.do action 또는 Model wrapper를 호출하고 핵심 business rule은 다른 곳에 둡니다.

열린 dialog나 선택 option처럼 UI interaction에만 필요한 값에는 local state를 사용해도 됩니다.

action이 의존하는 model id, slice, role, name이 드러나도록 props를 명시적으로 둡니다.

큰 toolbox나 workflow modal은 하나의 component에 숨기지 말고 named export로 나눕니다.