루마닉 참모
요구사항정의서

요구사항 번호

수용 기준은 시험으로 확인할 수 있는 문장으로 기술함. 요구사항별 화면·시험은 5부 추적표에 정리함.

쪽 이동은 마우스 휠, 좌우 화살표, 하단 막대의 부 이름, 상단 목차로 가능함.

부대에 사안이 생기면 간부는 짧은 시간 안에 사실을 수집하고 관련자를 가려야 함. 방책(지휘관이 고를 수 있는 행동 방안)을 몇 가지 비교한 뒤에는 보고 문서까지 작성함. 참모는 이 과정에서 생기기 쉬운 빈틈 세 가지를 방지함.

• 확인하지 않은 말이 사실로 굳어지는 문제

  브리프 칸에는 간부의 말이나 자료 원문을 글자 그대로 옮긴 인용이 있어야 값을 반영함.

• 무엇을 모른 채 결심했는지 남지 않는 문제

  원문을 인용하지 못한 칸은 ‘미확인’으로 남김. 이 칸은 판단 보고서의 한 줄 요약 바로 뒤에 기재하고, 결심 기록의 ‘그때 확인하지 못한 것’에 미리 입력함.

• 결심의 결과가 기록되지 않는 문제

  결심에 다시 볼 날을 정해 두고 결과를 기록하면, 같은 유형의 결심 시 선례로 먼저 제시됨.

• 책임 간부 commander

  결심 기록, 문서 승인, 구성원 관리를 담당함. 업무 공간마다 한 명 이상 필요함.

• 함께 쓰는 간부 staff_officer

  대화·자료·방책·조치 계획·문서 초안을 다룸. 결심과 승인은 하지 않음.

• 현장 간부 field

  현장 보고를 올림. 본인이 올린 보고와 승인된 조치 카드만 조회함.

• 운영자

  PoC 관리자 계정으로 가입 신청을 승인 또는 반려함. 승인한 업무 공간의 구성원이 되지는 않음.

마지막 남은 책임 간부는 스스로 나갈 수 없고, 권한을 낮추거나 내보낼 수도 없음.

업무 공간은 간부가 자기 부대 업무를 다루는 공간임. 어느 간부든 만들 수 있으며, 업무 공간끼리는 서로 보이지 않음.

• 초대와 수락

  책임 간부가 서비스ID로 초대하고, 초대받은 간부가 수락해야 구성원이 됨. 용사 계정은 초대할 수 없음.

• 계정당 업무 공간 하나

  다른 업무 공간에 속한 간부는 그곳에서 먼저 나와야 초대를 수락할 수 있음.

• 나가기와 내보내기

  스스로 나가거나 책임 간부가 내보냄. 이때 권한만 회수하고, 그동안 남긴 대화와 결심 기록은 업무 공간에 그대로 유지됨.

• 마지막 책임 간부

  책임 간부가 한 명뿐이면 그 간부는 나갈 수 없고, 내보내거나 권한을 낮출 수도 없음.

경계

• 설정으로 켜고 끄기

  참모 모듈은 설정으로 활성화함. 꺼 두면 참모 API는 404를 반환하고, 참모 DB 파일도 생성하지 않음.

• 용사 원문과 분리

  참모 코드에서는 용사 상담·인터뷰·리포트 코드를 불러올 수 없음. 불러오기 자체를 시험으로 차단함.

• AI 프로세스 격리

  프롬프트는 명령줄 대신 표준 입력으로 전달하고, 앱 비밀이 든 환경 변수는 물려주지 않음.

• 실패를 그대로 알리기

  AI가 두 번 모두 형식을 맞추지 못하거나 제한 시간을 넘기면 오류로 알림. 시험용 고정 응답은 실사용 환경에서 켤 수 없음.

정할 일이 있는 간부는 누구나 로그인 없이 신청함. 입력 항목은 계급·직책·부대 이름·제대 네 가지이며, 운영자에게 남길 말은 선택임. 승인되면 받아 둔 가입 코드로 비밀번호를 설정함.

수용 기준

1. FR-01-1신청 시 12자리 가입 코드를 한 번만 표시하고, 서버에는 그 해시만 남겨야 함.
2. FR-01-2가입 코드로 상태를 조회하면 승인 건은 서비스ID를, 반려 건은 사유를 표시해야 함.
3. FR-01-3승인 전에는 가입 코드로 비밀번호를 정할 수 없고, 없는 코드로 조회하면 401로 응답해야 함.
4. FR-01-4틀린 코드로 조회하는 횟수와 신청 건수는 접속 주소별로 제한해야 함.

화면

signup.html

사용자

참모를 처음 쓰는 간부(로그인 전)

