snu-srnd

name	snu-srnd
description	서울대학교 SRnD(연구행정통합관리시스템, srnd.snu.ac.kr) 브라우저 자동화 스킬. Nexacro Platform 14 기반 UI를 javascript_tool로 제어하여 과제조회, 지출신청, 참여연구원 관리, 카드청구, 연구업적, 구매, 출장신청 등 연구행정 작업을 수행한다. TRIGGER: 사용자가 srnd.snu.ac.kr에 있거나, SRnD/연구행정을 언급하거나, 과제조회·지출신청·참여연구원·연구비·카드청구·연구업적·구매·출장신청 등 서울대 연구행정 업무를 요청할 때. DO NOT TRIGGER: 다른 대학 시스템이나 일반 웹앱을 다룰 때.

SRnD 브라우저 자동화 스킬

SRnD는 서울대학교 연구행정통합관리시스템으로 Nexacro Platform 14(TOBESOFT) 위에서 동작한다. Nexacro는 자체 JavaScript 가상 DOM으로 UI 전체를 렌더링하기 때문에 표준 DOM 검사 도구(read_page, find)는 무의미한 generic 요소만 반환한다.

핵심 원칙: 항상 javascript_tool로 Nexacro 객체 모델에 직접 접근하고, screenshot으로 시각적 확인을 병행한다.

환경 요구사항

• Claude Cowork (Claude in Chrome 확장)
• 주 상호작용 도구: javascript_tool (표준 read_page는 사용 불가)

시작 절차

스킬이 트리거되면 가장 먼저 SRnD 세션 상태를 확인한다.

1단계: 로그인 상태 확인

javascript_tool로 아래 코드를 실행하여 Nexacro 앱이 로딩되어 있는지 확인한다:

try {
  const app = nexacro.Application.mainframe.VFrameSet.TopFrame.form;
  const menuCount = app.ds_menuAllList.getRowCount();
  'LOGGED_IN:' + menuCount + ' menus';
} catch (e) {
  'NOT_LOGGED_IN';
}

2단계: 결과에 따른 분기

• LOGGED_IN 반환 → 정상. 바로 사용자의 요청을 처리한다.
• NOT_LOGGED_IN 반환 또는 오류 → 아래 절차를 수행한다:
  1. navigate 도구로 https://srnd.snu.ac.kr/에 접속한다.
  2. 사용자에게 로그인을 요청한다: "SRnD에 로그인이 필요합니다. 브라우저에서 로그인해 주세요. 완료되면 알려주세요."
  3. 사용자가 로그인 완료를 알리면 1단계를 다시 실행하여 LOGGED_IN을 확인한다.
  4. 여전히 실패하면 페이지 로딩이 덜 된 것일 수 있으므로 3초 대기 후 재시도한다.

기본 규칙

1. read_page 사용 금지 — Nexacro 콘텐츠에는 무효하다. javascript_tool만 사용.
2. 비동기 대기 필수 — fn_search()나 탭 전환 후 2–3초 대기 후 데이터셋 읽기.
3. 날짜 형식은 YYYYMMDD — 예: '20250401' (2025-04-01).
4. 백엔드 API 직접 호출 금지 — Nexacro의 fn_search(), fn_save(), transaction()을 통해서만 호출. 세션 토큰·직렬화·에러 처리를 자동으로 해준다.
5. Audit Trail 필수 — 아래 "Audit Trail" 섹션의 규칙을 따른다.
6. 자가 학습 — 기존 참조 파일에 없는 경로를 탐색해서 작업에 성공하면, 알아낸 내용을 참조 파일에 반영한다. 아래 "자가 학습" 섹션 참조.

Audit Trail

SRnD에서 수행하는 의미 있는 작업은 모두 HTML 파일에 기록한다. 사용자가 나중에 무엇이 수행되었는지 확인할 수 있도록 하기 위함이다.

기록 대상

기록하는 작업 (서버 요청을 수반하거나 side effect가 있는 것):

