[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F2NAPZFKSC80CT2WWM00TA":3,"skill-same:01M7F2NAPZFKSC80CT2WWM00TA":92},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":12,"updatedAt":31,"install":32,"resources":45},"01M7F2NAPZFKSC80CT2WWM00TA","arms-frontend-web",null,"A-RMS 프론트엔드 저장소(Java-Service-Tree-Framework-Frontend-Web)의 화면 작업 규약. arms\u002F · backoffice\u002F 영역의 jQuery + Bootstrap 3 + lightblue4 멀티페이지 앱에서 화면을 새로 만들거나 고칠 때, template.html?page= 라우팅 · execDocReady() 진입점 · common.js 공통 빌더(dataTable_build · jsTreeBuild · setLocale · jNotify) · reference\u002F 번들 라이브러리 · 게이트웨이 AJAX 계약을 이 규약대로 따르게 한다. content-container.html \u002F content-header.html \u002F js\u002F{page}.js 를 건드리거나, DataTables · jstree · ECharts · select2 · multiple-select · jSpreadsheet 를 붙이거나, \u002Fauth-user · \u002Fauth-admin 엔드포인트를 연동하거나, i18n(data-locale) · 상태 색상 · 버튼 색상 규칙이 나오면 반드시 이 스킬을 먼저 읽을 것. \"프론트 화면\", \"퍼블리싱\", \"arms 화면\", \"백오피스 화면\", \"요구사항 목록 화면\", \"대시보드 위젯\" 같은 요청도 대상이다. React · Vue · TypeScript 로 새로 만들지 않는다 — 이 저장소는 전부 바닐라 JS다.","313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace","313DEVGRP","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F34762848?v=4","01M7F2M535Z5X8XGHYD8TDVAB3","A-RMS by 313DEVGRP","01M7F2M54CR0P3631F4YM0D014",0,"MIT","https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: arms-frontend-web\ndescription: >-\n  A-RMS 프론트엔드 저장소(Java-Service-Tree-Framework-Frontend-Web)의 화면 작업 규약.\n  arms\u002F · backoffice\u002F 영역의 jQuery + Bootstrap 3 + lightblue4 멀티페이지 앱에서\n  화면을 새로 만들거나 고칠 때, template.html?page= 라우팅 · execDocReady() 진입점 ·\n  common.js 공통 빌더(dataTable_build · jsTreeBuild · setLocale · jNotify) ·\n  reference\u002F 번들 라이브러리 · 게이트웨이 AJAX 계약을 이 규약대로 따르게 한다.\n  content-container.html \u002F content-header.html \u002F js\u002F{page}.js 를 건드리거나,\n  DataTables · jstree · ECharts · select2 · multiple-select · jSpreadsheet 를 붙이거나,\n  \u002Fauth-user · \u002Fauth-admin 엔드포인트를 연동하거나, i18n(data-locale) · 상태 색상 ·\n  버튼 색상 규칙이 나오면 반드시 이 스킬을 먼저 읽을 것. \"프론트 화면\", \"퍼블리싱\",\n  \"arms 화면\", \"백오피스 화면\", \"요구사항 목록 화면\", \"대시보드 위젯\" 같은 요청도 대상이다.\n  React · Vue · TypeScript 로 새로 만들지 않는다 — 이 저장소는 전부 바닐라 JS다.\n---\n\n# A-RMS Frontend-Web 작업 규약\n\n대상 저장소: `Java-Service-Tree-Framework-Frontend-Web\u002F`\n(워크스페이스 루트 `C:\\DEV\\Project\\Java-Service-Tree-Framework` 하위)\n\n이 저장소는 **트랜스파일·번들러가 없는 브라우저 직접 실행 앱**이다. `\u003Cscript>` 로 올라간\n전역 함수들이 서로를 이름으로 호출하는 구조라, 규약을 어기면 빌드 에러가 아니라\n**런타임에 조용히 깨진다.** 아래 계약을 먼저 파악하고 손대는 것이 이 저장소에서\n가장 비용이 싼 길이다.\n\n---\n\n## 1. 먼저 영역을 판별한다\n\n| 영역 | 실제 스택 | 진입 | 성격 |\n|------|----------|------|------|\n| `arms\u002F` | jQuery 3 + 바닐라 JS + Bootstrap 3(lightblue4) | `arms\u002Ftemplate.html?page={page}` · `arms\u002Fdetail.html?mode=detail` | 운영 중 메인 앱 |\n| `backoffice\u002F` | **arms와 동일한 jQuery MPA** | `backoffice\u002Ftemplate.html?page={feature}` | 관리자 백오피스 |\n| `reference\u002F` | 정적 번들 라이브러리(npm 아님) | `\u003Cscript src=\"..\u002Freference\u002F...\">` | 읽기 전용 자산 |\n\n- `backoffice\u002Fpackage.json` 에 React 17 · Redux Toolkit · Vite 가 **선언만** 되어 있다.\n  `src\u002F` 도 `.jsx` 도 없고 `backoffice\u002FREADME.md` 가 \"React 는 선행 과제\"라고 못박는다.\n  **backoffice 신규 화면도 jQuery 로 작성한다.** JSX 를 만들면 빌드조차 되지 않는다.\n- 루트 `package.json` 의 Vue 는 2026-06-23 제거됐다. 현재 루트는 arms Grunt 빌드 전용이다.\n- `.ts` \u002F `.tsx` 를 추가하지 않는다.\n- `backoffice\u002Ftemplate.html` 도 `..\u002Farms\u002Fjs\u002Fcommon.js` 를 그대로 로드한다.\n  즉 **공통 허브는 두 영역이 공유**한다. arms 쪽 `common.js` 수정은 백오피스까지 영향이 간다.\n\n---\n\n## 2. 페이지 라이프사이클 (이 저장소의 핵심 계약)\n\n`arms\u002Fjs\u002Fcommon.js` 가 전 과정을 주관한다. 페이지 스크립트는 이 흐름에 **끼어드는 쪽**이다.\n\n```\ntemplate.html?page=reqAdd\n  └ $(function(){ ... })                     common.js:26\n      ├ URL 에 \"landing_\" 포함  → 인증 건너뜀 → runScript()\n      └ 그 외                   → authUserCheck()  (GET \u002Fauth-user\u002Fme)\n                                    └ $.authorization(userID, page) → runScript()\n  └ runScript()                              common.js:38\n      ├ topbarConfig() \u002F supportBubble() \u002F rightBottomTopForwardIcon()\n      ├ ajax_setup()                         전역 401·403·500 핸들러 등록\n      ├ includeLayout(page)                  [data-include] 스캔 → 조각 $.load()\n      │     content-header    → html\u002F{page}\u002Fcontent-header.html\n      │     content-container → html\u002F{page}\u002Fcontent-container.html\n      │     page-navigation \u002F page-sidebar \u002F content-footer → html\u002Ftemplate\u002F* (landing·detail 변형)\n      ├ loadTheme()\n      └ $.getScript(\"js\u002F{page}.js\")\n            ├ execDocReady()      ← 페이지가 반드시 정의해야 하는 진입점\n            ├ dwr_login(...)      (landing_* 제외)\n            └ menu_setting()      ROLE_USER \u002F ROLE_MANAGER \u002F ROLE_ADMIN 메뉴 분기\n```\n\n### 페이지가 반드시 정의해야 하는 전역 함수\n\n| 함수 | 언제 필요한가 | 빠뜨리면 |\n|------|--------------|---------|\n| `execDocReady()` | **항상** | 페이지가 아무것도 안 함 (조용한 실패) |\n| `dataTableClick(tempDataTable, selectedData)` | `dataTable_build` \u002F `dataTable_extendBuild` 사용 시 | `ReferenceError` 로 테이블 렌더 중단 |\n| `dataTableCallBack(settings, json)` | 〃 | 〃 |\n| `dataTableDrawCallback(tableInfo)` | 〃 | 〃 |\n| `jsTreeClick(selectedNode)` | `jsTreeBuild` 사용 시 | 트리 노드 클릭이 무반응 |\n\nDataTable 콜백 3종은 `common.js` 가 `$.isFunction(dataTableDrawCallback)` 로 가드하지만,\n**선언 자체가 없으면 인자 평가 시점에 ReferenceError** 가 난다. 본문이 비어 있어도 선언한다.\n(`arms\u002Fjs\u002Fdetail_kpi.js:604-614` 가 최소 예시)\n\n### execDocReady() 의 표준 골격\n\n플러그인은 `\u003Cscript>` 로 박지 않고 `loadPluginGroupsParallelAndSequential()` 로 올린다.\n인자는 **배열의 배열** — 바깥은 병렬, 안쪽은 순차(의존 순서가 있는 묶음)다.\n\n```javascript\nfunction execDocReady() {\n\tvar pluginGroups = [\n\t\t[\"..\u002Freference\u002Flightblue4\u002Fdocs\u002Flib\u002Fwidgster\u002Fwidgster.js\"],\n\t\t[\n\t\t\t\"..\u002Freference\u002Fjquery-plugins\u002Fselect2-4.0.2\u002Fdist\u002Fcss\u002Fselect2_lightblue4.css\",\n\t\t\t\"..\u002Freference\u002Fjquery-plugins\u002Fselect2-4.0.2\u002Fdist\u002Fjs\u002Fselect2.min.js\"\n\t\t],\n\t\t[\"..\u002Freference\u002Fjquery-plugins\u002Fecharts-5.5.0\u002Fdist\u002Fecharts.min.js\"]\n\t];\n\n\tloadPluginGroupsParallelAndSequential(pluginGroups)\n\t\t.then(function () {\n\t\t\t$(\".spinner\").empty();      \u002F\u002F 로딩 메시지 잔류 방지 (§6 참조)\n\t\t\t$(\".widget\").widgster();    \u002F\u002F lightblue4 위젯 컨트롤 활성화\n\t\t\tsetSideMenu(\"sidebar_menu_requirement\", \"sidebar_menu_requirement_add\");\n\t\t\t\u002F\u002F 이 아래부터 화면 초기화\n\t\t})\n\t\t.catch(function (error) {\n\t\t\tconsole.error(\"[ {page} ] 플러그인 로드 실패\");\n\t\t\tconsole.error(error);\n\t\t});\n}\n```\n\n전체 템플릿은 `assets\u002Fpage-template\u002F` 의 `page.js` · `content-container.html` ·\n`content-header.html` 을 복사해서 시작한다.\n\n---\n\n## 3. 작업 레시피\n\n### 기존 화면 수정\n1. `arms\u002Fhtml\u002F{page}\u002Fcontent-container.html` 과 `arms\u002Fjs\u002F{page}.js` 를 **둘 다** 읽는다.\n   ID 규칙·렌더 함수 짝이 여기서 드러난다.\n2. `Java-Service-Tree-Framework-Frontend-Web\u002Fdocs\u002Fai\u002F06_page_playbooks\u002F{page}.md` 가 있으면\n   그 화면의 데이터·상태·디자인 규칙이 정본이므로 먼저 읽는다\n   (현재 존재: `detail_dashboard.md`, `detail_kpi.md`).\n3. 주변 코드 스타일에 맞춘다. 이 저장소는 ES5\u002FES6 가 섞여 있고 **일관성이 최신 문법보다 우선**이다.\n\n### 새 화면 추가\n`html\u002F{page}\u002Fcontent-container.html` 과 `js\u002F{page}.js` 를 **1:1 쌍**으로 만들어야 라우팅이 성립한다.\n단계별 절차·진입 메뉴 등록까지는 `references\u002Fpage-recipes.md` 를 따른다.\n\n페이지 이름 prefix 가 인증 동작을 결정한다:\n- `landing_*` — 인증 면제(랜딩\u002F마케팅). `common.js` 가 URL 로 판별한다.\n- `detail_*` — 인증 필요, 읽기 전용 상세. `arms\u002Fhtml\u002Fdetail\u002Fpage-sidebar.html` 의\n  `targetLink('{page}')` 로 진입 링크를 등록한다.\n- 그 외(`req*`, `pdService`, `analysis*`, `report*`, `dashboard` …) — 인증 필요,\n  `arms\u002Fhtml\u002Ftemplate\u002Fpage-sidebar.html` 에 등록.\n\n### 서버 연동\n게이트웨이 prefix·에러 처리·응답 봉투는 `references\u002Fdomain-and-api.md` 가 정본이다. 핵심만:\n- 전역 핸들러가 401(로그인 리다이렉트) · 403(알림) · 500(알림) 을 **이미 처리**한다.\n  페이지에서 중복 처리하지 않는다.\n- 권한에 맞는 prefix 를 고른다: `\u002Fauth-anon`(익명) · `\u002Fauth-user` · `\u002Fauth-manager` ·\n  `\u002Fauth-sche` · `\u002Fauth-admin`.\n- 호출 형태는 페이지 코드의 기존 패턴을 따른다:\n\n```javascript\n$.ajax({\n\turl: \"\u002Fauth-user\u002Fapi\u002Farms\u002FpdService\u002FgetVersionList?c_id=\" + pdServiceId,\n\ttype: \"GET\",\n\tcontentType: \"application\u002Fjson;charset=UTF-8\",\n\tdataType: \"json\",\n\tprogress: true,\n\tstatusCode: {\n\t\t200: function (data) {\n\t\t\t\u002F\u002F 구형 .do API: { response: [...] }\n\t\t\t\u002F\u002F 신형 엔진 API: { success: true, response: {...} }\n\t\t}\n\t}\n});\n```\n\n---\n\n## 4. 공통 함수를 다시 만들지 않는다\n\n`common.js`(약 2,950줄)가 트리·테이블·인증·i18n·알림·쿠키·테마·투어를 모두 갖고 있다.\n시그니처와 호출 예시는 `references\u002Fcommon-js-api.md` 에 정리해 두었다 — **새 유틸을 쓰기 전에 거기부터 본다.**\n\n가장 자주 쓰는 것들:\n\n| 기능 | 함수 |\n|------|------|\n| 데이터 그리드 | `dataTable_build(...)` \u002F 서버사이드는 `dataTable_extendBuild(...)` |\n| 새 테이블 래퍼 | `$(\"#t\").table({...})` — `arms\u002Fjs\u002Fcommon\u002Ftable_new.js` (백오피스 주력) |\n| 트리 | `jsTreeBuild(elementId, serviceUrl, syncUrl, scrollHeight)` |\n| 알림 | `jSuccess()` \u002F `jError()` \u002F `jNotify()` — `alert()` 금지 |\n| 버튼 로딩 | `laddaBtnSetting([\".btn_save\"])` |\n| 사이드 메뉴 활성화 | `setSideMenu(\"sidebar_menu_a\", \"sidebar_menu_a_b\")` |\n| 다국어 | `setLocale(locale)` + 마크업의 `data-locale=\"키.경로\"` |\n| 쿠키 | `getCookie(name)` \u002F `setCookie(name, value, exp, [\"\u002Farms\",\"\u002Fbackoffice\"])` |\n| 빈값 판정 | `isEmpty(v)` \u002F `isExist(v)` |\n| 날짜 | `dateFormat(ts)` \u002F `dateFormatSlash(ts)` \u002F `getToday()` \u002F `parseDateString(s)` |\n| 페이지 이동 | `goToTemplatePage(pageName)` \u002F `targetLink(path)` |\n\n한글 함수명과 영문 함수명이 공존한다(`로드_완료_이후_실행_함수`, `톱니바퀴_초기설정`,\n`검색_이벤트_트리거`). 호출 전 이름을 정확히 확인한다.\n\n---\n\n## 5. 지켜야 하는 표기 규칙\n\n전체는 `references\u002Fconventions.md`. 위반이 잦은 것만 여기 둔다.\n\n- **Bootstrap 3 전용.** `d-flex` · `ml-2` 같은 BS4\u002FBS5 유틸은 이 테마에 존재하지 않는다.\n  `col-md-*` · `pull-right` · `hidden-xs` 를 쓴다.\n- **위젯 구조:** `section.widget > header > h4` + `.widget-controls` + `div.body`.\n  샘플은 `arms\u002Fhtml\u002FpdService\u002Fcontent-container.html`.\n- **id 는 스네이크 케이스(언더바):** `selected_worker`, `project_status_table`.\n- **HTML 속성은 한 줄에 하나씩.** 이건 취향이 아니라 `.prettierrc` 의\n  `singleAttributePerLine: true` 가 강제하는 형식이다. 편집 후\n  `npx prettier --write \u003C파일>` 로 맞추면 diff 가 깔끔해진다.\n  (탭 들여쓰기 · printWidth 120 · 쌍따옴표 · `bracketSameLine: true`)\n- **버튼 색상은 의미가 고정**이다 — 파랑 `edit-blue`(추가) \u002F 녹색 `edit-green`(수정) \u002F\n  빨강 `edit-red`(삭제) \u002F 오렌지 `edit-orange`(선택 구분). 다른 색을 새로 만들지 않는다.\n- **상태 색상(전역):** Done `#34d399` · Normal `#a4c6ff` · Warning `#fbbf24` · Critical `#f87171`.\n  강조 데이터 텍스트는 `color: #a4c6ff`.\n- **문구는 `data-locale` 바인딩**을 쓰고 로컬 폴백 파일 `arms\u002Flocales\u002Fko.json` · `en.json`\n  **두 개를 함께** 갱신한다. `jp.json` 은 건드리지 않는다 — 0바이트 사(死)파일이고\n  `setLocale()` 이 요청하는 이름은 `ja.json` 이다(§6-3).\n  단, 이미 한글 문구를 하드코딩하고 있는 화면 옆에 새 요소를 넣을 때는 주변 방식을 따른다\n  (backoffice 19개 화면 중 `data-locale` 사용은 1개뿐이다).\n- 운영 코드에 `console.log` 를 남기지 않는다. 진단용 로그는\n  `console.log(\"[ {page} :: {fn} ] ...\")` 형식을 쓰되 작업 후 정리한다.\n\n---\n\n## 6. 이 저장소에서 반복적으로 사람을 무는 함정\n\n자세한 증상·우회법은 `references\u002Fpitfalls.md`. 요약:\n\n1. **DataTable 콜백 3종 미선언 → ReferenceError** (§2 표).\n2. **플러그인 로딩 메시지 잔류** — `loadPlugin()` 이 `.spinner` 에 \"OO.js 다운로드 중\"을 쓰고\n   지우지 않는다. `.then()` 안에서 `$(\".spinner\").empty()` 를 호출한다.\n3. **일본어 폴백이 아예 없다** — `setLocale()` 은 Global-Config 실패 시\n   `\u002Farms\u002Flocales\u002F{locale}.json` 을 부르고 `changeLocale()` 허용값은 `[\"ko\",\"ja\",\"en\"]` 이다.\n   그런데 저장소에 있는 파일은 `ko.json` · `en.json` · **`jp.json`(0바이트)** 라\n   `ja` 선택 시 `ja.json` 404 → 라벨이 전부 빈 값이 된다. `jp.json` 은 어느 코드도 읽지 않는\n   사(死)파일이니 여기에 키를 넣지 말 것(0바이트 파일에 키 하나만 넣으면 파싱이 성공해\n   **나머지 모든 라벨이 빈 값으로 덮인다** — 더 나빠진다). 일본어가 필요하면 `ja.json` 신설 또는\n   Global-Config 등록을 별도 과제로 제안한다. (도움말 JSON 폴더는 `help\u002F*\u002Fja\u002F` 로 `ja` 를 쓴다.)\n4. **`reference\u002F` 경로에 버전이 박혀 있다** (`echarts-5.5.0`, `select2-4.0.2`).\n   기존 화면을 고칠 때는 **그 화면이 이미 로드한 버전**을 따른다(arms 는 5.4.3 · 5.5.0 혼재).\n5. **`common.js` · `template.html` · `locales\u002F*` 는 전 페이지 공용**이다.\n   고치기 전에 영향 범위를 먼저 말하고, 페이지 단위로 해결할 수 있으면 그쪽을 택한다.\n6. **`$.ApiGenerator` 는 저장소 어디에도 정의가 없다.** `backoffice\u002Fjs\u002FscheduleConfig\u002Fapi\u002FscheduleConfigApi.js`\n   가 이것을 호출하므로 그 모듈은 현재 런타임 에러 상태다. 이 패턴을 새로 따라하지 않는다.\n7. **대형 정적 도구(drawio · three.js-r165 · drawdb)는 임베드만** 한다. 내부 파일을 편집하지 않는다.\n\n---\n\n## 7. 라이브러리는 `reference\u002F` 에서 먼저 찾는다\n\nnpm 설치가 아니라 저장소에 박힌 정적 번들이다. 차트·테이블·날짜선택·셀렉트·에디터·업로드 등\n흔한 기능은 대부분 이미 있다. 기능 → 라이브러리 → 정확한 로드 경로 표는\n`references\u002Flibraries.md` 에 있다.\n\n목록에 없는 라이브러리가 필요하면 **코드를 쓰기 전에 먼저 제안**한다.\nCDN 링크를 새로 박지 않는다(오프라인\u002F사내망 전제).\n\n---\n\n## 8. 실행해서 확인하기\n\n```bash\ncd Java-Service-Tree-Framework-Frontend-Web\nnpm install          # Node v20.19.0 (.node-version)\nnpx grunt server     # = npm run dev\n```\n\n`grunt server` 는 **포트 80** 으로 정적 서빙하고, `\u002Fauth-user` · `\u002Fauth-admin` · `\u002Fauth-anon` ·\n`\u002Foauth2` · `\u002Flogin` · `\u002Fdwr` 등을 `313.co.kr:80` (Stage) 로 프록시한다(`Gruntfile.js`).\n확인 URL: `http:\u002F\u002Flocalhost\u002Farms\u002Ftemplate.html?page={page}`\n\n자동화 테스트는 없다. 검증은 **브라우저 콘솔 에러 0건 + 화면 동작 육안 확인**이 기준이다.\n`docs\u002Fai\u002F06_test_strategy\u002Ffrontend-web-test-strategy.md` 의 수동 체크리스트를 쓴다.\n\n---\n\n## 9. 제출 전 자가 점검\n\n- [ ] 영역(arms \u002F backoffice)을 맞게 판단했고 스택을 섞지 않았다\n- [ ] 새 페이지면 `html\u002F{page}\u002Fcontent-container.html` + `js\u002F{page}.js` 쌍이 있다\n- [ ] `execDocReady()` 를 정의했고, DataTable 쓰는 페이지는 콜백 3종을 선언했다\n- [ ] 공통 기능을 `common.js` 기존 함수로 처리했다(중복 구현 없음)\n- [ ] Bootstrap 3 클래스만 썼고 lightblue4 위젯 구조를 따랐다\n- [ ] 버튼 4색 · 상태 4색 규칙을 지켰다\n- [ ] 새 문구를 `locales\u002Fko.json` · `en.json` 에 함께 넣었다(`jp.json` 은 건드리지 않았다)\n- [ ] `reference\u002F` 밖의 새 라이브러리를 임의로 추가하지 않았다\n- [ ] 태그 균형(`div`\u002F`section`\u002F`table`\u002F`tr`)과 JSON 유효성을 확인했다\n- [ ] `console.log` · `alert` · 임시 파일을 남기지 않았다\n- [ ] 요청 범위를 넘는 집계·기능을 임의로 붙이지 않았다(YAGNI)\n- [ ] 의미 있는 변경이면 `docs\u002Fai\u002F11_changelog\u002Ffrontend-web-changelog.md` 에 한 줄 남겼다\n\n---\n\n## 10. 산출 및 인계\n\n- 사용자 대상 설명은 **한국어**로 한다.\n- **commit·push 하지 않는다.** 작업 요약과 함께 커밋 메시지 초안만 제시하고 커밋은 사용자가 한다.\n  이 저장소의 실제 컨벤션(YouTrack 연동):\n  ```\n  feat : [ARMS-1160] #comment 담당자별 진행율 및 css추가\n  fix : [ARMS-1160] #comment 스크롤 상단으로 이동되는 부분 수정\n  refactor : [ARMS-1195] #comment 불필요 요소 정리 2026.09.15 #close #time 1h +review SR @sevoon0909\n  ```\n  현재 작업 브랜치는 `dev` 다(`main`\u002F`master` 아님).\n- 확신이 없는 지점(엔드포인트 스펙, 응답 필드, 디자인 판단)은 추측으로 메우지 말고\n  **가정을 명시**하거나 질문한다.\n\n---\n\n## 11. 참조 파일 지도\n\n이 스킬의 상세 자료 (`references\u002F`):\n\n| 파일 | 언제 읽나 |\n|------|----------|\n| `references\u002Fcommon-js-api.md` | 공통 함수 시그니처·호출 예시가 필요할 때 |\n| `references\u002Fpage-recipes.md` | 새 화면 추가 \u002F 기존 화면 확장 절차 |\n| `references\u002Flibraries.md` | 기능에 맞는 번들 라이브러리와 로드 경로 |\n| `references\u002Fconventions.md` | 마크업·네이밍·색상·i18n·도움말\u002F투어 규칙 |\n| `references\u002Fdomain-and-api.md` | 게이트웨이·인증·응답 계약·도메인 용어·상태 구간 |\n| `references\u002Fbackoffice.md` | `backoffice\u002F` 영역에서 작업할 때 |\n| `references\u002Fpitfalls.md` | 이상 동작이 보일 때 \u002F 착수 전 함정 확인 |\n\n저장소 자체 문서 (`Java-Service-Tree-Framework-Frontend-Web\u002Fdocs\u002Fai\u002F`) 도 살아 있는 정본이다.\n용어는 `08_domain_glossary`, 화면별 규칙은 `06_page_playbooks\u002F{page}.md`,\n변경 이력은 `11_changelog` 에 남긴다.\n\n> ⚠️ 단, 아래 항목은 **문서가 현재 코드와 어긋나 있음을 확인**했다. 코드를 정본으로 삼는다.\n> - `03_directory_structure` §3 은 backoffice 를 React(`src\u002F`)로 서술하지만 `src\u002F` 는 존재하지 않는다\n>   (같은 폴더의 `02_tech_stack` §3 · `12_known_issues` §1 이 맞다).\n> - 여러 문서가 루트 `개발규칙.txt` 를 원본으로 인용하지만 **그 파일은 저장소에 없다.**\n>   코딩 규칙의 실질 정본은 `04_coding_standards\u002Ffrontend-web-coding-standards.md` 다.\n> - `06_page_playbooks\u002Fguide.md` 가 링크하는 `landing_test.md` 와 `landing_test` 페이지는 삭제됐다.\n> - `13_deploy_runbook` 이 언급하는 `.travis.yml` 과 루트 `file\u002F` 디렉토리는 없다\n>   (CI 는 `.github\u002Fworkflows\u002Frelease-drafter.yml` 하나, 문서 자산은 `docs\u002Ffile\u002F`).\n","# A-RMS Frontend-Web 작업 규약\n\n대상 저장소: `Java-Service-Tree-Framework-Frontend-Web\u002F`\n(워크스페이스 루트 `C:\\DEV\\Project\\Java-Service-Tree-Framework` 하위)\n\n이 저장소는 **트랜스파일·번들러가 없는 브라우저 직접 실행 앱**이다. `\u003Cscript>` 로 올라간\n전역 함수들이 서로를 이름으로 호출하는 구조라, 규약을 어기면 빌드 에러가 아니라\n**런타임에 조용히 깨진다.** 아래 계약을 먼저 파악하고 손대는 것이 이 저장소에서\n가장 비용이 싼 길이다.\n\n---\n\n## 1. 먼저 영역을 판별한다\n\n| 영역 | 실제 스택 | 진입 | 성격 |\n|------|----------|------|------|\n| `arms\u002F` | jQuery 3 + 바닐라 JS + Bootstrap 3(lightblue4) | `arms\u002Ftemplate.html?page={page}` · `arms\u002Fdetail.html?mode=detail` | 운영 중 메인 앱 |\n| `backoffice\u002F` | **arms와 동일한 jQuery MPA** | `backoffice\u002Ftemplate.html?page={feature}` | 관리자 백오피스 |\n| `reference\u002F` | 정적 번들 라이브러리(npm 아님) | `\u003Cscript src=\"..\u002Freference\u002F...\">` | 읽기 전용 자산 |\n\n- `backoffice\u002Fpackage.json` 에 React 17 · Redux Toolkit · Vite 가 **선언만** 되어 있다.\n  `src\u002F` 도 `.jsx` 도 없고 `backoffice\u002FREADME.md` 가 \"React 는 선행 과제\"라고 못박는다.\n  **backoffice 신규 화면도 jQuery 로 작성한다.** JSX 를 만들면 빌드조차 되지 않는다.\n- 루트 `package.json` 의 Vue 는 2026-06-23 제거됐다. 현재 루트는 arms Grunt 빌드 전용이다.\n- `.ts` \u002F `.tsx` 를 추가하지 않는다.\n- `backoffice\u002Ftemplate.html` 도 `..\u002Farms\u002Fjs\u002Fcommon.js` 를 그대로 로드한다.\n  즉 **공통 허브는 두 영역이 공유**한다. arms 쪽 `common.js` 수정은 백오피스까지 영향이 간다.\n\n---\n\n## 2. 페이지 라이프사이클 (이 저장소의 핵심 계약)\n\n`arms\u002Fjs\u002Fcommon.js` 가 전 과정을 주관한다. 페이지 스크립트는 이 흐름에 **끼어드는 쪽**이다.\n\n```\ntemplate.html?page=reqAdd\n  └ $(function(){ ... })                     common.js:26\n      ├ URL 에 \"landing_\" 포함  → 인증 건너뜀 → runScript()\n      └ 그 외                   → authUserCheck()  (GET \u002Fauth-user\u002Fme)\n                                    └ $.authorization(userID, page) → runScript()\n  └ runScript()                              common.js:38\n      ├ topbarConfig() \u002F supportBubble() \u002F rightBottomTopForwardIcon()\n      ├ ajax_setup()                         전역 401·403·500 핸들러 등록\n      ├ includeLayout(page)                  [data-include] 스캔 → 조각 $.load()\n      │     content-header    → html\u002F{page}\u002Fcontent-header.html\n      │     content-container → html\u002F{page}\u002Fcontent-container.html\n      │     page-navigation \u002F page-sidebar \u002F content-footer → html\u002Ftemplate\u002F* (landing·detail 변형)\n      ├ loadTheme()\n      └ $.getScript(\"js\u002F{page}.js\")\n            ├ execDocReady()      ← 페이지가 반드시 정의해야 하는 진입점\n            ├ dwr_login(...)      (landing_* 제외)\n            └ menu_setting()      ROLE_USER \u002F ROLE_MANAGER \u002F ROLE_ADMIN 메뉴 분기\n```\n\n### 페이지가 반드시 정의해야 하는 전역 함수\n\n| 함수 | 언제 필요한가 | 빠뜨리면 |\n|------|--------------|---------|\n| `execDocReady()` | **항상** | 페이지가 아무것도 안 함 (조용한 실패) |\n| `dataTableClick(tempDataTable, selectedData)` | `dataTable_build` \u002F `dataTable_extendBuild` 사용 시 | `ReferenceError` 로 테이블 렌더 중단 |\n| `dataTableCallBack(settings, json)` | 〃 | 〃 |\n| `dataTableDrawCallback(tableInfo)` | 〃 | 〃 |\n| `jsTreeClick(selectedNode)` | `jsTreeBuild` 사용 시 | 트리 노드 클릭이 무반응 |\n\nDataTable 콜백 3종은 `common.js` 가 `$.isFunction(dataTableDrawCallback)` 로 가드하지만,\n**선언 자체가 없으면 인자 평가 시점에 ReferenceError** 가 난다. 본문이 비어 있어도 선언한다.\n(`arms\u002Fjs\u002Fdetail_kpi.js:604-614` 가 최소 예시)\n\n### execDocReady() 의 표준 골격\n\n플러그인은 `\u003Cscript>` 로 박지 않고 `loadPluginGroupsParallelAndSequential()` 로 올린다.\n인자는 **배열의 배열** — 바깥은 병렬, 안쪽은 순차(의존 순서가 있는 묶음)다.\n\n```javascript\nfunction execDocReady() {\n\tvar pluginGroups = [\n\t\t[\"..\u002Freference\u002Flightblue4\u002Fdocs\u002Flib\u002Fwidgster\u002Fwidgster.js\"],\n\t\t[\n\t\t\t\"..\u002Freference\u002Fjquery-plugins\u002Fselect2-4.0.2\u002Fdist\u002Fcss\u002Fselect2_lightblue4.css\",\n\t\t\t\"..\u002Freference\u002Fjquery-plugins\u002Fselect2-4.0.2\u002Fdist\u002Fjs\u002Fselect2.min.js\"\n\t\t],\n\t\t[\"..\u002Freference\u002Fjquery-plugins\u002Fecharts-5.5.0\u002Fdist\u002Fecharts.min.js\"]\n\t];\n\n\tloadPluginGroupsParallelAndSequential(pluginGroups)\n\t\t.then(function () {\n\t\t\t$(\".spinner\").empty();      \u002F\u002F 로딩 메시지 잔류 방지 (§6 참조)\n\t\t\t$(\".widget\").widgster();    \u002F\u002F lightblue4 위젯 컨트롤 활성화\n\t\t\tsetSideMenu(\"sidebar_menu_requirement\", \"sidebar_menu_requirement_add\");\n\t\t\t\u002F\u002F 이 아래부터 화면 초기화\n\t\t})\n\t\t.catch(function (error) {\n\t\t\tconsole.error(\"[ {page} ] 플러그인 로드 실패\");\n\t\t\tconsole.error(error);\n\t\t});\n}\n```\n\n전체 템플릿은 `assets\u002Fpage-template\u002F` 의 `page.js` · `content-container.html` ·\n`content-header.html` 을 복사해서 시작한다.\n\n---\n\n## 3. 작업 레시피\n\n### 기존 화면 수정\n1. `arms\u002Fhtml\u002F{page}\u002Fcontent-container.html` 과 `arms\u002Fjs\u002F{page}.js` 를 **둘 다** 읽는다.\n   ID 규칙·렌더 함수 짝이 여기서 드러난다.\n2. `Java-Service-Tree-Framework-Frontend-Web\u002Fdocs\u002Fai\u002F06_page_playbooks\u002F{page}.md` 가 있으면\n   그 화면의 데이터·상태·디자인 규칙이 정본이므로 먼저 읽는다\n   (현재 존재: `detail_dashboard.md`, `detail_kpi.md`).\n3. 주변 코드 스타일에 맞춘다. 이 저장소는 ES5\u002FES6 가 섞여 있고 **일관성이 최신 문법보다 우선**이다.\n\n### 새 화면 추가\n`html\u002F{page}\u002Fcontent-container.html` 과 `js\u002F{page}.js` 를 **1:1 쌍**으로 만들어야 라우팅이 성립한다.\n단계별 절차·진입 메뉴 등록까지는 `references\u002Fpage-recipes.md` 를 따른다.\n\n페이지 이름 prefix 가 인증 동작을 결정한다:\n- `landing_*` — 인증 면제(랜딩\u002F마케팅). `common.js` 가 URL 로 판별한다.\n- `detail_*` — 인증 필요, 읽기 전용 상세. `arms\u002Fhtml\u002Fdetail\u002Fpage-sidebar.html` 의\n  `targetLink('{page}')` 로 진입 링크를 등록한다.\n- 그 외(`req*`, `pdService`, `analysis*`, `report*`, `dashboard` …) — 인증 필요,\n  `arms\u002Fhtml\u002Ftemplate\u002Fpage-sidebar.html` 에 등록.\n\n### 서버 연동\n게이트웨이 prefix·에러 처리·응답 봉투는 `references\u002Fdomain-and-api.md` 가 정본이다. 핵심만:\n- 전역 핸들러가 401(로그인 리다이렉트) · 403(알림) · 500(알림) 을 **이미 처리**한다.\n  페이지에서 중복 처리하지 않는다.\n- 권한에 맞는 prefix 를 고른다: `\u002Fauth-anon`(익명) · `\u002Fauth-user` · `\u002Fauth-manager` ·\n  `\u002Fauth-sche` · `\u002Fauth-admin`.\n- 호출 형태는 페이지 코드의 기존 패턴을 따른다:\n\n```javascript\n$.ajax({\n\turl: \"\u002Fauth-user\u002Fapi\u002Farms\u002FpdService\u002FgetVersionList?c_id=\" + pdServiceId,\n\ttype: \"GET\",\n\tcontentType: \"application\u002Fjson;charset=UTF-8\",\n\tdataType: \"json\",\n\tprogress: true,\n\tstatusCode: {\n\t\t200: function (data) {\n\t\t\t\u002F\u002F 구형 .do API: { response: [...] }\n\t\t\t\u002F\u002F 신형 엔진 API: { success: true, response: {...} }\n\t\t}\n\t}\n});\n```\n\n---\n\n## 4. 공통 함수를 다시 만들지 않는다\n\n`common.js`(약 2,950줄)가 트리·테이블·인증·i18n·알림·쿠키·테마·투어를 모두 갖고 있다.\n시그니처와 호출 예시는 `references\u002Fcommon-js-api.md` 에 정리해 두었다 — **새 유틸을 쓰기 전에 거기부터 본다.**\n\n가장 자주 쓰는 것들:\n\n| 기능 | 함수 |\n|------|------|\n| 데이터 그리드 | `dataTable_build(...)` \u002F 서버사이드는 `dataTable_extendBuild(...)` |\n| 새 테이블 래퍼 | `$(\"#t\").table({...})` — `arms\u002Fjs\u002Fcommon\u002Ftable_new.js` (백오피스 주력) |\n| 트리 | `jsTreeBuild(elementId, serviceUrl, syncUrl, scrollHeight)` |\n| 알림 | `jSuccess()` \u002F `jError()` \u002F `jNotify()` — `alert()` 금지 |\n| 버튼 로딩 | `laddaBtnSetting([\".btn_save\"])` |\n| 사이드 메뉴 활성화 | `setSideMenu(\"sidebar_menu_a\", \"sidebar_menu_a_b\")` |\n| 다국어 | `setLocale(locale)` + 마크업의 `data-locale=\"키.경로\"` |\n| 쿠키 | `getCookie(name)` \u002F `setCookie(name, value, exp, [\"\u002Farms\",\"\u002Fbackoffice\"])` |\n| 빈값 판정 | `isEmpty(v)` \u002F `isExist(v)` |\n| 날짜 | `dateFormat(ts)` \u002F `dateFormatSlash(ts)` \u002F `getToday()` \u002F `parseDateString(s)` |\n| 페이지 이동 | `goToTemplatePage(pageName)` \u002F `targetLink(path)` |\n\n한글 함수명과 영문 함수명이 공존한다(`로드_완료_이후_실행_함수`, `톱니바퀴_초기설정`,\n`검색_이벤트_트리거`). 호출 전 이름을 정확히 확인한다.\n\n---\n\n## 5. 지켜야 하는 표기 규칙\n\n전체는 `references\u002Fconventions.md`. 위반이 잦은 것만 여기 둔다.\n\n- **Bootstrap 3 전용.** `d-flex` · `ml-2` 같은 BS4\u002FBS5 유틸은 이 테마에 존재하지 않는다.\n  `col-md-*` · `pull-right` · `hidden-xs` 를 쓴다.\n- **위젯 구조:** `section.widget > header > h4` + `.widget-controls` + `div.body`.\n  샘플은 `arms\u002Fhtml\u002FpdService\u002Fcontent-container.html`.\n- **id 는 스네이크 케이스(언더바):** `selected_worker`, `project_status_table`.\n- **HTML 속성은 한 줄에 하나씩.** 이건 취향이 아니라 `.prettierrc` 의\n  `singleAttributePerLine: true` 가 강제하는 형식이다. 편집 후\n  `npx prettier --write \u003C파일>` 로 맞추면 diff 가 깔끔해진다.\n  (탭 들여쓰기 · printWidth 120 · 쌍따옴표 · `bracketSameLine: true`)\n- **버튼 색상은 의미가 고정**이다 — 파랑 `edit-blue`(추가) \u002F 녹색 `edit-green`(수정) \u002F\n  빨강 `edit-red`(삭제) \u002F 오렌지 `edit-orange`(선택 구분). 다른 색을 새로 만들지 않는다.\n- **상태 색상(전역):** Done `#34d399` · Normal `#a4c6ff` · Warning `#fbbf24` · Critical `#f87171`.\n  강조 데이터 텍스트는 `color: #a4c6ff`.\n- **문구는 `data-locale` 바인딩**을 쓰고 로컬 폴백 파일 `arms\u002Flocales\u002Fko.json` · `en.json`\n  **두 개를 함께** 갱신한다. `jp.json` 은 건드리지 않는다 — 0바이트 사(死)파일이고\n  `setLocale()` 이 요청하는 이름은 `ja.json` 이다(§6-3).\n  단, 이미 한글 문구를 하드코딩하고 있는 화면 옆에 새 요소를 넣을 때는 주변 방식을 따른다\n  (backoffice 19개 화면 중 `data-locale` 사용은 1개뿐이다).\n- 운영 코드에 `console.log` 를 남기지 않는다. 진단용 로그는\n  `console.log(\"[ {page} :: {fn} ] ...\")` 형식을 쓰되 작업 후 정리한다.\n\n---\n\n## 6. 이 저장소에서 반복적으로 사람을 무는 함정\n\n자세한 증상·우회법은 `references\u002Fpitfalls.md`. 요약:\n\n1. **DataTable 콜백 3종 미선언 → ReferenceError** (§2 표).\n2. **플러그인 로딩 메시지 잔류** — `loadPlugin()` 이 `.spinner` 에 \"OO.js 다운로드 중\"을 쓰고\n   지우지 않는다. `.then()` 안에서 `$(\".spinner\").empty()` 를 호출한다.\n3. **일본어 폴백이 아예 없다** — `setLocale()` 은 Global-Config 실패 시\n   `\u002Farms\u002Flocales\u002F{locale}.json` 을 부르고 `changeLocale()` 허용값은 `[\"ko\",\"ja\",\"en\"]` 이다.\n   그런데 저장소에 있는 파일은 `ko.json` · `en.json` · **`jp.json`(0바이트)** 라\n   `ja` 선택 시 `ja.json` 404 → 라벨이 전부 빈 값이 된다. `jp.json` 은 어느 코드도 읽지 않는\n   사(死)파일이니 여기에 키를 넣지 말 것(0바이트 파일에 키 하나만 넣으면 파싱이 성공해\n   **나머지 모든 라벨이 빈 값으로 덮인다** — 더 나빠진다). 일본어가 필요하면 `ja.json` 신설 또는\n   Global-Config 등록을 별도 과제로 제안한다. (도움말 JSON 폴더는 `help\u002F*\u002Fja\u002F` 로 `ja` 를 쓴다.)\n4. **`reference\u002F` 경로에 버전이 박혀 있다** (`echarts-5.5.0`, `select2-4.0.2`).\n   기존 화면을 고칠 때는 **그 화면이 이미 로드한 버전**을 따른다(arms 는 5.4.3 · 5.5.0 혼재).\n5. **`common.js` · `template.html` · `locales\u002F*` 는 전 페이지 공용**이다.\n   고치기 전에 영향 범위를 먼저 말하고, 페이지 단위로 해결할 수 있으면 그쪽을 택한다.\n6. **`$.ApiGenerator` 는 저장소 어디에도 정의가 없다.** `backoffice\u002Fjs\u002FscheduleConfig\u002Fapi\u002FscheduleConfigApi.js`\n   가 이것을 호출하므로 그 모듈은 현재 런타임 에러 상태다. 이 패턴을 새로 따라하지 않는다.\n7. **대형 정적 도구(drawio · three.js-r165 · drawdb)는 임베드만** 한다. 내부 파일을 편집하지 않는다.\n\n---\n\n## 7. 라이브러리는 `reference\u002F` 에서 먼저 찾는다\n\nnpm 설치가 아니라 저장소에 박힌 정적 번들이다. 차트·테이블·날짜선택·셀렉트·에디터·업로드 등\n흔한 기능은 대부분 이미 있다. 기능 → 라이브러리 → 정확한 로드 경로 표는\n`references\u002Flibraries.md` 에 있다.\n\n목록에 없는 라이브러리가 필요하면 **코드를 쓰기 전에 먼저 제안**한다.\nCDN 링크를 새로 박지 않는다(오프라인\u002F사내망 전제).\n\n---\n\n## 8. 실행해서 확인하기\n\n```bash\ncd Java-Service-Tree-Framework-Frontend-Web\nnpm install          # Node v20.19.0 (.node-version)\nnpx grunt server     # = npm run dev\n```\n\n`grunt server` 는 **포트 80** 으로 정적 서빙하고, `\u002Fauth-user` · `\u002Fauth-admin` · `\u002Fauth-anon` ·\n`\u002Foauth2` · `\u002Flogin` · `\u002Fdwr` 등을 `313.co.kr:80` (Stage) 로 프록시한다(`Gruntfile.js`).\n확인 URL: `http:\u002F\u002Flocalhost\u002Farms\u002Ftemplate.html?page={page}`\n\n자동화 테스트는 없다. 검증은 **브라우저 콘솔 에러 0건 + 화면 동작 육안 확인**이 기준이다.\n`docs\u002Fai\u002F06_test_strategy\u002Ffrontend-web-test-strategy.md` 의 수동 체크리스트를 쓴다.\n\n---\n\n## 9. 제출 전 자가 점검\n\n- [ ] 영역(arms \u002F backoffice)을 맞게 판단했고 스택을 섞지 않았다\n- [ ] 새 페이지면 `html\u002F{page}\u002Fcontent-container.html` + `js\u002F{page}.js` 쌍이 있다\n- [ ] `execDocReady()` 를 정의했고, DataTable 쓰는 페이지는 콜백 3종을 선언했다\n- [ ] 공통 기능을 `common.js` 기존 함수로 처리했다(중복 구현 없음)\n- [ ] Bootstrap 3 클래스만 썼고 lightblue4 위젯 구조를 따랐다\n- [ ] 버튼 4색 · 상태 4색 규칙을 지켰다\n- [ ] 새 문구를 `locales\u002Fko.json` · `en.json` 에 함께 넣었다(`jp.json` 은 건드리지 않았다)\n- [ ] `reference\u002F` 밖의 새 라이브러리를 임의로 추가하지 않았다\n- [ ] 태그 균형(`div`\u002F`section`\u002F`table`\u002F`tr`)과 JSON 유효성을 확인했다\n- [ ] `console.log` · `alert` · 임시 파일을 남기지 않았다\n- [ ] 요청 범위를 넘는 집계·기능을 임의로 붙이지 않았다(YAGNI)\n- [ ] 의미 있는 변경이면 `docs\u002Fai\u002F11_changelog\u002Ffrontend-web-changelog.md` 에 한 줄 남겼다\n\n---\n\n## 10. 산출 및 인계\n\n- 사용자 대상 설명은 **한국어**로 한다.\n- **commit·push 하지 않는다.** 작업 요약과 함께 커밋 메시지 초안만 제시하고 커밋은 사용자가 한다.\n  이 저장소의 실제 컨벤션(YouTrack 연동):\n  ```\n  feat : [ARMS-1160] #comment 담당자별 진행율 및 css추가\n  fix : [ARMS-1160] #comment 스크롤 상단으로 이동되는 부분 수정\n  refactor : [ARMS-1195] #comment 불필요 요소 정리 2026.09.15 #close #time 1h +review SR @sevoon0909\n  ```\n  현재 작업 브랜치는 `dev` 다(`main`\u002F`master` 아님).\n- 확신이 없는 지점(엔드포인트 스펙, 응답 필드, 디자인 판단)은 추측으로 메우지 말고\n  **가정을 명시**하거나 질문한다.\n\n---\n\n## 11. 참조 파일 지도\n\n이 스킬의 상세 자료 (`references\u002F`):\n\n| 파일 | 언제 읽나 |\n|------|----------|\n| `references\u002Fcommon-js-api.md` | 공통 함수 시그니처·호출 예시가 필요할 때 |\n| `references\u002Fpage-recipes.md` | 새 화면 추가 \u002F 기존 화면 확장 절차 |\n| `references\u002Flibraries.md` | 기능에 맞는 번들 라이브러리와 로드 경로 |\n| `references\u002Fconventions.md` | 마크업·네이밍·색상·i18n·도움말\u002F투어 규칙 |\n| `references\u002Fdomain-and-api.md` | 게이트웨이·인증·응답 계약·도메인 용어·상태 구간 |\n| `references\u002Fbackoffice.md` | `backoffice\u002F` 영역에서 작업할 때 |\n| `references\u002Fpitfalls.md` | 이상 동작이 보일 때 \u002F 착수 전 함정 확인 |\n\n저장소 자체 문서 (`Java-Service-Tree-Framework-Frontend-Web\u002Fdocs\u002Fai\u002F`) 도 살아 있는 정본이다.\n용어는 `08_domain_glossary`, 화면별 규칙은 `06_page_playbooks\u002F{page}.md`,\n변경 이력은 `11_changelog` 에 남긴다.\n\n> ⚠️ 단, 아래 항목은 **문서가 현재 코드와 어긋나 있음을 확인**했다. 코드를 정본으로 삼는다.\n> - `03_directory_structure` §3 은 backoffice 를 React(`src\u002F`)로 서술하지만 `src\u002F` 는 존재하지 않는다\n>   (같은 폴더의 `02_tech_stack` §3 · `12_known_issues` §1 이 맞다).\n> - 여러 문서가 루트 `개발규칙.txt` 를 원본으로 인용하지만 **그 파일은 저장소에 없다.**\n>   코딩 규칙의 실질 정본은 `04_coding_standards\u002Ffrontend-web-coding-standards.md` 다.\n> - `06_page_playbooks\u002Fguide.md` 가 링크하는 `landing_test.md` 와 `landing_test` 페이지는 삭제됐다.\n> - `13_deploy_runbook` 이 언급하는 `.travis.yml` 과 루트 `file\u002F` 디렉토리는 없다\n>   (CI 는 `.github\u002Fworkflows\u002Frelease-drafter.yml` 하나, 문서 자산은 `docs\u002Ffile\u002F`).\n",{"name":5,"description":7},"main","f2cc95bc769ca4c3a398965b767dfb41cdf8d698",".claude\u002Fskills\u002Farms-frontend-web",2,"https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace","https:\u002F\u002Fgithub.com\u002F313DEVGRP","https:\u002F\u002Fwww.a-rms.net","2026-10-18 12:48:10",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add 313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace --skill arms-frontend-web",{"tool":38,"command":39},"bunx","bunx skills add 313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace --skill arms-frontend-web",{"tool":41,"command":42},"pnpm","pnpm dlx skills add 313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace --skill arms-frontend-web","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002FSKILL.md",true,[46,52,56,62,68,72,76,80,84,88],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"assets\u002Fpage-template\u002Fcontent-container.html","ASSET","资产文件",2536,"https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002Fassets\u002Fpage-template\u002Fcontent-container.html",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"assets\u002Fpage-template\u002Fcontent-header.html",473,"https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002Fassets\u002Fpage-template\u002Fcontent-header.html",{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"assets\u002Fpage-template\u002Fpage.js","SCRIPT","脚本",5039,"https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002Fassets\u002Fpage-template\u002Fpage.js",{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Fbackoffice.md","REFERENCE","参考文档",5148,"https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002Freferences\u002Fbackoffice.md",{"path":69,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":70,"sourceHtmlUrl":71},"references\u002Fcommon-js-api.md",15234,"https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002Freferences\u002Fcommon-js-api.md",{"path":73,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":74,"sourceHtmlUrl":75},"references\u002Fconventions.md",7981,"https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002Freferences\u002Fconventions.md",{"path":77,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Fdomain-and-api.md",8980,"https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002Freferences\u002Fdomain-and-api.md",{"path":81,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Flibraries.md",11542,"https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002Freferences\u002Flibraries.md",{"path":85,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":86,"sourceHtmlUrl":87},"references\u002Fpage-recipes.md",10292,"https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002Freferences\u002Fpage-recipes.md",{"path":89,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":90,"sourceHtmlUrl":91},"references\u002Fpitfalls.md",8151,"https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Farms-frontend-web\u002Freferences\u002Fpitfalls.md",[93,100,107,114,121,128],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M7F343WNVHZWWYJDD77QEJ7J","voice-refine","Transform verbose voice input into structured, token-efficient Claude prompts. Use when cleaning up voice memos, dictation output, or speech-to-text transcriptions that contain filler words, repetitions, and unstructured thoughts.","https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002Freference\u002Fclaude-code-ultimate-guide-main\u002Fexamples\u002Fskills\u002Fvoice-refine\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":19},"01M7F3417SNXASFTDA1B2X4XYZ","validate-changes","Evaluate staged changes using LLM-as-a-Judge before committing","https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002Freference\u002Fclaude-code-ultimate-guide-main\u002Fexamples\u002Fskills\u002Fvalidate-changes\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":19},"01M7F33YN9QK88H2B81PVHMNG1","update-threat-db","Delegate threat-intelligence research and updates to AgentSec, then validate the guide and landing mirrors.","https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002Freference\u002Fclaude-code-ultimate-guide-main\u002Fexamples\u002Fskills\u002Fupdate-threat-db\u002FSKILL.md",[],[],{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":19},"01M7F33SXQ57G2FVFK094T4584","token-audit","Audit Claude Code configuration to measure fixed-context token overhead and produce a prioritized action plan. Use when hitting rate limits, experiencing early context compression, or after adding significant config files.","https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002Freference\u002Fclaude-code-ultimate-guide-main\u002Fexamples\u002Fskills\u002Ftoken-audit\u002Fskill.md",[],[],{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":127,"publishedAt":19},"01M7F33NAWXFPHW59CF52EAGGK","talk-stage6-revision","Produces revision sheets with quick navigation by act, a master concept-to-URL table, Q&A cheat-sheet with 6-10 anticipated questions, glossary, and external resources list. Use when preparing for a talk with Q&A, creating shareable reference material for attendees, or building a safety-net glossary for live delivery.","https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002Freference\u002Fclaude-code-ultimate-guide-main\u002Fexamples\u002Fskills\u002Ftalk-pipeline\u002Fstage-6-revision\u002FSKILL.md",[],[],{"skillNo":129,"name":130,"nameZh":6,"description":131,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":132,"categories":133,"keywords":134,"publishedAt":19},"01M7F33G9V96HVZKAGZ84J4EBR","talk-stage5-script","Produces a complete 5-act pitch with speaker notes, a slide-by-slide specification, and a ready-to-paste Kimi prompt for AI slide generation. Requires validated angle and title from Stage 4. Use when you have a confirmed talk angle and need the full script, slide spec, and AI-generated presentation prompt.","https:\u002F\u002Fgithub.com\u002F313DEVGRP\u002FJava-Service-Tree-Framework-Multi-Agent-Workspace\u002Fblob\u002Fmain\u002Freference\u002Fclaude-code-ultimate-guide-main\u002Fexamples\u002Fskills\u002Ftalk-pipeline\u002Fstage-5-script\u002FSKILL.md",[],[]]