시험

tests/command/15-officer-baseline.test.mjs
tests/command/21-journey.test.mjs

운영자는 용사 PoC 관리자 계정으로 가입 신청 화면을 열어 신청을 상태별로 검토하고 승인 또는 반려함. 계정은 PoC 관리자 화면과 같은 절차로 생성하고, 신청 때 받은 가입 코드를 그대로 초대코드로 사용함.

수용 기준

1. FR-02-1신청 목록 조회와 승인·반려는 운영자만 수행하고, 다른 계정은 403으로 차단해야 함.
2. FR-02-2승인 시 계정·업무 공간·책임 간부 권한과 계급·직책 칸이 한꺼번에 생성되어야 함.
3. FR-02-3승인 대기가 아닌 신청은 다시 승인하거나 반려할 수 없어야 함.
4. FR-02-4추가 인증을 꺼도 운영자는 추가 인증을 마친 세션에서만 신청 조회·승인이 가능해야 함.

화면

signups.html

사용자

운영자

시험

tests/command/15-officer-baseline.test.mjs
tests/command/26-mfa-off.test.mjs

신청 상태

서비스ID와 비밀번호를 확인한 뒤 인증 앱에 뜬 6자리 번호로 추가 인증을 함. 인증 앱은 최초 1회만 등록함. 이용 안내까지 확인하면 업무현황 화면으로 이동함.

수용 기준

1. FR-03-1추가 인증이 켜져 있으면 인증 앱을 등록하지 않은 구성원의 참모 API 호출을 403으로 차단해야 함.
2. FR-03-2추가 인증이 켜져 있으면 인증한 지 15분이 지난 세션에서는 결심 기록·문서 승인·구성원 변경 전에 인증 코드를 재확인해야 함.
3. FR-03-3추가 인증을 끄면 참모 계정은 로그인만으로 진입하고, 면제한 로그인은 감사 기록에 남겨야 함.
4. FR-03-4추가 인증을 꺼도 운영자와 참모 외 계정은 추가 인증을 거쳐야 함. 설정 하나로 다시 켤 수 있어야 함.

화면

login.html

사용자

참모 계정 모두, 운영자

시험

tests/command/26-mfa-off.test.mjs
tests/command/24-shell-dialogs.test.mjs

용사 PoC의 상담자·관리자처럼 계정은 있으나 참모 권한이 없는 간부는 로그인 상태에서 업무 공간을 개설함. 계급·직책·부대 이름·제대를 입력하면 바로 쓸 수 있음. 받은 초대가 있으면 양식보다 먼저 표시함.

수용 기준

1. FR-04-1개설 시 업무 공간, 책임 간부 권한, 계급·직책 칸을 한 번에 생성해야 함.
2. FR-04-2이미 업무 공간에 속한 계정의 새 공간 개설은 차단해야 함(409).
3. FR-04-3업무 공간끼리는 서로 보이지 않고, 공간 이름·제대 수정은 그 공간의 책임 간부만 가능해야 함.
4. FR-04-4참모 권한이 없는 계정이 참모 화면을 열면 업무 공간 만들기 화면으로 이동해야 함.

화면

start.html

사용자

참모 권한이 없는 간부 계정

시험

tests/command/15-officer-baseline.test.mjs

업무 공간에 들어가는 세 가지 경로

만들 때 함께 생기는 것

1. 업무 공간부대 이름·제대를 입력해 생성함. 부대 이름이 같은 공간이 여럿일 수 있어 공간 코드는 서버에서 무작위로 부여함.
2. 책임 간부 권한만든 간부가 그 공간의 첫 책임 간부가 됨.
3. 계급·직책 칸입력한 계급·직책으로 기준정보의 해당 칸을 채움.

책임 간부는 서비스ID로 간부를 초대하면서 권한(책임 간부·함께 쓰는 간부·현장 간부)과 직책을 지정함. 추가 인증이 켜져 있으면 인증한 지 15분이 지난 세션에서는 부르기·권한 바꾸기·내보내기·나가기 전에 인증 코드를 재확인함.

수용 기준

1. FR-05-1이 업무 공간에 없는 간부를 부르면 초대만 남기고, 본인이 받아들인 뒤에만 구성원이 되어야 함.
2. FR-05-2한 계정은 한 업무 공간에만 속하고, 용사 계정 초대는 차단해야 함.
3. FR-05-3마지막 남은 책임 간부는 내보내거나 강등할 수 없고, 본인도 스스로 나갈 수 없어야 함.
4. FR-05-4내보낸 간부는 다음 요청부터 그 공간을 쓸 수 없고, 계정과 남긴 기록은 유지해야 함.

화면

members.html start.html