• 페이지 이동 (fn_OpenMainForm)
• 조회 실행 (fn_search) — 검색 파라미터 포함
• 데이터 저장 (fn_save) — 변경 내용 요약 포함
• 행 추가/삭제 (addRow, deleteRow)
• 셀 값 변경 (setColumn) — 변경 전·후 값
• 팝업 호출 및 결과
• Excel 내보내기 (fn_exportExcel)
• 기타 transaction() 호출

기록하지 않는 작업 (읽기 전용, side effect 없음):

• 프로퍼티 단순 읽기 (getColumn, getRowCount, value 조회 등)
• 폼 구조 탐색 (discoverForm, searchMenu, listOpenPages)
• 탭 목록 조회, 컴포넌트 이름 확인 등

운영 절차

1. 세션 시작 시 scripts/audit-trail.py init을 실행하여 HTML 파일을 생성한다. 파일 경로를 세션 내내 기억한다.
2. 기록 대상 작업을 수행할 때마다 즉시 scripts/audit-trail.py log를 호출하여 기록을 추가한다. 작업 후가 아니라 작업과 동시에 기록하는 것이 원칙이다.
3. 작업 완료 또는 중단 시 scripts/audit-trail.py finalize를 호출하고, HTML 파일 링크를 사용자에게 제공한다.

사용법:

# 1. 초기화 — HTML 파일 생성, 경로 출력
python3 <skill-path>/scripts/audit-trail.py init \
  --output /sessions/eager-inspiring-bardeen/mnt/srnd/audit-trail-YYYYMMDD-HHMMSS.html

# 2. 항목 추가 — 작업을 수행할 때마다 호출
python3 <skill-path>/scripts/audit-trail.py log \
  --file <audit-html-path> \
  --action "fn_search" \
  --category "조회" \
  --page "과제조회(연구자용) [1300020000]" \
  --detail "PROG_ST_FG=RM04900004, FR_DT=20240101, TO_DT=20261231" \
  --result "성공: 15건 조회"

# 3. 종료 — 완료 표시 추가, 최종 경로 출력
python3 <skill-path>/scripts/audit-trail.py finalize \
  --file <audit-html-path>

기록 항목별 가이드

작업	category	detail에 포함할 내용
페이지 이동	네비게이션	메뉴명, 메뉴 ID
조회	조회	검색 파라미터 (키=값 나열)
저장	저장	변경된 필드와 값 요약
행 추가	데이터변경	추가된 행의 주요 필드
행 삭제	데이터변경	삭제된 행 식별 정보
셀 수정	데이터변경	필드명, 변경 전→후 값
Excel 내보내기	내보내기	그리드명, 행 수
팝업	팝업	팝업 ID, 파라미터, 반환값

프레임 계층 구조

SRnD 전체가 nexacro.Application 안에 있다:

nexacro.Application.mainframe.VFrameSet
├── TopFrame.form                          ← 상단 바, 전역 데이터
│   ├── ds_menuAllList                     ← 전체 264개 메뉴
│   ├── ds_topMenu                         ← 10개 최상위 카테고리
│   ├── fn_AddTabPage(menuId, params)      ← 새 탭으로 페이지 열기
│   └── fn_SetTab(menuId)                  ← 기존 탭으로 전환
├── HFrameSet
│   ├── LeftFrame.form                     ← 좌측 메뉴 패널
│   │   └── fn_OpenMainForm(menuId)        ← 페이지 네비게이션
│   └── VFrameSet
│       ├── TabFrame.form.tab_openMenu     ← 탭 바
│       └── FrameSet                       ← ★ 콘텐츠 영역 ★
│           └── [MENU_ID]                  ← 열린 페이지 (메뉴 ID가 키)
│               └── .form.div_workForm     ← 실제 작업 폼

콘텐츠 영역 접근 패턴:

const fs = nexacro.Application.mainframe.VFrameSet.HFrameSet.VFrameSet.FrameSet;
const workDiv = fs['{MENU_ID}'].form.div_workForm;

