레포트리란
매월 반복되는 유지보수 결과보고 작업, 곧 PMS 게시글 정리, 점검표 확인, 엑셀 집계, 보고서 편집, PDF·붙임 정리를 한 화면의 5단계로 묶은 도구입니다. 사람은 내용을 확인하고 다듬는 일에 집중하고, 수집·정리·서식·검증은 레포트리가 맡습니다.
유지보수 PM·담당자. 월말 보고서 작성과 제출본 정리를 맡은 사람.
매월 정기점검이 끝나고 PMS 처리 내역이 정리된 뒤(보통 월말 보고일 전).
월별 최종내역 엑셀, A4 결과보고서(HTML·PDF), 붙임합본 PDF.
프로젝트·업무 성격
① 이력 수집 맨 위의 선택 상자에서 프로젝트를 고르면 화면 전체가 그 프로젝트로 바뀝니다. 프로젝트마다 수집 원장·월별 내역·보고서가 따로 저장됩니다. [프로젝트 관리]에서 등록·수정합니다.
| 등록 항목 | 설명 |
|---|---|
| 프로젝트명 · PMS 주소 | [게시판 확인]을 누르면 PMS 페이지에서 KBoard 게시판 번호와 이름을 찾아 채웁니다. |
| 기관명 · 사업명 | 보고서 표지·머리말 (비우면 프로젝트명 기준). 표지 '검토 및 승인' 기본값은 '기관명 담당자'입니다. |
| 업무 성격 | 인프라 유지보수 / 개발·운영 유지보수 — ③ 입력 탭과 보고서 장 구성이 달라집니다. |
| 구성도 이미지 · 붙임 자료 폴더 | [찾아보기]로 Windows 선택 창에서 고르거나 경로를 붙여 넣습니다. 붙임 자료 폴더는 월 폴더(예: 2026년 9월자료)들이 들어 있는 상위 폴더입니다. |
기본 프로젝트(한국건강증진개발원)는 인프라로 고정이며, 구성도·NAS 경로는 설정 파일(config/project.json)을 따릅니다.
| 장 | 인프라 유지보수 | 개발·운영 유지보수 |
|---|---|---|
| 01 | 유지보수 현황: 1.1 시스템 구성현황 · 1.2 장비내역 · 1.3 유지보수 대상 리스트 | 유지보수 현황: 1.1 시스템 구성현황(구성도 등록 시 그림) · 1.2 서비스 점검 현황 |
| 02 | 유지보수 요청처리 및 작업결과 내역: 2.1 현황 · 2.2 작업내역 · 2.3 주요 협의 및 후속 조치 (공통) | |
| 03 | 월별 정기점검: 서버·네트워크 · 보안장비 · 백업·스토리지 | 보안·개인정보 점검: 자체 보안 · 개인정보 관리실태 · 접속기록 (매월) · 정책정보 웹사이트 (분기) |
| 04 | 기타 및 보고사항: 이슈·차월 계획 | 기타 및 보고사항: 4.1 이슈사항 · 4.2 협조요청 및 결정 사항 |
| 붙임 | 유지보수 내역 · 서버·네트워크 점검표 · 보안장비·방화벽 점검표 · 백업·스토리지 점검표 · 회의록·보고문서 | 유지보수 내역 · 용역사업 자체 보안 점검표 · 수탁자 개인정보 보호 관리실태 점검표 · 접속기록 점검 및 조치결과서 · 정책정보 웹사이트 관리 확인 점검 체크리스트 |
작성 흐름 5단계
- 이력 수집
- 맨 위 선택 상자에서 프로젝트를 고릅니다. 이미 수집한 원장이 있으면 바로 불러옵니다.
- [PMS 수집 → 엑셀 저장]: 그 프로젝트의 게시판 목록·답글·제목 태그를 읽어
작업관리현황_v1.0.xlsx로 정리합니다. - PMS 계정을 넣으면 본문·댓글까지 읽습니다(계정은 저장하지 않음). 처음 수집할 때는 기존 원장(v0.2)으로 빈 칸을 보완할 수 있습니다.
- 파일(.xlsx·HTML .xls·.csv) 업로드나 화면 표 붙여넣기도 됩니다.
입력: PMS 게시판 · 기존 원장출력: 작업관리현황_v1.0.xlsx - 분석·검토
- 접수일 기준으로 월을 나누고 중복 이력을 통합합니다. 월 버튼 또는 [유지보수 전체]로 봅니다.
- 분류·담당자·PMS 분류 원형 그래프, 진행상태 비율로 이상 여부를 확인하고 표에서 바로 고칩니다.
확인: 처리 결과 누락 · 완료일 누락 · 진행 건 - 보고서 작성 및 수정사항
- 인프라: 월을 처음 열면 NAS의 서버·네트워크 점검표로 정기점검 결과를 채웁니다. [점검표 파일 올리기]로 다른 점검표를 반영할 수 있습니다.
- 개발·운영: 서비스 점검(서비스명·주소·정상 여부, 다음 달로 이어짐), 보안·개인정보 점검(기본 항목 자동), 협조요청 탭에 입력합니다.
- 주요 협의의 '조치 및 후속관리'는 비고의 결과 보고서·처리 근거(완료) 또는 처리 내용(진행)으로 초안을 만듭니다.
- 점검 이상과 진행 작업은 이슈 초안으로 들어갑니다. 표지·보고 정보에서 작성자·승인자·1.1 시스템 개요를 확인합니다.
- 최종내역
- 수정하면 우측 하단에 [저장] 버튼이 나타납니다. 저장하면
N월 유지보수 내역.xlsx가 갱신되고 ④에 시트별로 표시됩니다. - 이 엑셀이 보고서의 유일한 입력입니다. 엑셀에서 직접 고친 뒤 보고서를 다시 만들어도 됩니다.
출력: N월 유지보수 내역.xlsx (인프라 6개 · 개발·운영 8개 시트) - 수정하면 우측 하단에 [저장] 버튼이 나타납니다. 저장하면
- 보고서 생성
- [저장 후 보고서 생성] → 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 |
| 다른 프로젝트 PMS | [프로젝트 관리]에 등록한 PMS 주소 | ① 작업 이력 |
| 다른 프로젝트 구성도 | [프로젝트 관리] '구성도 이미지' | 보고서 1.1 그림 1 |
| 다른 프로젝트 붙임 자료 | [프로젝트 관리] '붙임 자료 폴더' 아래 관리월 폴더 (서식·문서24·제출완료본 폴더 제외) | 붙임 2~5 |
산출물
| 파일 | 내용 |
|---|---|
data/작업관리현황_v1.0.xlsx | No·접수일·완료일·분류·제목(요청내용)·조치결과·진행상태·담당자·비고 + 월별통계·수집정보 시트. 재수집 전 data/backup/에 백업 |
data/maintenance/YYYY년 M월 유지보수 내역.xlsx | 인프라: 유지보수내역 · 정기점검 · 주요협의 · 이슈·차월계획 · 분류별집계 · 보고정보 개발·운영: 유지보수내역 · 서비스점검 · 보안점검 · 주요협의 · 이슈·차월계획 · 협조요청 · 분류별집계 · 보고정보 |
projects/<id>/… | 기본 프로젝트 외 프로젝트의 data·output (구성은 위와 같음) |
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)가 이 폴더에 있습니다. 프로그램을 업데이트하거나 제거해도 지워지지 않습니다. 시작 메뉴의 '작업 폴더 열기'로 바로 열 수 있습니다.
한국건강증진개발원 외 다른 유지보수 프로젝트도 작성할 수 있나요?
네. ① 이력 수집의 [프로젝트 관리]에서 프로젝트명과 PMS 주소를 입력하고 [게시판 확인]을 누르면 게시판 번호가 자동으로 채워집니다. 저장한 뒤 위 선택 상자에서 프로젝트를 고르고 [PMS 수집]을 누르면 그 게시판을 수집·분석합니다. 프로젝트마다 원장·월별 내역·보고서가 따로 저장되며, 업무 성격과 구성도·붙임 자료 폴더도 프로젝트마다 지정합니다.
개발·운영 유지보수 프로젝트는 보고서가 어떻게 달라지나요?
① [프로젝트 관리]에서 업무 성격을 '개발·운영 유지보수'로 저장하세요. ③ 탭이 서비스 점검 · 보안·개인정보 점검 · 주요 협의 · 이슈사항 · 협조요청으로 바뀌고, 보고서는 01 유지보수 현황(1.2 서비스 점검 현황) · 02 요청처리 및 작업결과 · 03 보안·개인정보 점검 · 04 기타 및 보고사항(4.1 이슈사항, 4.2 협조요청 및 결정 사항)으로 만들어집니다. 붙임 2~5는 자체 보안 점검표, 개인정보 관리실태 점검표, 접속기록 점검 및 조치결과서, 정책정보 웹사이트 점검 체크리스트(분기)이며 ⑤ [붙임파일 추가]에서 올립니다.
다른 프로젝트의 구성도·붙임 자료는 어떻게 연결하나요?
① [프로젝트 관리]에서 프로젝트를 [수정]하고 '구성도 이미지'와 '붙임 자료 폴더'(월 폴더들이 들어 있는 상위 폴더) 옆의 [찾아보기]를 눌러 Windows 선택 창에서 고르면 경로가 채워지고 바로 확인됩니다. 경로를 직접 붙여 넣어도 되며, 탐색기의 '경로로 복사' 값(따옴표 포함)도 그대로 쓸 수 있습니다. 확인한 뒤 [저장]을 누르세요. ⑤ [붙임파일 추가]를 누르면 관리월에 맞는 월 폴더(예: 2026년 9월자료)에서 점검표를 찾아 붙임 2~5에 나눠 넣고, 서식·공문·합본은 빼며, 나머지는 '미분류'로 보여 줍니다.
다른 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) |
config/projects.json | [프로젝트 관리]에서 등록한 프로젝트(PMS 주소·게시판 번호·업무 성격·구성도·붙임 자료 폴더)와 현재 선택 프로젝트. 화면에서 관리합니다. |
data/·output/ 폴더에는 발주기관 운영 이력과 보고서가 들어 있어 git·외부 저장소에 올리지 않습니다.