사용자

책임 간부(부르기·권한), 구성원 모두(보기·나가기)

시험

tests/command/18-members.test.mjs

기준정보는 간부 5칸과 부대 7칸, 모두 12칸임. 간부 칸은 본인만 수정함. 값은 간부가 직접 적거나 자료실 문서의 문장을 인용해 넣음. AI는 간부가 고른 문서로 칸별 초안만 작성하고 칸을 직접 채우지 않음.

수용 기준

1. FR-06-1부대 칸은 책임 간부·함께 쓰는 간부만 수정하고, 현장 간부의 수정은 403으로 차단해야 함.
2. FR-06-2새 대화를 열면 채운 칸을 그 대화의 자료로 먼저 넣고, 그 뒤 기준정보가 바뀌면 변경 사실을 알려야 함.
3. FR-06-3간부가 칸마다 ‘기준정보에 넣기’를 누르기 전에는 AI 초안을 반영하지 않아야 함.
4. FR-06-4원문에 없는 인용이나 인용에 없는 숫자가 든 초안은 서버에서 버리고 그 개수를 알려야 함.

화면

baseline.html

사용자

구성원 모두(부대 칸과 초안 받기는 책임 간부·함께 쓰는 간부)

시험

tests/command/15-officer-baseline.test.mjs
tests/command/16-baseline-draft.test.mjs

업무 공간의 문서를 규정·지침·현황·일정·기타 다섯 종류로 나눠 보관함. 파일에서 글자만 뽑아 저장하고 원본 파일은 남기지 않음. 자료를 넣기 전에 비밀로 분류된 내용이 없음을 확인받음.

수용 기준

1. FR-07-1구형 HWP·오피스 파일, 그림, 압축 파일, 글자 없는 PDF는 받지 않고 사유를 알려야 함.
2. FR-07-2자료 넣기·내리기는 책임 간부·함께 쓰는 간부만 가능하고, 현장 간부는 403으로 차단해야 함.
3. FR-07-3한 문서는 한 대화에 한 번만 들어가고, 목록에서 내려도 이미 넣은 대화의 사본은 남아야 함.
4. FR-07-4파일은 로그인한 뒤 나눠 올리고, 다 올라가기 전에는 자료로 쓰지 않아야 함.

화면

library.html

사용자

책임 간부·함께 쓰는 간부(현장 간부는 보기만)

시험

tests/command/05-extract.test.mjs
tests/command/15-officer-baseline.test.mjs

간부가 평소 말투로 입력하면 참모는 질문이나 답이 필요한 말에 먼저 답함. 이어서 서버에서 정한 빈칸 하나를 질문함. 첫 말을 보내면 대화가 열리고, 대화 제목은 그 말의 첫 문장에서 추출함.

수용 기준

1. FR-08-1간부의 말은 AI 호출 전에 저장하고, 답을 받지 못한 말을 다시 보내도 한 번만 남겨야 함.
2. FR-08-2필수 칸이 남아 있으면 질문 없는 턴을 받지 않고, 서버에서 허용한 칸만 물어야 함.
3. FR-08-3지휘관의 결심을 대신하거나 할 일을 시키는 답, 금지어가 든 답은 받지 않아야 함.
4. FR-08-4두 번 호출해도 검사를 통과한 답이 없으면 고정 문장으로 채우지 않고 오류를 알려야 함.

화면

desk.html

사용자

책임 간부, 함께 쓰는 간부

시험

tests/command/27-answer-suggest.test.mjs
tests/command/29-turn-key-retry.test.mjs

브리프 10칸 중 9칸은 필수임. 확인된 칸과 어긋나는 내용은 칸을 덮지 않고 제안으로 등록함.

수용 기준

1. FR-09-1인용이 없거나 인용에 없는 숫자를 쓴 값은 칸에 넣지 않고 까닭을 알려야 함.
2. FR-09-2간부가 ‘브리프에 넣기’를 누르기 전에는 제안을 칸에 넣지 않아야 함.
3. FR-09-3넣은 제안은 ‘브리프에 넣음’ 상태의 확인된 칸이 되고, 출처는 ‘참모 제안에서 넣음’으로 기록해야 함.
4. FR-09-4차원별로 칸 수만 세고, 비율이나 점수로 바꾸지 않아야 함.
5. FR-09-5방금 물은 칸에 모른다고 답하면 다시 묻지 않고, 보고서에 확인하지 못한 칸으로 남겨야 함.

화면

desk.html 오른쪽 곁패널

사용자

책임 간부, 함께 쓰는 간부

시험

tests/command/06-evidence.test.mjs
tests/command/07-interview.test.mjs
tests/command/33-brief-v2.test.mjs