scripts/srnd-helpers.js의 getFrameSet()과 getWorkDiv(menuId)를 사용하면 더 간결하게 접근할 수 있다.

폼 공통 구조

264개 페이지 모두 div_workForm 안에서 동일한 패턴을 따른다:

컴포넌트	용도
ds_search	검색 파라미터 (1행, 검색 전 설정)
ds_main	메인 결과 데이터 (검색 후 채워짐)
grd_main	그리드 (ds_main에 바인딩)
fn_search()	검색 실행 (ds_search → API → ds_main)
fn_save()	저장 실행
fn_callBack(svc, errCd, errMsg)	트랜잭션 결과 핸들러
fn_exportExcel()	현재 그리드를 Excel로 내보내기

상세 패널 (우측 탭)

대부분의 폼에는 우측 상세 패널이 있다:

workDiv
└── div_right (또는 div_detail)
    └── Tab00
        ├── tabpage1  "협약정보"
        ├── tabpage2  "실행예산"
        ├── tabpage9  "참여연구원"
        │   └── div_rech              ← 중첩 Div, 자체 서브폼 로드
        │       └── ds_paticpRecher   ← 실제 연구원 데이터 (70 컬럼)
        ├── tabpage5  "입금내역"
        └── ...

탭 데이터는 지연 로딩된다. tab.set_tabindex(N) 호출 후 반드시 대기해야 한다:

const tab = workDiv.div_right.Tab00;
// 탭 목록 확인:
tab.tabpages.forEach((pg, i) => console.log(i, pg.text));
// 탭 전환:
tab.set_tabindex(2);
// 2–3초 대기 후 탭 내부 데이터 접근:
const subDiv = tab.tabpages[2].all[N]; // .url 속성을 가진 Div

컴포넌트 네이밍 규칙

접두사	타입	비고
ds_	Dataset	데이터 컨테이너 (비표시)
grd_	Grid	.binddataset으로 Dataset에 바인딩
div_	Div	컨테이너; .url로 서브폼 로드 가능
btn_	Button	.onclick 핸들러
edt_	Edit	단일 행 텍스트 입력
cmb_	Combo	드롭다운. .value=코드, .text=표시값
cal_	Calendar	날짜 선택기
tab_	Tab	.tabpages[]로 탭 페이지 접근
stc_ / Static	Static	라벨·장식 요소

레시피

페이지 이동

const leftForm = nexacro.Application.mainframe.VFrameSet.HFrameSet.LeftFrame.form;
leftForm.fn_OpenMainForm('1300020000'); // 과제조회(연구자용)
// 2–3초 대기

검색 실행

const workDiv = getWorkDiv('1300020000'); // srnd-helpers.js
workDiv.ds_search.setColumn(0, 'PROG_ST_FG', 'RM04900004'); // 진행
workDiv.ds_search.setColumn(0, 'FR_DT', '20240101');
workDiv.ds_search.setColumn(0, 'TO_DT', '20261231');
workDiv.fn_search();
// 2–3초 대기 후 ds_main 읽기

데이터셋 전체 읽기

scripts/srnd-helpers.js의 readDataset(ds) 함수를 사용:

const rows = readDataset(workDiv.ds_main);

그리드 행 선택 (상세 로딩)

workDiv.ds_main.set_rowposition(rowIndex);
// onrowposchanged 트리거 → 상세 패널 갱신. 2초 대기.

알 수 없는 폼 탐색

scripts/srnd-helpers.js의 discoverForm(menuId) 함수를 사용:

const info = discoverForm(menuId);
// info.datasets: [{name, rows}, ...]
// info.fns: ['fn_search', 'fn_save', ...]
// info.tabs: [{index, text}, ...]

메뉴 검색

scripts/srnd-helpers.js의 searchMenu(keyword) 함수를 사용:

const results = searchMenu('과제');
// [{menuId, menuNm, pgmId}, ...]

