레포트리 가이드 | 월간 유지보수 보고서 Agent

레포트리란

매월 반복되는 유지보수 결과보고 작업, 곧 PMS 게시글 정리, 점검표 확인, 엑셀 집계, 보고서 편집, PDF·붙임 정리를 한 화면의 5단계로 묶은 도구입니다. 사람은 내용을 확인하고 다듬는 일에 집중하고, 수집·정리·서식·검증은 레포트리가 맡습니다.

누가 쓰나요

유지보수 PM·담당자. 월말 보고서 작성과 제출본 정리를 맡은 사람.

언제 쓰나요

매월 정기점검이 끝나고 PMS 처리 내역이 정리된 뒤(보통 월말 보고일 전).

무엇이 남나요

월별 최종내역 엑셀, A4 결과보고서(HTML·PDF), 붙임합본 PDF.

작성 흐름 5단계

이력 수집
- [PMS 수집 → 엑셀 저장]: 유지보수 게시판 목록·답글·제목 태그를 읽어 작업관리현황_v1.0.xlsx로 정리합니다.
- PMS 계정을 넣으면 본문·댓글까지 읽습니다(계정은 저장하지 않음). 처음 수집할 때는 기존 원장(v0.2)으로 빈 칸을 보완할 수 있습니다.
- 파일(.xlsx·HTML .xls·.csv) 업로드나 화면 표 붙여넣기도 됩니다.
입력: PMS 게시판 · 기존 원장출력: 작업관리현황_v1.0.xlsx
분석·검토
- 접수일 기준으로 월을 나누고 중복 이력을 통합합니다. 월 버튼 또는 [유지보수 전체]로 봅니다.
- 분류·담당자·PMS 분류 원형 그래프, 진행상태 비율로 이상 여부를 확인하고 표에서 바로 고칩니다.
확인: 처리 결과 누락 · 완료일 누락 · 진행 건
정기점검·주요 협의·이슈
- 월을 처음 열면 NAS의 서버·네트워크 점검표로 점검 결과를 채웁니다. [점검표 파일 올리기]로 다른 점검표를 반영할 수 있습니다.
- 주요 협의의 '결론 및 후속관리'는 비고의 결과 보고서·처리 근거(완료) 또는 처리 내용(진행)으로 초안을 만듭니다.
- 점검 이상과 진행 작업은 '이슈' 초안으로 들어갑니다.
최종내역
- 수정하면 우측 하단에 [저장] 버튼이 나타납니다. 저장하면 N월 유지보수 내역.xlsx가 갱신되고 ④에 시트별로 표시됩니다.
- 이 엑셀이 보고서의 유일한 입력입니다. 엑셀에서 직접 고친 뒤 보고서를 다시 만들어도 됩니다.
출력: N월 유지보수 내역.xlsx (6개 시트)
보고서 생성
- [저장 후 보고서 생성] → A4 보고서와 검증 결과(자산 수, 결과 기재, 접속정보, 쪽 넘침 실측 등).
- [붙임파일 추가] → NAS 자료를 붙임 1~5로 분류 → [붙임합본 PDF 생성].
- [새 창에서 열기] · [PDF 파일 생성]으로 확인·제출본을 만듭니다.
출력: 결과보고서.html · .pdf · 붙임합본.pdf

데이터 출처

자료	위치	쓰는 곳
PMS 유지보수 게시판	`https://pms.datatree21.com/project/khepi/`	① 작업 이력
기존 작업관리 원장(v0.2)	NAS `04. 사업수행/00. 문서양식`	① 빈 칸 보완(선택)
유지보수 대상목록	NAS `00. 문서양식/input/유지보수-대상목록_*.xlsx`	보고서 1.2·1.3, 정기점검 대상
인프라 구성도	NAS `input/기초자료/인프라 구성도.png`	보고서 1.1 그림 1
정기점검표(서버·네트워크)	NAS `N월 유지보수/N월 제출문서/03. 월별 정기점검`	③ 점검 결과, 붙임 2
회의록·결과보고서 등	NAS `N월 제출문서/01·02·04`	붙임 5

산출물

파일	내용
`data/작업관리현황_v1.0.xlsx`	No·접수일·완료일·분류·제목(요청내용)·조치결과·진행상태·담당자·비고 + 월별통계·수집정보 시트. 재수집 전 `data/backup/`에 백업
`data/maintenance/YYYY년 M월 유지보수 내역.xlsx`	유지보수내역 · 정기점검 · 주요협의 · 이슈·차월계획 · 분류별집계 · 보고정보
`output/YYYY년_M월_월간유지보수결과보고서.html`	표지·목차·01~04장 A4 보고서(본문 쪽 번호 포함)
`…결과보고서.pdf`	A4 PDF(KoPub돋움체 내장)
`…결과보고서_붙임합본.pdf`	보고서 + 간지 + 붙임 1~5