참모는 답과 질문 아래에 지금 쓸 만한 도구를 두 개까지 추천함. 추천은 건의이므로 잘못된 항목이 섞여도 AI를 다시 부르지 않고 그 항목만 제외함.

수용 기준

1. FR-10-1추천 도구는 방책 비교·조치 계획·문서·결심 기록 넷이며, 한 턴에 두 개 이하여야 함.
2. FR-10-2까닭이 1~80자를 벗어나거나, 결심을 대신하는 말투·지시 말투·금지어가 든 항목은 제외해야 함.
3. FR-10-3같은 도구를 두 번 권하면 뒤의 것을, 맥락 전환 확인 턴에서는 추천을 모두 제외해야 함.
4. FR-10-4화면에는 가장 최근 참모 턴의 추천만 보이고, 잠긴 도구 자리에는 링크 대신 까닭을 적어야 함.

화면

desk.html

사용자

책임 간부, 함께 쓰는 간부

시험

tests/command/27-answer-suggest.test.mjs

브리프에 확인된 칸이 하나라도 있으면 참모가 서로 다른 방책을 두세 개 작성함. 방책마다 기준 일곱 가지를 유리·엇갈림·불리·미확인으로 판정해 나란히 배치함. 재작성 시 이전 방책은 새 방책으로 대체됨.

수용 기준

1. FR-11-1방책은 2~3개이고, 방책마다 기준 7개를 빠짐없이 채운 출력만 받아야 함.
2. FR-11-2판정은 네 가지뿐이며, 총점·가중치를 매기거나 방책을 줄 세우지 않아야 함.
3. FR-11-3미확인이 아닌 판정은 원문 인용과 대조하고, 인용을 대지 못하면 미확인으로 되돌려야 함.
4. FR-11-4‘가장 나은 방책’처럼 지휘관 대신 고르는 문장이 든 출력은 받지 않아야 함.

화면

coa.html

사용자

책임 간부, 함께 쓰는 간부

시험

tests/command/08-coa.test.mjs

네 가지 물음에 답하면 개입 방식 12가지 중 후보를 규칙으로 추리고, 그중 하나를 지휘관이 선택함. 답과 고른 방식은 책임 간부나 함께 쓰는 간부가 화면에 입력함. 참모는 고른 방식에 맞춰 누가·언제까지·무엇을 할지 초안을 쓰고, 승인은 책임 간부만 함.

수용 기준

1. FR-12-1방식을 고르는 동안에는 AI를 부르지 않고, 후보 밖의 방식은 받지 않아야 함.
2. FR-12-2‘누가’는 역할 8가지, ‘언제까지’는 기한 7가지에서만 고르고, 날짜를 적은 조치는 제외해야 함.
3. FR-12-3조치마다 확인된 브리프 칸을 근거로 달고, 징계·인사 조치를 적은 계획은 받지 않아야 함.
4. FR-12-4승인은 책임 간부만 하고, 마침 표시는 승인된 최신 판에만 붙이며 개정판으로 옮기지 않아야 함.

화면

plan.html, 승인은 documents.html

사용자

책임 간부, 함께 쓰는 간부(승인은 책임 간부)

시험

tests/command/11-plan.test.mjs
tests/command/25-action-marks.test.mjs

판단 보고서는 브리프와 방책 비교를 한 편으로 묶어 지휘 계통에 올리는 문서임. 대조를 마친 사실을 참모가 다시 쓰면 원문과 어긋날 수 있으므로, 참모는 한 줄 요약과 ‘따져야 할 것’만 작성함.

수용 기준

1. FR-13-1확인하지 못한 칸 목록은 요약 바로 뒤, 사실 절보다 앞에 실어야 함.
2. FR-13-2따져야 할 것은 2~5개이며, 원문 인용과 대조하지 못한 항목은 싣지 않아야 함.
3. FR-13-3방책 작성 후 브리프가 바뀌면 방책 비교 절에 그 사실을 기재해야 함.
4. FR-13-4생성 시점의 브리프 기준 시각과 지문을 싣고, 재생성 시 개정판으로 남겨야 함.

화면

documents.html

사용자

책임 간부, 함께 쓰는 간부(승인은 책임 간부)

시험

tests/command/09-judgment.test.mjs

같은 브리프로 상급 보고문·지휘서신·부대 공지문을 쓰고, PDF와 한글(HWPX) 파일로 내려받음. 지휘서신과 공지문은 부대원이 읽으므로 가릴 사람을 확인함.

수용 기준