자가 학습

MENU-TREE.md와 INTENT-MAP.md는 자주 쓰이는 경로만 담고 있어서, 사용자의 요청이 기존에 매핑되지 않은 메뉴나 작업을 필요로 할 수 있다. 이때 탐색을 통해 방법을 알아냈다면, 그 지식을 참조 파일에 기록하여 다음번에는 탐색 없이 바로 수행할 수 있도록 한다.

트리거 조건

다음 중 하나라도 해당하면 자가 학습을 수행한다:

• searchMenu()로 메뉴를 찾았는데 MENU-TREE.md에 해당 항목이 없을 때
• discoverForm()으로 폼 구조를 탐색하여 작업을 완료했을 때
• INTENT-MAP.md에 매핑이 없는 사용자 요청을 시행착오를 거쳐 성공했을 때
• 기존 매핑의 데이터 경로가 실제와 다른 것을 발견했을 때

업데이트 절차

1. 작업을 먼저 완료한다. 참조 파일 업데이트는 사용자의 요청을 처리한 뒤에 한다.
2. 알아낸 내용을 정리한다. 최소한 다음을 확인한다:
   • 메뉴 ID, 메뉴명, PGM_ID
   • 해당 폼의 주요 Dataset 이름과 용도
   • 검색 파라미터 (ds_search의 컬럼명과 유효 값)
   • 탭 구조가 있으면 탭 인덱스와 이름
   • 작업을 완료하기 위해 호출한 함수 순서
3. 참조 파일을 업데이트한다:
   • MENU-TREE.md — 새 메뉴 항목을 해당 모듈 섹션에 추가한다. 형식: - [MENU_ID] 메뉴명 (PGM_ID)
   • INTENT-MAP.md — 사용자 요청 → 메뉴 ID → 데이터 경로 매핑을 추가한다. 기존 카테고리에 맞으면 해당 테이블에 행을 추가하고, 새 카테고리가 필요하면 섹션을 만든다. 복합 작업이었으면 "복합 작업 패턴" 섹션에 단계별 절차를 추가한다.
4. Audit Trail에 기록한다. category 자가학습, action update-references, detail에 어떤 파일에 무엇을 추가했는지 기술한다.

주의사항

• 한 번 성공한 것만 기록한다. 시행착오 중 실패한 경로는 기록하지 않는다.
• 기존 매핑과 충돌하면 실제 동작을 기준으로 기존 내용을 수정한다.
• 업데이트 후 사용자에게 "새로 알아낸 경로를 스킬에 반영했습니다"라고 알린다.

자주 발생하는 문제

• div_workForm.form이 undefined: Nexacro 14에서는 정상이다. div_workForm에서 직접 자식 컴포넌트에 접근한다 (예: workDiv.ds_main).
• 탭 전환 후 데이터셋이 비어있음: 대기 시간이 부족하다. set_tabindex() 후 3초 대기.
• 프레임이 사라짐: 사용자가 탭을 닫은 경우. fn_OpenMainForm(menuId)로 재이동.
• Combo 값 설정: cmb.set_value('CODE'). 옵션 목록은 workDiv[cmb.innerdataset].
• 팝업: Nexacro 팝업은 브라우저 창이 아닌 오버레이 div이다. screenshot으로 확인. 반환값은 fn_popupAfter()를 통해 전달된다.

참조 파일

• references/MENU-TREE.md — 264개 전체 메뉴 계층 (메뉴 ID, 프로그램 ID 포함)
• references/DATASET-API.md — Dataset 읽기/쓰기 API, Grid 상호작용
• references/INTENT-MAP.md — 한국어 사용자 요청 → 네비게이션 경로·데이터셋 위치 매핑
• scripts/srnd-helpers.js — 공통 헬퍼 함수 (getWorkDiv, readDataset, discoverForm, searchMenu)
• scripts/audit-trail.py — Audit Trail HTML 생성·기록·종료 스크립트