작성 원칙

사실 기반

원장·점검표에 있는 내용만 씁니다. 점검표가 없는 장비는 '미기재'로 두고 검증에서 경고합니다.

보안 정보 배제

IP·URL·공유경로는 보고서에서 '(접속정보 별도 관리)'로 가립니다. 자산 목록의 IP·연락처는 읽지 않습니다.

서식 일관성

sa-report 서식(KoPub돋움체, 남색 머리글 표, No. 자동 증가). 글자를 줄이지 않고 쪽을 나눕니다.

수기 수정 보존

엑셀에서 고친 조치결과·비고·분류·담당자·완료 처리는 다시 수집해도 유지됩니다.

화면 사용 팁

상단 바의 관리월 옆 '저장 안 됨' 표시와 우측 하단 [저장] 버튼은 수정 사항이 있다는 뜻입니다.
[유지보수 전체]의 월별 막대를 누르면 해당 월로 바로 이동합니다.
③ 주요 협의의 [작업내역·비고로 초안 다시 만들기]는 점검표로 만든 '정기점검' 행을 유지합니다.
붙임 목록에서 체크를 끄면 합본에서 빠집니다. 원격 접속정보가 담긴 자료는 넣을지 꼭 확인하세요.
메인 개요의 소개 박스는 [소개 접기]로 숨길 수 있고, 이 브라우저에서 상태를 기억합니다.

자주 묻는 질문

PMS 수집 결과에서 '진행'으로 남은 건이 실제로는 끝났습니다.

로그인 없이 수집하면 목록·제목 태그만 읽습니다. 작업관리현황 엑셀에서 진행상태와 완료일을 고치거나, PMS 계정을 넣고 다시 수집하세요. 엑셀에서 고친 값은 다음 수집에서도 유지됩니다.

정기점검 탭이 '점검표 없음'으로 나옵니다.

NAS에 N월 유지보수 폴더와 '서버 점검'·'네트워크 점검' 파일이 있는지 확인하세요. 없으면 [점검표 파일 올리기]로 PDF·Word 파일을 올리면 됩니다.

보고서 검증에서 '정기점검 결과 기재'가 경고로 나옵니다.

보안장비·백업 SW·스토리지는 NAS에 점검표가 없어 비어 있습니다. 결과를 입력하거나 해당 점검표를 올려 주세요.

PDF나 합본이 만들어지지 않습니다.

설치형 프로그램은 PC의 Microsoft Edge로 PDF를 만듭니다. Edge를 최신으로 업데이트한 뒤 다시 시도하세요. 소스로 실행하는 경우에는 Node.js와 puppeteer(저장소 루트 node_modules)가 필요합니다. Word·HWP 붙임은 LibreOffice로 변환하며, 변환할 수 없는 파일은 PDF로 올려 주세요.

설치형 프로그램에서 작업 파일은 어디에 저장되나요?

문서\레포트리 폴더입니다. 엑셀(data), 보고서(output), 설정(config\project.json), 로그(logs)가 이 폴더에 있습니다. 프로그램을 업데이트하거나 제거해도 지워지지 않습니다. 시작 메뉴의 '작업 폴더 열기'로 바로 열 수 있습니다.

다른 PC에서 접속할 수 있나요?

현재는 이 PC(127.0.0.1)에서만 접속하도록 되어 있습니다. 사내 서버로 운영하는 절차는 docs/DEPLOY.md를 참고하세요.

설정·파일 위치

설정 파일: 설치형은 문서\레포트리\config\project.json, 소스 실행은 monthly_report_pipeline/config/project.json. 고친 뒤 프로그램을 다시 실행하면 반영됩니다.

항목	설명
`org · project · vendor`	표지·머리말·꼬리말의 기관명·사업명·수행사
`writer · approver`	표지 '작성 및 제출', '검토 및 승인' 기본값(월별로 ③ 표지·보고 정보에서 수정)
`pms.url · board_id · file`	PMS 게시판 주소, KBoard 번호, 원장 파일명
`sources.assets · diagram`	유지보수 대상목록, 인프라 구성도 경로
`inspection.nas_root`	정기점검표·붙임 자료를 찾는 NAS 사업수행 폴더
`port`	웹 서버 포트(기본 8765)

data/·output/ 폴더에는 발주기관 운영 이력과 보고서가 들어 있어 git·외부 저장소에 올리지 않습니다.