1. FR-14-1부대원 대상 문서에서는 성 뒤에 계급·직책이 붙은 표현이 든 칸을 제외하고 그 사실을 기재해야 함.
2. FR-14-2지휘서신에는 지휘관이 맡은 조치만, 공지문에는 당사자·분대장·소대장 조치만 실어야 함.
3. FR-14-3참모가 쓴 칸이 모두 걸러지면 문서를 생성하지 않아야 함.
4. FR-14-4화면 미리보기·PDF·한글 파일은 같은 데이터로 만들고, 내보낼 때마다 기록해야 함.
5. FR-14-5지휘서신·공지문을 만들 때마다 가릴 사람을 확인하고, ‘당사자는 싣지 않음’을 기본값으로 선택해 두어야 함.

화면

documents.html

사용자

책임 간부, 함께 쓰는 간부(승인은 책임 간부)

시험

tests/command/12-derived.test.mjs
tests/command/33-brief-v2.test.mjs

결심은 지휘관이 하고, 기록은 책임 간부 권한으로 남김. 무엇을 왜 정했는지, 그때 확인하지 못한 것, 언제 다시 볼지를 기록함. 다시 볼 날이 지나면 업무현황에서 결과 입력을 요청함. 이 기능에서는 AI를 호출하지 않음.

수용 기준

1. FR-15-1결심은 책임 간부만 남기고, 확인된 칸이 없어도 받아야 함.
2. FR-15-2‘그때 확인하지 못한 것’을 비워 두면 기록 시 브리프의 미확인 칸으로 채워야 함.
3. FR-15-3다시 볼 날은 정해 둔 기간 다섯 가지에서 고르고, 결과는 네 갈래로만 기록해야 함.
4. FR-15-4선례는 다른 대화의 같은 유형 결심을 결과가 적힌 것부터 다섯 건까지 표시해야 함.

화면

decisions.html

사용자

책임 간부(결심·결과), 함께 쓰는 간부(결과)

시험

tests/command/14-decisions.test.mjs

로그인 후 가장 먼저 보는 화면임. 서버에서 고른 할 일 하나, 대화를 상태별로 센 네 칸 띠, 진행 중인 대화, 기준정보·자료실 요약을 한 화면에 표시함.

수용 기준

1. FR-16-1맨 위 할 일은 서버에서 하나만 고르며, 다시 볼 날이 지난 결심, 비어 있는 기준정보, 진행 중인 대화 순서로 정해야 함.
2. FR-16-2진행 중인 대화는 급한 것부터, 같은 급이면 최근에 손댄 것부터 정렬해야 함.
3. FR-16-3대화마다 한 것(칸·방책·계획·문서·결심)을 적고, 그 수는 서버에서 센 값을 써야 함.
4. FR-16-4현황 브리핑에는 적어 둔 기록만 모으고, 빈 칸에는 ‘적어 두지 않았습니다’로 표기해야 함.

화면

home.html

사용자

구성원 모두(현황 브리핑은 책임 간부·함께 쓰는 간부)

시험

tests/command/15-officer-baseline.test.mjs
tests/command/21-journey.test.mjs

업무 공간에서 나눈 대화를 한곳에 모음. 줄마다 유형·긴급·한 것·연 날을 적고, 줄을 누르면 그 대화로 이동함. 상태별 거르기도 가능함.

수용 기준

1. FR-17-1목록에는 같은 업무 공간의 대화만 싣고, 현장 간부에게는 자기가 올린 대화만 실어야 함.
2. FR-17-2급한 것부터, 같은 급이면 최근에 연 것부터 정렬해야 함.
3. FR-17-3업무현황 띠에서 들어오면 그 칸과 같은 판정으로 거르고, 띠의 수와 줄 수가 같아야 함.
4. FR-17-4목록은 업무현황 띠와 같은 범위인 200건까지 표시해야 함.

화면

cases.html

사용자

구성원 모두

시험

tests/command/17-field-report.test.mjs
tests/command/32-case-list-limit.test.mjs

현장 간부는 자기가 본 일을 휴대전화로 보고함. 참모와 나누는 대화는 책임 간부나 함께 쓰는 간부가 이어받음. 올린 사람은 이어받았는지, 결심했는지, 어떤 조치가 승인됐는지만 확인함.

수용 기준

1. FR-18-1제목만 있어도 보고를 받고, 본문이 짧아 자료로 쓰지 못하면 그 사실만 알려야 함.
2. FR-18-2현장 간부는 참모 대화를 열지 못하고, 브리프를 열어도 대화와 칸이 없어야 함.
3. FR-18-3조치 카드에는 승인된 최신 판의 누가·언제까지·무엇을만 싣고, 근거와 인용은 제외해야 함.
4. FR-18-4마침 표시는 올린 사람과 책임 간부·함께 쓰는 간부가 붙이고, 개정판으로 옮기지 않아야 함.

