릴리즈 날짜: `2026-03-22`
Autoreport의 첫 번째 기준 버전인 `v0.1.0`을 공개합니다.
이번 버전은 정형화된 weekly report 입력을 검증하고, 이를 PowerPoint 보고서로 생성하는 기본 흐름을 제공하는 데 집중했습니다.
## 이번 버전에서 포함된 내용
– weekly report YAML 입력 지원
– CLI 기반 보고서 생성 명령 지원
– 입력 데이터 검증 및 오류 메시지 제공
– `.pptx` 출력 파일 생성
– 선택적 PowerPoint 템플릿 파일 사용 지원
– 기본 출력 경로 자동 생성
## 기본 사용 방법
“`bash
autoreport generate examples/weekly_report.yaml –output output/weekly_report.pptx
“`
추가 옵션은 아래와 같습니다.
– `–output`: 생성할 `.pptx` 파일 경로 지정
– `–template`: 사용할 PowerPoint 템플릿 파일 경로 지정
`–output`을 지정하지 않으면 기본 출력 경로는 아래와 같습니다.
“`text
output/<입력파일명>.pptx
“`
## 현재 지원하는 입력 구조
v0.1.0은 weekly report 스키마만 지원합니다.
지원 필드는 아래와 같습니다.
– `title`
– `team`
– `week`
– `highlights`
– `metrics`
– `risks`
– `next_steps`
`metrics`는 아래 두 항목만 지원합니다.
– `tasks_completed`
– `open_issues`
## 출력 형식
현재 생성되는 보고서는 아래 5개 슬라이드 구조를 기준으로 합니다.
– 제목
– Highlights
– Metrics
– Risks
– Next Steps
## 오류 처리
다음과 같은 경우 명확한 오류 메시지를 제공합니다.
– 입력 YAML 파일이 없는 경우
– YAML 문법이 잘못된 경우
– 필수 필드가 누락된 경우
– `metrics` 값이 잘못된 경우
– 템플릿 파일이 없거나 잘못된 경우
– 출력 파일을 쓸 수 없는 경우
## 현재 제한 사항
– v0.1.0은 weekly report 형식만 지원합니다.
– `report_type` 필드는 지원하지 않습니다.
– 예상하지 못한 추가 top-level 필드는 허용하지 않습니다.
– `metrics`는 현재 2개 항목만 지원합니다.
– custom template는 사용할 수 있지만, 완전히 자유로운 템플릿 구조를 모두 보장하는 단계는 아닙니다.
## 다음 단계
다음 버전에서는 더 다양한 슬라이드 구성, branding 요소, richer metrics 표현, 그리고 customized template 대응 범위를 확장하는 방향을 검토할 예정입니다.
Autoreport는 반복 보고를 한 번 정의한 뒤 계속 같은 기준으로 다룰 수 있게 만드는 것을 목표로 합니다.
`v0.1.0`은 그 기준점을 세운 첫 번째 버전입니다.
댓글 남기기