사용법

설치를 마쳤다면 이제 로그인하고, 프로젝트 폴더를 열어 첫 작업을 시작합니다. 이 문서는 전자정부프레임워크 공통 컴포넌트 프로젝트(egovframe-common-components)를 예로 설명합니다.

로그인하기

앱을 처음 열면 로그인이 필요합니다. 로그인은 브라우저(로그인 창)에서 진행됩니다.

계정이 없으면 회원가입 후 관리자 승인을 기다립니다. 승인 전에는 로그인이 거부되고, 승인된 뒤부터 로그인할 수 있습니다.

프로젝트 선택에서 작업할 로컬 폴더를 지정합니다. 예제 프로젝트는 공식 저장소를 원하는 폴더에 clone해서 사용합니다.

git clone https://github.com/eGovFramework/egovframe-common-components.git

폴더를 선택하면 왼쪽에 파일 트리가 나타납니다. Pulse는 선택한 폴더 안에서만 파일을 읽고, 변경이 필요하면 diff 승인 화면을 먼저 보여줍니다. 프로젝트를 선택하지 않으면 작업 컨텍스트가 비어 있습니다.

수정 없이 프로젝트를 이해할 때는 그냥 물어봅니다. 파일을 읽고 검색해 실제 경로·클래스명을 근거로 답하며, 파일은 바뀌지 않습니다.

이 프로젝트가 어떤 구조인지 간단히 설명해줘. 어떤 기능 모듈들이 있어?
게시판(공지사항) 기능은 어디에 구현돼 있어? 컨트롤러·서비스·DAO·JSP 경로 알려줘
로그인 처리 흐름을 설명해줘. 세션은 어떻게 관리돼?

화면 한두 곳을 고치는 작은 요청은 대화로 바로 맡깁니다. 에이전트가 변경 계획을 세우고 diff를 보여주면, 승인해야 반영됩니다.

공지사항 목록 화면에서 첨부파일 있는 글은 제목 옆에 표시가 나오게 해줘.
게시판 목록에서 조회수가 100 넘는 글은 조회수를 굵게 표시해줘.

여러 파일에 걸친 넓은 작업은 팀 모드로 맡기면 구현 → 테스트 → 보안 → 정리 순으로 역할을 나눠 진행합니다. 발화 앞에 팀으로 진행해줘 — 를 붙입니다.

팀으로 진행해줘 — 게시판 목록에 조회수 순 정렬 옵션을 추가하는 작업이야.
화면에서 정렬을 선택하면 목록이 그 순서로 나와야 해.

각 단계 결과는 공유되며, 파일을 바꾸는 변경은 마찬가지로 승인 후에만 반영됩니다.

취약점 점검을 지시하면 대상 코드를 스캔해 위치(파일·라인)와 함께 보고합니다. 이어서 최소 수정까지 연결할 수 있습니다.

파일 업로드 처리하는 코드에 보안 취약점 있는지 점검해줘. SQL 인젝션이랑 경로 조작 위주로.
게시판 검색 기능에 SQL 인젝션 가능성이 있는지 점검해줘.

점검만 하고 싶으면 "수정은 하지 말고 정리만 해줘"처럼 범위를 지정합니다.

작업한 변경은 대화로 커밋할 수 있습니다. 커밋에도 승인 절차가 있고, 메시지는 한글로 정리됩니다.

지금까지 작업한 거 요구사항별로 나눠서 커밋해줘. 커밋 메시지는 한글로.
JSP 바꾼 것만 먼저 커밋해줘. 나머지는 아직 검토 중이라 커밋하면 안 돼.

요구사항 단위로 커밋이 나뉘고, 지정한 범위만 커밋되고 나머지는 그대로 남습니다.

고객이 말을 바꾸면 "아까 한 거"만 짚어 다시 요청합니다. 에이전트가 이전에 바꾼 위치를 찾아 그 부분만 수정하거나 되돌립니다.

아까 아침에 했던 첨부파일 표시 있잖아, 고객이 아이콘 말고 '[첨부]' 텍스트로 바꿔달래.
미안한데 아까 한 그 기능 고객이 그냥 빼달래. 원래대로 되돌려줘.

되돌린 뒤에는 diff로 실제 원복 여부를 확인할 수 있습니다.

하루 작업을 마치면 세션 전체를 요약해 보고서로 정리하고, 파일로 저장할 수 있습니다. 파일 저장에도 승인 절차가 적용됩니다.

오늘 작업 전체를 팀장한테 보고할 수 있게 정리해줘 — 요구사항별로 뭘 어떻게 바꿨고, 어떤 파일 건드렸고, 남은 이슈까지.
그 내용 markdown 파일로 프로젝트 루트에 작업보고-YYYYMMDD.md 로 저장해줘.

고객용(비개발자) 요약이나 인수인계 메모처럼 관점을 바꿔 다시 정리해달라고 할 수도 있습니다.

관리자는 중앙 콘솔(설정)에서 조직 기준과 사용 권한을 통제합니다. 개발자는 로컬에서 코드를 다루고, 관리자는 아래 항목을 준비·점검합니다.

가입 요청을 승인하고, 사용자를 그룹에 배정합니다. 그룹별로 권한과 사용 가능한 모델이 달라집니다.

조직이 허용하는 모델 endpoint와 API 키를 등록합니다. 사용자는 모델 이름만 선택하고, 키와 endpoint는 볼 수 없습니다.

에이전트가 매 작업 전에 참고하는 조직 개발 규칙을 마크다운으로 작성합니다(코딩 표준, 보안 규칙 등).

특정 그룹에만 적용되는 개발 규칙을 작성합니다. 시스템 지침에 더해 그룹별 세부 규칙을 얹을 때 사용합니다.

보안 규칙, 코딩 컨벤션, 프로젝트 용어집 같은 조직 표준 문서를 등록해 분석·수정 시 참고하게 합니다.

위험 명령과 파일 접근 규칙을 정합니다. 도구 실행 전에 허용·승인 요청·차단 중 하나로 분류됩니다.

누가 어떤 프로젝트에서 무엇을 요청했고 어떤 변경을 승인했는지 작업 단위로 추적합니다. 각 작업의 감사 로그는 HMAC 체인으로 서명되며, 목록의 체인 열에서 위변조 여부(무결·봉인)를 확인할 수 있습니다.

프로젝트의 보안 취약점을 스캔해 위치와 심각도로 정리합니다.

사용 중인 오픈소스 라이브러리의 위험·라이선스 이슈를 점검합니다.