화면

field.html

사용자

현장 간부(올리기), 책임 간부·함께 쓰는 간부(이어받기)

시험

tests/command/17-field-report.test.mjs
tests/command/22-field-actions.test.mjs

다중 항목 확률 판정 기술을 기반으로 루만 체계이론의 세 의미 차원(사실·사회·시간)을 확률적으로 판정함. 이번 PoC에서는 이 기술을 제공하는 외부 판정 API를 사용함(구조는 2.11절, 루만 이론 대응은 2.12절). 결과는 브리프 칸의 근거·제안과 미확인 처리에 사용함.

수용 기준

1. FR-19-1소통 한 건의 F·S·T 판정 항목 전체를 한 번에 판정하고, 항목마다 보기 전체의 확률 분포와 근거 구간을 산출해야 함.
2. FR-19-2선택형·척도형은 ‘판단할 수 없음’ 보기가 가장 높거나 최고 확률이 임계값에 미달할 때, 이진형은 참일 확률이 유보 구간에 들 때 판단 유보로 표시해야 함.
3. FR-19-3근거 구간은 원문과 글자 단위로 대조해 통과한 구간만 인정해야 함.
4. FR-19-4전문가 이중 라벨 데이터를 보정용·평가용으로 나누고, 평가용에서 항목별 F1·보정 오차·유보율을 측정해야 함.
5. FR-19-5판정 API에는 판정할 말과 앞뒤 말만 보내고, 받은 판정은 자체 모델 학습에 쓰지 않으며, 판정 확률은 어떤 모양으로도 화면에 표시하지 않아야 함.

상태

개발 중. 판정 항목·라벨 지침·평가셋 확정 후 시험을 거쳐 반영

적용

간부의 말(자료는 항목 확정 때 정함), desk.html 곁패널

처리 예: 소통 한 건의 판정(설명용 예시값)

분대장이 둘을 불러 이야기했는데, 둘 다 상대가 먼저 사과해야 한다고만 합니다.

간부의 말. 앞 말은 ‘3소대 용사 둘이 열흘째 서로 말을 하지 않습니다.’

판정마다 근거 구간을 붙임(예: 합의·이견은 ‘상대가 먼저 사과해야 한다고만’). ‘되풀이 여부’는 이진형 항목으로, 참일 확률 0.46이 유보 구간에 들어 판단을 유보함. 확률은 설명을 위한 예시값임.

시험성적서의 세 항목

그 밖의 비기능 요구사항

성능 시험 측정 항목

요구사항별 시험 파일은 5.5 추적표 참조.

권한에 따라 보이는 정보가 다름. 현장 간부는 자기가 올린 일만 보고, 대화 내용은 받지 않음. 화면에서 단추를 감추는 것과 별개로, 요청마다 서버에서 업무 공간과 참모 권한을 다시 확인함.

수용 기준

1. NFR-01-1업무 공간 구성원이 아닌 계정과 권한이 모자란 계정은 똑같이 403을 받아야 함.
2. NFR-01-2다른 업무 공간의 대화·문서·결심·자료는 실제로 있어도 404로 응답해야 함.
3. NFR-01-3결심 기록·문서 승인·구성원 관리는 책임 간부만 가능해야 함.
4. NFR-01-4현장 간부는 참모 대화를 열지 못하고, 목록에서도 자기가 올린 것만 보아야 함.

적용

참모 API 전체

시험

tests/command/18-members.test.mjs
tests/command/14-decisions.test.mjs

참모에서 무엇을 만들거나 바꾸거나 내려받으면 용사 PoC와 같은 감사 표에 한 줄이 남음. 이 표의 행은 데이터베이스에서 수정·삭제를 차단함. 운영자는 관리자 화면의 감사 조회에서 기록을 확인함.

수용 기준

1. NFR-02-1감사 행을 꼭 남겨야 하는 변경은 행을 남기지 못하면 500으로 실패해야 함.
2. NFR-02-2감사 대상 요청은 막히거나 실패해도 까닭 코드를 붙인 행을 한 줄 남겨야 함.
3. NFR-02-3감사 행에는 본문·비밀번호·코드 평문을 넣지 않고, 정해 둔 짧은 값만 남겨야 함.
4. NFR-02-4문서 PDF·한글 파일과 현황 브리핑 내려받기도 기록해야 함.

조회

운영자의 감사 조회 화면. 참모 전용 조회 화면은 없음.

시험

tests/command/07-interview.test.mjs
tests/command/18-members.test.mjs

묶음별 감사 대상 동작

