사용 안내
처음 사용하는 담당자를 위한 작업 순서와 자주 묻는 질문입니다.
빠른 사용법
| 찾기 | [메뉴·용어 검색] 버튼을 누르거나, / 또는 Ctrl+K를 누르면 통합검색이 열립니다. 화면·이슈·문서·사이트·용어·핸드북 챕터를 한 번에 찾습니다. |
|---|---|
| 검토·승인 | 목록에서 문서를 선택해 원문과 점검 사유를 읽고 [승인하기], [반려하기], [나중에 검토] 중 하나를 누르세요. 여러 문서는 체크 상자로 선택할 수 있습니다. 단축키는 검토 화면에서 ‘키보드 단축키 사용’을 켠 경우에만 작동합니다. |
| 처분 | 유지 · 수정(갱신 요청) · 수정(title) · 병합(정본 지정) · 병합(301 리다이렉트) · 현행 제외(색인만) · 기록 보존(보관 + 색인 제외). 삭제 제안은 없습니다. 고시공고의 「폐기」는 기관의 적법 절차로 별도 실행하고, 앱에서는 기록 보존(보관 + 색인 제외)까지만 처리합니다. |
| 대표 URL | 중복 문서 관리에서 [대표로]를 누르면 canonical 맵·301 맵·매니페스트가 즉시 따라갑니다. 자동 병합은 하지 않습니다. |
| 규칙 | 시한 키워드·잡음 파라미터·게시판 쌍·대상 동의어는 코드가 아니라 점검 기준 설정에서 관리하고, 저장 전에 영향받는 이슈 수를 미리 봅니다. |
| 결과 내려받기 | 승인된 이슈만 수정 요청서(tickets.xlsx)에 담깁니다. 매니페스트는 approved_only일 때 미승인 제안을 hold로 냅니다. 벤더 토큰은 매니페스트만 읽습니다. |
| 인쇄 | 업무 현황 상단의 [인쇄]로 진단 리포트용 표를 뽑을 수 있습니다. 메뉴·버튼은 인쇄에서 빠집니다. |
| 자기 승인 | 제안 수정(E) 뒤 [수정안 저장]을 누르면 작성자가 기록되고, 그 사람은 승인할 수 없습니다. 승인자 이름을 소관 부서 검토자로 바꾼 뒤 승인하세요. 승인 시점의 원문 버전이 기록되며, 원문이 바뀌면 적용·결과 내려받기에서 제외됩니다. |
| 사업·검수 | 사업·견적 화면은 견적 워크북(사업가정·원가견적·12개월 현금·WBS)을, 검수·관문 화면은 요구검수·오픈 관문·위험·첫 미팅 질문지를 담습니다. 입력은 이 브라우저에만 저장됩니다. |
| 화면 | 왼쪽 아래(모바일은 상단)에서 자동/밝게/어둡게를 바꿀 수 있습니다. |
승인자 5원칙
핸드북 「공무원 AI 사용 5원칙」을 이 앱의 승인 흐름에 맞춰 옮겼습니다.
- 1.AI 초안은 초안입니다 — title 제안·낡음 판정·구조화 초안·사실 충돌 정답 후보는 모두 AI 초안입니다. 인용 근거가 본문에 실재하는지 보고 승인합니다.
- 2.개인정보는 화면에서도 가립니다 — D8 이슈는 마스킹본만 저장·표시됩니다. 원문 확인은 원본 페이지에서 담당자가 직접 하고, 첨부는 즉시 교체합니다.
- 3.삭제는 제안하지 않습니다 — 고시공고·공지는 기록물입니다. 처분은 갱신·보관(색인 제외)·유지 중에서 고르고, 폐기 여부는 담당 부서가 결정합니다.
- 4.정밀도 90% 미만은 관찰입니다 — '관찰' 탭의 이슈는 자동 제안이 아닙니다. 반려하면 골드셋 후보로 쌓여 다음 측정에 쓰입니다.
- 5.측정 방법을 먼저 공개합니다 — 위생 점수 산식과 KPI 정의는 대시보드에 그대로 적혀 있습니다. 숫자보다 먼저 산식을 부서와 공유합니다.
정비 결정과 보존 정책 — 삭제가 아니라 「어떤 맥락에서 어디에 남길 것인가」
기획서 13장의 7가지 판정과 이 앱의 처분 값. 삭제/폐기는 기관이 정한 적법 절차로 별도 실행하며 이 앱에는 삭제 기능이 없다.
| 판정 | 앱 처분 | 처리 | 필수 승인 / 증빙 |
|---|---|---|---|
| 유지 | keep | 현재 안내 유지, 검토일·담당자만 확인 | 소관 부서 사실 확인 |
| 수정 | update | 제목·본문·준비물·비용·기간을 승인 원문에 따라 수정 (title만이면 retitle) | 근거 URL·시행일·차이·검토자 |
| 병합 | merge | 정본 1개를 지정하고 중복 문서를 연결/통합 (301은 redirect) | 소관 부서 동의·URL 영향·링크 재검증 |
| 현행 제외 | exclude_index | 현행 메뉴/검색/RAG에서 제외하되 보존 컬렉션 유지 | 공개정책·기록 담당 결정 |
| 기록 보존 | archive | 과거 시점·종료 안내를 표시하고 보존 체계로 이관 | 보존 기한·책임자·위치 |
| 삭제/폐기 | — (없음) | 기관이 정한 적법 절차에 따라 별도 실행 — 이 앱에는 삭제 기능이 없다 | 기록/개인정보/법무 승인, 보존 의무·법적 보류 확인 |
| 보류 | (상태: 보류) | 근거 부족·부서 이견·법적 분쟁·수집 실패 | 사유·담당자·해결 기한·잔여 위험 |
승인 흐름(상태 전이) — 초안(draft) → 검토 요청(submitted) → 승인(approved) → 적용(applied) → 되돌림(rolled_back). 반려(rejected)된 안은 적용할 수 없고, 새 원문/새 초안으로 재검토한다. 검토 중 원문 변경·같은 버전에서 다른 적용·권한 부족은 성공처럼 처리하지 않고 403/409로 거부한다.
6개 안내 필드 — 대상 · 준비물 · 수수료 · 처리기간 · 담당부서 · 신청 링크. 원문에 없는 값은 null. 신규 수수료·기한은 메모로 추가하지 않고 승인된 새 원문을 등록해 버전을 올린 뒤 다시 초안을 만든다.
핸드북에서 이어지는 장
핸드북은 「왜·무엇을」, 이 앱은 「어떻게」입니다. 핸드북 영역 ③의 네 가지 과업을 이 앱이 실행합니다.
- PART 1 · 04진단 ①~④ — 콘텐츠·검색·다국어·예산 구조 ↗이 앱의 회귀 사례 F1~F9가 나온 관찰. 진단 ① 콘텐츠 위생 표와 D1~D5가 1:1로 대응
- PART 1 · 05진단 요약과 현장 테스트 10문항 ↗10문항 중 2개(민선8기·코로나)는 낡은 페이지 함정. D3 이슈에 '평가셋 함정' 태그로 표시
- PART 3 · 11영역 ③ 콘텐츠 정비 · 지식베이스 — 실행 순서 1번 ↗네 가지 과업(위생·구조화·쉬운 우리말·신선도 감시)과 측정 지표. 대시보드의 과업 카드가 이 장을 따른다
- PART 5 · 164억 배분 · 12개월 로드맵 · KPI 8개 ↗KPI ⑦ 콘텐츠 신선도는 이 앱이 매주 산출. 31~90일 '콘텐츠 정비 1차 내부 착수'가 이 앱의 MVP 구간
- PART 5 · 15제도 6가지 · 범정부 공통기반 · 조달 ↗N2SF O등급 상정, CSAP 리전, 기록물(고시공고) 보존 원칙의 근거
12개월 로드맵에서 이 앱의 자리
| 시기 | 핸드북 로드맵 | 이 앱이 맡는 일 |
|---|---|---|
| 0~30일 · 2026.9~10 | 측정과 준비 | 표본 스캔(S4) → 회귀 사례 재확인, 과업지시서용 수치 |
| 31~90일 · 2026.11~12 | 발주와 1차 정비 | MVP 2주 진단 → 1차 위생 리포트, 매니페스트 v0, 인덱싱 범위(우선 15개 사이트) |
| 3~6개월 · 2027.1~3 | 파일럿 | 화면 5종 운영, 주간 감시, 구조화 초안, 벤더 매니페스트 API |
| 6~9개월 · 2027.4~6 | 정식 오픈과 공개 | KPI ⑦ 월간 공개, 2027.6 행정사무감사 수치 |
| 9~12개월 · 2027.7~9 | 고도화 | 월간 감시 구독, 다기관 확장 |
하나의 마일스톤: 2027년 6월 행정사무감사에 KPI를 숫자로 보고. 이 앱은 그중 ⑦ 콘텐츠 신선도를 맡습니다.
자주 묻는 질문
승인·반려한 내용은 어디에 저장되나요?
이 시연본은 서버가 없는 정적 배포라 승인·규칙·대표 URL 변경이 모두 사용 중인 브라우저(localStorage)에만 저장됩니다. 파일럿에서는 API(PostgreSQL)에 기록되고 승인 이력이 감사 로그로 남습니다.
표본 데이터는 실제 마포구 홈페이지 데이터인가요?
아닙니다. 강의안(2026-09-12 색인 관찰)과 구성명세서의 회귀 사례 F1~F9를 재현하도록 만든 설명용 표본입니다. URL·수치는 첫 크롤에서 확정합니다.
'자동 제안'과 '관찰'의 차이는?
골드셋 정밀도 90% 이상인 탐지기 코드만 자동 제안입니다. 측정 전에는 규칙 기반(D1 exact, D2 T1~T3, D5, D8)만 자동 제안이고 나머지는 관찰입니다.
매니페스트를 벤더에게 어떻게 넘기나요?
내보내기에서 벤더 읽기 전용 토큰을 발급하고 GET /api/exports/manifest.json 주소를 전달합니다. 벤더는 include만 색인하고, alias_urls는 canonical_url로 바꿔 출처를 표기합니다.
부서 이름이 조직도와 다릅니다.
2026.8.14 민선9기 첫 조직개편(8국→7국, 2담당관 37과) 기준으로 맞췄습니다. 담당부서 표기가 옛 이름이면 D3_ORG_MISMATCH 이슈로 잡힙니다.
핸드북과 이 앱은 어떻게 다른가요?
핸드북은 '왜·무엇을'(강의·시장조사·과별 프롬프트), 이 앱은 '어떻게'(전수 스캔·승인·산출물)입니다. 핸드북 영역 ③의 네 가지 과업을 이 앱이 실행합니다.
용어집
- 콘텐츠 위생
- 중복·오표기·낡음·충돌 없이 AI가 읽어도 되는 상태로 콘텐츠를 유지하는 일.
- RAG (검색증강생성)
- AI가 답하기 전에 기관의 문서를 먼저 검색해 그 내용을 근거로 답하게 하는 방식. 홈페이지 챗봇의 표준 구조.
- 매니페스트
- 어떤 문서를 인덱스에 넣고(include)·빼고(exclude)·보류(hold)할지, 대표 URL은 무엇인지 적은 목록 파일.
- canonical 태그
- 같은 내용의 페이지가 여러 주소로 열릴 때 '대표 주소'를 알려 주는 HTML 표시.
- 301 리다이렉트
- 옛 주소로 들어오면 새 주소로 자동으로 보내는 설정.
- 보관(아카이브)
- 삭제하지 않고 '지난 자료'로 표시한 뒤 검색·AI 색인에서만 빼는 것.
- 골드셋
- 사람이 정답을 달아 둔 평가용 표본. 탐지기별 300건으로 정밀도를 잰다.
- 정밀도
- 앱이 문제라고 한 것 중 실제 문제인 비율. 90% 미만이면 '관찰' 등급.
- 평가셋
- 정답을 아는 질문 묶음(200문항). 같은 문제로 매달 재면 개선 여부를 숫자로 말할 수 있다.
- 환각 (할루시네이션)
- AI가 사실이 아닌 내용을 그럴듯하게 지어내는 현상. 이 앱은 인용이 본문에 실재하는지 코드로 검증한다.
- 임베딩
- 문장을 의미 기반의 숫자 벡터로 바꾸는 것. D2 T5·D7 대상 묶기에 쓴다.
- MinHash / LSH
- 긴 문서를 짧은 지문으로 줄여 거의 같은 문서를 빠르게 찾는 기법. D1 near 클러스터의 기초.
- N2SF
- 국가 망 보안체계. 공개(O) 웹페이지만 다루므로 O등급을 상정하되 정보통신팀과 합의가 필요하다.
- CSAP
- 클라우드 보안인증. 기관 납품·운영은 CSAP 인증 리전에서.
- AI 초안
- AI가 만든 제안. 원문 근거가 붙어 있으며 사람이 확인한 뒤에만 반영.
- 회귀 사례
- 2026-09-12 강의안에서 관찰된 문제(F1~F9). 고쳐진 뒤 재발하는지 계속 확인한다.
더 많은 용어는 핸드북 용어집 ↗
업데이트 이력
- 2026-09-22ContentCare 사업 체계 반영: 사업·견적 화면(상품 4종·원가 견적 계산·12개월 현금·90일 WBS), 검수·관문 화면(요구검수 16·오픈 관문 9·위험 10·인터뷰 10), 처분 7종·검토 주기·자기 승인 금지·버전 충돌·커버리지·knowledge.jsonl·CSV 수식 보호, D3 책임자 미입력·D9 접근성·지시문
- 2026-09-21핸드북 연동: 디자인 체계 통일, 통합검색(/), 매뉴얼·도움말, 네 가지 과업 지도, 조직개편 후 부서명 반영
- 2026-09-21점검 반영: 내보내기 중복 행 제거, 좁은 화면 대응, API 페이지 값 검증
- 2026-09-21파일럿 화면 5종 + 검사 도구 + API 최초 배포
위생관리 앱 v0.3 · 짝 문서: 기획서 v0.1 · 구성명세서 v0.1 (2026-09-21) · ContentCare 사업개발기획서·사업운영 견적(2026-09-21) · 핸드북 v1.0 (강의일 2026-09-18)
문의: 도입 상담 leesh@tenai.kr · 핸드북·강의 내용은 핸드북 도움말 ↗