용사 PoC의 상담·인터뷰·리포트 원문을 참모로 가져오는 코드는 없음. 참모 안에서도 대화 내용은 현장 간부에게 보내지 않음. 부대원 대상 문서에서는 개인을 가려낼 수 있는 칸을 제외함.

수용 기준

1. NFR-03-1참모 코드는 용사 상담·인터뷰·리포트 원문 모듈을 어느 경로로도 불러오지 않아야 함.
2. NFR-03-2현장 간부가 받는 브리프에는 대화·칸 문장·인용·제안이 없어야 함.
3. NFR-03-3조치 카드에는 승인된 계획의 누가·언제까지·무엇을만 옮기고, 인용은 제외해야 함.
4. NFR-03-4지휘서신·공지문에서는 성 뒤에 계급·직책이 붙은 표현이나 간부가 가려 달라고 적은 말이 든 칸을 제외하고, 그 사실을 문서에 기재해야 함.

적용

참모 코드 전체, 현장 간부에게 가는 응답, 부대원이 읽는 문서

시험

tests/command/02-boundaries.test.mjs
tests/command/12-derived.test.mjs

참모가 칸이나 판단에 기록하는 값에는 원문 인용이 필요함. 원문은 간부의 말, 넣은 자료, 확인된 브리프 칸 중 하나임. 인용한 글자가 원문에 그대로 있어야 통과하며, 비슷한 문장은 인정하지 않음.

수용 기준

1. NFR-04-1인용이 없거나 원문에서 찾지 못한 값은 칸에 넣지 않아야 함.
2. NFR-04-2값에 쓴 숫자가 인용에 없으면 그 값을 받지 않아야 함.
3. NFR-04-3근거를 대지 못한 방책 판단은 버리지 않고 미확인으로 처리해야 함.
4. NFR-04-4판단 보고서에는 근거 없는 항목을 싣지 않고, 확인하지 못한 칸을 첫머리에 밝혀야 함.

적용

브리프 칸, 방책 판단, 판단 보고서, 기준정보 초안

시험

tests/command/06-evidence.test.mjs
tests/command/08-coa.test.mjs

모델이 작성한 글은 저장 전에 서버에서 검사함. 걸리는 표현이 있으면 까닭을 붙여 모델을 한 번 더 호출하고, 그래도 걸리면 오류를 반환함. 서버에서 문장을 지어 빈자리를 채우지 않음.

수용 기준

1. NFR-05-1답이나 질문이 결심을 대신하거나 답이 할 일을 지시하면 그 턴을 받지 않아야 함.
2. NFR-05-2답 안의 물음, 더 말해 달라는 청, 칸에 기록했다는 단언은 받지 않아야 함.
3. NFR-05-3금지어는 간부가 이번 말에 쓴 낱말을 되받을 때만 허용하고, 판정하는 뜻으로 쓰면 차단해야 함.
4. NFR-05-4두 번 모두 걸리면 오류를 반환하고, 간부의 말은 저장된 채 남아야 함.

적용

참모 대화, 방책 비교, 조치 계획, 문서 도구

시험

tests/command/27-answer-suggest.test.mjs
tests/command/08-coa.test.mjs

참모 AI 모델은 Claude Sonnet 5, 생각 분량은 low임. 답이 서버 검사에 걸려 다시 호출할 때만 medium으로 올림. 같은 말을 다시 보내면 새 턴을 만들지 않고 앞 턴을 사용함.

수용 기준

1. NFR-06-1한 요청에서 모델은 두 번까지만 호출하고, 설정이 low면 두 번째에만 medium으로 올려야 함.
2. NFR-06-2시간 한도를 넘긴 AI 호출은 프로세스와 그 자식 프로세스까지 종료하고 시간 초과 오류를 반환해야 함.
3. NFR-06-3같은 turn_key로 다시 보낸 말은 새로 저장하지 않고, 저장된 답이 있으면 그 답을 반환해야 함.
4. NFR-06-4답을 받지 못한 첫 말을 다시 보내도 대화가 하나 더 열리지 않아야 함.

적용

참모 대화, AI를 호출하는 도구

시험

tests/command/29-turn-key-retry.test.mjs
tests/command/03-cli-runner.test.mjs

1. 말 저장AI 호출 전 저장. 키가 같으면 앞의 말 사용
2. 줄 서기서버 전체 동시 호출 한도 초과 시 차례 대기
3. 모델 호출대화 120초, 그 밖의 도구 180초 경과 시 종료
4. 서버 검사걸리면 까닭을 붙여 재호출. low였으면 medium으로 상향
5. 두 번 실패오류 코드 반환, 대체 답변 없음
6. 화면저장됨·안 됨·확인 못 함 구분 표시, 재전송 가능

방책과 문서에는 이 중복 방지가 없음. 다시 누르면 모델을 새로 호출하여 방책은 전체가 바뀌고 문서는 새 판이 생성됨.

참모 전용 SQLite 파일 command.sqlite는 참모 모듈을 켜야 데이터 폴더에 생성됨. 표 26개가 모두 이 파일에 있으며, 마이그레이션은 서버 기동 시 적용함.

수용 기준

1. NFR-07-1모듈이 꺼져 있으면 참모 DB 파일을 생성하지 않아야 함.
2. NFR-07-2모듈을 켜도 용사 PoC DB는 표 45개, user_version 3을 유지해야 함.
3. NFR-07-3올린 파일의 원본은 DB에 두지 않고, 추출한 글자만 자료로 남겨야 함.
4. NFR-07-4대화 턴·자료·결심·문서는 삭제하지 않고, 구성원·초대는 상태로 닫아야 함.
5. NFR-07-5참모 DB는 용사 PoC DB와 같은 일일 암호화 백업에 담고, 같은 절차로 복원해야 함.

적용

참모 DB, 자료 올리기, 일일 백업

시험

tests/command/01-wiring.test.mjs
tests/command/31-command-backup.test.mjs

삭제와 보존

너비 640px 이하이거나 터치 화면이면 누르는 영역을 44px 이상으로 키움. 640px 이하에서는 목록 표를 줄 목록으로 전환함. 잠긴 도구는 흐리게 두지 않고 점선·자물쇠와 까닭을 적은 글로 표시함.

수용 기준

1. NFR-08-1너비 640px 이하이거나 터치 화면이면 단추와 도구는 44px 이상이어야 함.
2. NFR-08-2대화 목록·구성원·자료실 표는 640px 이하에서 줄 목록으로 바뀌어야 함.
3. NFR-08-3Enter로 보내고 Shift+Enter로 줄을 바꾸며, 한글 조합 중에는 보내지 않아야 함.
4. NFR-08-4움직임 줄이기 설정에서는 전환과 스켈레톤 반짝임을 멈춰야 함.

근거

DESIGN.md 참모 앱 화면 절, 2026-09-29 실제 크롬 재측정값

남은 사항

넓은 창에서 마우스로 누르는 44px 미만 조작 네 가지

참모 설정은 용사 PoC 설정과 별도로 읽음. 설정 변경 후 서비스를 다시 시작하면 적용됨. 값이 잘못되면 잘못된 곳을 모두 모아 알리고 서버를 기동하지 않음.

수용 기준

1. NFR-09-1모듈을 켜지 않으면 참모 API와 화면은 모두 404이고, 참모 DB 파일도 생기지 않아야 함.
2. NFR-09-2추가 인증을 끄면 참모 계정만 면제되고, 용사 PoC의 상담자·관리자는 그대로 추가 인증을 받아야 함.
3. NFR-09-3추가 인증을 끄면 재확인은 로그인 확인으로 낮아지고, 다시 켜면 원래대로 돌아와야 함.
4. NFR-09-4실사용 환경에서 파일 응답 실행기를 선택하면 서버가 기동하지 않아야 함.

적용

참모 모듈 기동

시험

tests/command/00-config.test.mjs
tests/command/26-mfa-off.test.mjs

참모 시험은 tests/command/에만 둠. 서버의 검사 규칙은 함수 단위로, 권한·저장·여정은 실제 서버를 띄워 HTTP로 시험함. AI 호출은 미리 작성한 응답 파일로 대체함. 따라서 시험은 서버가 받거나 버리는 항목을 확인하며, 모델의 문장 품질은 확인 대상이 아님.

00~33번 파일 34개 중 30번은 이 문서 검사용이고, 나머지 33개 파일에 시험 328건이 있음. 용사 PoC의 수락 시험 22개는 이 문서의 인수 기준에서 제외함.

• 격리·설정·백업00·01·02·26·31 끄면 흔적 없음, 켜도 PoC 그대로, 참모 DB 백업
• AI 실행과 근거03·04·05·06·19 실행기 격리, 자료 읽기, 인용 대조
• 대화07·13·27·28·29·32·33 인용 없는 값 거절, 중복 저장 없음, 목록 200건, 브리프 10칸
• 도구08·09·10·11·12·14 방책·보고서·조치 계획·문서·결심
• 간부와 업무 공간15·16·18·20·23 가입, 기준정보, 초대, 파일 올리기
• 현장17·22·25 현장 보고, 조치 카드, 마침 표시
• 화면과 이 문서21·24·30 여정, 셸이 찾는 창, 이 문서

문서 버전

내용 변경 시 버전을 올리고 이 표에 한 줄을 추가함.

서비스 주요 결정