# 주간보고 시스템 마스터 작업계획서 > 작성일: 2026-01-10 > 총 예상 기간: 6~8주 > 총 Phase 수: 30개 (통합 DB 포함) > 총 테이블 수: 16개 --- ## 1. 프로젝트 개요 ### 1.1 목표 주간보고 시스템에 7개 신규 기능을 추가하여 업무 효율성 향상 ### 1.2 작업 목록 | # | 작업명 | 예상 기간 | Phase | 난이도 | 의존성 | |:-:|--------|:---------:|:-----:|:------:|:------:| | 01 | 회의록 + TODO | 5~7일 | 4 | ⭐⭐ | 없음 | | 02 | 사업-프로젝트 계층 | 3~5일 | 4 | ⭐⭐ | 없음 | | 03 | 유지보수 업무관리 | 5~7일 | 4 | ⭐⭐⭐ | 없음 | | 04 | Gmail OAuth | 5~7일 | 5 | ⭐⭐⭐ | 없음 | | 05 | Synology SSO | 2~3일 | 2 | ⭐ | **04 완료** | | 06 | 구글 그룹 연동 | 1~2주 | 4 | ⭐⭐⭐ | **04 완료** | | 07 | SVN/Git 연동 | 2~3주 | 6 | ⭐⭐⭐ | 02 권장 | ### 1.3 의존성 다이어그램 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 독립 실행 가능 │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │ │01 회의록│ │02 사업 │ │03 유지 │ │04 OAuth│ │ │ └────────┘ └───┬────┘ └────────┘ └───┬────┘ │ │ │ │ │ │ │ (권장) │ (필수) │ │ ▼ ▼ │ │ ┌────────────┐ ┌────────────┐ │ │ │ 07 VCS │ │ 05 Synology│ │ │ └────────────┘ └─────┬──────┘ │ │ │ │ │ ▼ │ │ ┌────────────┐ │ │ │ 06 구글그룹│ │ │ └────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## 2. 통합 실행 계획 ### 2.1 전체 Phase 목록 (30개) ``` Phase 00: 통합 DB 마이그레이션 ─────────────────────── 0.5일 │ ├─► 01-P1: 회의록 기본 구조 ─────────────────────── 2일 ├─► 02-P1: 사업 CRUD ────────────────────────────── 1.5일 ├─► 03-P1: 유지보수 기본 CRUD ───────────────────── 2일 └─► 04-P1: 인증 환경 설정 ───────────────────────── 1일 │ ├─► 04-P2: 비밀번호 인증 ──────────────────── 1.5일 │ │ │ └─► 04-P3: Google OAuth ─────────────── 1.5일 │ │ │ ├─► 04-P4: 비밀번호 찾기 ──────── 1일 │ │ │ │ │ └─► 04-P5: 로그인 UI ────── 1일 │ │ │ │ │ └─► 05-P1: Synology API ─ 1.5일 │ │ │ │ │ └─► 05-P2: UI + 테스트 ─ 1일 │ │ │ └─► 06-P1: OAuth Scope 확장 ───── 2일 │ │ │ └─► 06-P2: 그룹 게시물 조회 ─ 3일 │ │ │ └─► 06-P3: 주간보고 공유 ─ 3일 │ │ │ └─► 06-P4: 테스트 ─── 2일 │ ├─► 01-P2: AI 분석 연동 ─────────────────────────── 2일 │ │ │ └─► 01-P3: TODO 기능 ──────────────────────── 2일 │ │ │ └─► 01-P4: 주간보고 연계 ────────────── 1일 │ ├─► 02-P2: 프로젝트-사업 연결 ───────────────────── 1일 │ │ │ └─► 02-P3: 사업 주간보고 취합 ─────────────── 1.5일 │ │ │ └─► 02-P4: 테스트 ───────────────────── 0.5일 │ ├─► 03-P2: 파일 업로드 + AI 파싱 ────────────────── 2일 │ │ │ └─► 03-P3: 주간보고 연계 ──────────────────── 2일 │ │ │ └─► 03-P4: 통계 + 테스트 ────────────── 1일 │ └─► 07-P1: VCS 서버/계정 관리 ───────────────────── 3일 │ └─► 07-P2: 저장소 관리 ────────────────────── 2일 │ ├─► 07-P3: Git 커밋 수집 ────────────── 3일 │ └─► 07-P4: SVN 커밋 수집 ────────────── 3일 │ └─► 07-P5: 커밋 조회 화면 ──────── 3일 │ └─► 07-P6: 자동화 + 테스트 ── 2일 ``` --- ## 3. 단계별 상세 실행 계획 ### 📍 STAGE 0: 통합 DB 마이그레이션 (0.5일) > **목표**: 모든 테이블을 한 번에 생성하여 이후 작업 효율화 | 순번 | Phase ID | 작업 내용 | 소요 | |:----:|:--------:|----------|:----:| | 1 | **00** | 16개 테이블 + ALTER 통합 DDL 실행 | 0.5일 | **생성 테이블 목록**: ```sql -- 01. 회의록/TODO wr_meeting, wr_meeting_attendee, wr_meeting_agenda, wr_todo -- 02. 사업 wr_business, wr_business_weekly_report ALTER wr_project_info ADD business_id -- 03. 유지보수 wr_maintenance_task, wr_maintenance_upload_batch -- 04~06. 인증/그룹 ALTER wr_employee_info ADD password_hash, google_*, synology_*, token_* wr_login_history, wr_google_group, wr_report_group_share -- 07. VCS wr_vcs_server, wr_employee_vcs_account, wr_repository, wr_commit_log ``` **완료 기준**: 모든 테이블 생성 확인, FK 관계 검증 --- ### 📍 STAGE 1: 기반 구축 - 병렬 진행 (1주차) > **목표**: 독립적인 기본 CRUD 4개 동시 진행 | 순번 | Phase ID | 작업 내용 | 소요 | 담당 | |:----:|:--------:|----------|:----:|:----:| | 2 | **01-P1** | 회의록 기본 구조 (Tiptap, CRUD) | 2일 | A | | 3 | **02-P1** | 사업 CRUD | 1.5일 | B | | 4 | **03-P1** | 유지보수 기본 CRUD | 2일 | C | | 5 | **04-P1** | 인증 환경 설정 (환경변수, Google Console) | 1일 | D | **병렬 진행 가능**: ✅ 4개 모두 독립적 **완료 기준**: - [ ] 01-P1: 회의록 목록/작성/상세 화면 동작 - [ ] 02-P1: 사업 목록/등록/수정/삭제 동작 - [ ] 03-P1: 유지보수 목록/등록/상세/상태변경 동작 - [ ] 04-P1: Google OAuth 콘솔 설정 완료, 환경변수 설정 --- ### 📍 STAGE 2: 인증 체계 구축 (1~2주차) > **목표**: Gmail OAuth 완성 → Synology SSO 확장 | 순번 | Phase ID | 작업 내용 | 소요 | 선행 | |:----:|:--------:|----------|:----:|:----:| | 6 | **04-P2** | 비밀번호 인증 (bcrypt) | 1.5일 | 04-P1 | | 7 | **04-P3** | Google OAuth 연동 | 1.5일 | 04-P2 | | 8 | **04-P4** | 비밀번호 찾기 + 이메일 발송 | 1일 | 04-P3 | | 9 | **04-P5** | 로그인 UI + 테스트 | 1일 | 04-P4 | | 10 | **05-P1** | Synology SSO API | 1.5일 | **04-P5** | | 11 | **05-P2** | Synology UI + 테스트 | 1일 | 05-P1 | **병렬 진행 가능**: ❌ 순차 진행 필수 (의존성) **완료 기준**: - [ ] 04-P5: Google 로그인/비밀번호 로그인 모두 동작 - [ ] 05-P2: Synology 로그인 동작, 마이페이지 계정 연결 표시 --- ### 📍 STAGE 3: 핵심 기능 개발 - 병렬 진행 (2~3주차) > **목표**: AI 연동 기능 3개 + VCS 기반 동시 진행 | 순번 | Phase ID | 작업 내용 | 소요 | 선행 | 담당 | |:----:|:--------:|----------|:----:|:----:|:----:| | 12 | **01-P2** | 회의록 AI 분석 연동 | 2일 | 01-P1 | A | | 13 | **02-P2** | 프로젝트-사업 연결 | 1일 | 02-P1 | B | | 14 | **03-P2** | 파일 업로드 + AI 파싱 | 2일 | 03-P1 | C | | 15 | **07-P1** | VCS 서버/계정 관리 | 3일 | 00 | D | **병렬 진행 가능**: ✅ 4개 모두 병렬 가능 **완료 기준**: - [ ] 01-P2: 회의록 저장 → AI 분석 → 결과 표시 - [ ] 02-P2: 프로젝트에 사업 배정, 주간보고에 사업명 표시 - [ ] 03-P2: 엑셀 업로드 → AI 파싱 → 검토 화면 표시 - [ ] 07-P1: VCS 서버 관리, 마이페이지 계정 설정 --- ### 📍 STAGE 4: 핵심 기능 심화 (3~4주차) > **목표**: 각 기능의 핵심 로직 완성 | 순번 | Phase ID | 작업 내용 | 소요 | 선행 | 담당 | |:----:|:--------:|----------|:----:|:----:|:----:| | 16 | **01-P3** | TODO 기능 | 2일 | 01-P2 | A | | 17 | **02-P3** | 사업 주간보고 AI 취합 | 1.5일 | 02-P2 | B | | 18 | **03-P3** | 유지보수-주간보고 연계 | 2일 | 03-P2 | C | | 19 | **07-P2** | 저장소 관리 CRUD | 2일 | 07-P1 | D | **병렬 진행 가능**: ✅ 4개 모두 병렬 가능 **완료 기준**: - [ ] 01-P3: TODO 목록/상태변경/담당자지정 - [ ] 02-P3: 사업별 주간보고 AI 취합 생성 - [ ] 03-P3: 주간보고 작성 시 유지보수 업무 연계 - [ ] 07-P2: 프로젝트 상세에서 저장소 추가/수정/삭제 --- ### 📍 STAGE 5: VCS 연동 + 구글 그룹 (4~5주차) > **목표**: 외부 시스템 연동 완성 | 순번 | Phase ID | 작업 내용 | 소요 | 선행 | 담당 | |:----:|:--------:|----------|:----:|:----:|:----:| | 20 | **06-P1** | OAuth Scope 확장 + 토큰 저장 | 2일 | **04-P5** | A | | 21 | **07-P3** | Git 커밋 수집 | 3일 | 07-P2 | B | | 22 | **07-P4** | SVN 커밋 수집 | 3일 | 07-P2 | C | **병렬 진행**: - 06-P1 ↔ 07-P3, 07-P4 병렬 가능 - 07-P3 ↔ 07-P4 병렬 가능 **완료 기준**: - [ ] 06-P1: Gmail API 토큰 저장, 갱신 로직 - [ ] 07-P3: Git 저장소 커밋 수집 → DB 저장 - [ ] 07-P4: SVN 저장소 커밋 수집 → DB 저장 --- ### 📍 STAGE 6: 기능 연결 및 UI (5~6주차) > **목표**: 각 기능의 UI 완성 및 연계 | 순번 | Phase ID | 작업 내용 | 소요 | 선행 | |:----:|:--------:|----------|:----:|:----:| | 23 | **01-P4** | 주간보고-TODO 연계 | 1일 | 01-P3 | | 24 | **02-P4** | 사업 테스트 | 0.5일 | 02-P3 | | 25 | **03-P4** | 유지보수 통계 + 테스트 | 1일 | 03-P3 | | 26 | **06-P2** | 그룹 게시물 조회 | 3일 | 06-P1 | | 27 | **07-P5** | 커밋 조회 화면 | 3일 | 07-P3, 07-P4 | **완료 기준**: - [ ] 01-P4: 주간보고 작성 시 유사 TODO 팝업 - [ ] 02-P4: 사업 전체 플로우 검증 - [ ] 03-P4: 통계 대시보드 표시 - [ ] 06-P2: 그룹 게시물 목록/상세 조회 - [ ] 07-P5: 프로젝트 커밋 조회 페이지, 주간보고 커밋 참고 --- ### 📍 STAGE 7: 마무리 (6~7주차) > **목표**: 남은 기능 완성 + 전체 테스트 | 순번 | Phase ID | 작업 내용 | 소요 | 선행 | |:----:|:--------:|----------|:----:|:----:| | 28 | **06-P3** | 주간보고 그룹 공유 | 3일 | 06-P2 | | 29 | **06-P4** | 구글 그룹 테스트 | 2일 | 06-P3 | | 30 | **07-P6** | VCS 자동화 + 테스트 | 2일 | 07-P5 | **완료 기준**: - [ ] 06-P4: 그룹 공유 전체 플로우 검증 - [ ] 07-P6: Cron 자동 동기화, 인증 암호화 --- ### 📍 STAGE 8: 통합 테스트 (7~8주차) > **목표**: 전체 시스템 통합 테스트 및 버그 수정 | 순번 | 작업 내용 | 소요 | |:----:|----------|:----:| | 31 | 전체 기능 통합 테스트 | 3일 | | 32 | 버그 수정 및 최적화 | 2일 | | 33 | 문서화 및 배포 준비 | 1일 | --- ## 4. 간트 차트 (주차별) ``` Week 1 2 3 4 5 6 7 8 ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Stage 0 ██ DB 마이그레이션 ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 01 회의 ████████████████████████ 회의록+TODO 02 사업 ████████████████ 사업-프로젝트 03 유지 ████████████████████████ 유지보수 04 OAuth████████████████████ Gmail OAuth 05 Syno ████████ Synology SSO 06 그룹 ████████████████████████ 구글 그룹 07 VCS ████████████████████████████████████████ SVN/Git ┃ ┃ ┃ ┃ ┃ ┃ ┃ ┃ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 통합테스트 ████████████ ``` --- ## 5. 단독 실행 가능 Phase (빠른 성과) ### 5.1 즉시 실행 가능 (의존성 없음) ⭐ | 순위 | Phase | 작업 내용 | 소요 | 난이도 | |:----:|:-----:|----------|:----:|:------:| | 1 | 00 | 통합 DB 마이그레이션 | 0.5일 | ⭐ | | 2 | 02-P1 | 사업 CRUD | 1.5일 | ⭐ | | 3 | 04-P1 | 인증 환경 설정 | 1일 | ⭐ | | 4 | 03-P1 | 유지보수 기본 CRUD | 2일 | ⭐⭐ | | 5 | 01-P1 | 회의록 기본 구조 | 2일 | ⭐⭐ | ### 5.2 선행 1개만 필요 (빠른 진행) | 순위 | Phase | 작업 내용 | 소요 | 선행 | 난이도 | |:----:|:-----:|----------|:----:|:----:|:------:| | 6 | 02-P2 | 프로젝트-사업 연결 | 1일 | 02-P1 | ⭐ | | 7 | 04-P2 | 비밀번호 인증 | 1.5일 | 04-P1 | ⭐⭐ | | 8 | 07-P1 | VCS 서버/계정 관리 | 3일 | 00 | ⭐⭐ | | 9 | 01-P3 | TODO 기능 | 2일 | 01-P2 | ⭐⭐ | ### 5.3 복사해서 빠르게 (04 완료 후) | 순위 | Phase | 작업 내용 | 소요 | 선행 | 비고 | |:----:|:-----:|----------|:----:|:----:|:----:| | 10 | 05-P1~P2 | Synology SSO 전체 | 2.5일 | 04 완료 | 04 코드 90% 재사용 | --- ## 6. 자동화 대상 ### 6.1 DB 관련 (Phase 00) - [ ] 통합 DDL 스크립트 생성 - [ ] 마이그레이션 롤백 스크립트 ### 6.2 CRUD API 템플릿 - [ ] 목록/상세/생성/수정/삭제 공통 패턴 - [ ] 적용 대상: meeting, business, maintenance, vcs-server, repository ### 6.3 Vue 컴포넌트 템플릿 - [ ] 목록 페이지 (필터 + 테이블/카드) - [ ] 상세/수정 페이지 - [ ] 모달 컴포넌트 ### 6.4 OAuth 공통 모듈 - [ ] OAuth 시작/콜백 공통 함수 - [ ] 토큰 저장/갱신 유틸 ### 6.5 AI 프롬프트 모듈 - [ ] OpenAI 호출 공통 함수 - [ ] 프롬프트 템플릿 관리 --- ## 7. 리스크 관리 ### 7.1 기술 리스크 | 리스크 | 영향 | 대응 방안 | |--------|:----:|----------| | Google OAuth 민감 scope 승인 지연 | 06 지연 | 내부용 먼저, 승인 후 외부 공개 | | SVN 서버 접근 불가 | 07 일부 지연 | Git만 먼저 완성 | | Synology SSO 설정 이슈 | 05 지연 | 문서 기반 사전 테스트 | | AI API 비용 | 운영 | 캐싱, 호출 최소화 | ### 7.2 일정 리스크 | 리스크 | 영향 | 대응 방안 | |--------|:----:|----------| | 개발자 부재 | 전체 지연 | 병렬 작업으로 분산 | | 요구사항 변경 | 해당 기능 지연 | Phase 단위 완료 후 변경 | | 테스트 이슈 | 마무리 지연 | Stage별 테스트로 분산 | --- ## 8. 마일스톤 | 마일스톤 | 목표일 | 완료 기준 | |----------|:------:|----------| | **M1: DB 완료** | 1주차 | 모든 테이블 생성, FK 검증 | | **M2: 기본 CRUD 완료** | 2주차 | 01-P1, 02-P1, 03-P1, 04-P1 완료 | | **M3: 인증 완료** | 3주차 | 04 전체 + 05 전체 완료 | | **M4: AI 연동 완료** | 4주차 | 01-P2, 02-P3, 03-P2 완료 | | **M5: VCS 연동 완료** | 6주차 | 07 전체 완료 | | **M6: 구글 그룹 완료** | 7주차 | 06 전체 완료 | | **M7: 전체 완료** | 8주차 | 통합 테스트 + 배포 | --- ## 9. Phase별 체크리스트 ### Phase 00: 통합 DB 마이그레이션 ✅ 완료 - [x] 시작일: 2026-01-11 완료일: 2026-01-11 소요: 0.5시간 - [x] 01 테이블 4개 생성 (meeting, attendee, agenda, todo) ✅ 기존 존재 - [x] 02 테이블 2개 생성 (business, business_weekly_report) ✅ 기존 존재 - [x] 02 ALTER wr_project_info (business_id 추가) ✅ 기존 존재 - [x] 03 테이블 2개 생성 (maintenance_task, upload_batch) ✅ 기존 존재 - [x] 04 ALTER wr_employee_info (password, google 컬럼) ✅ 기존 존재 - [x] 04 테이블 1개 생성 (login_history) ✅ 기존 존재 - [x] 05 ALTER wr_employee_info (synology 컬럼) ✅ 기존 존재 - [x] 06 ALTER wr_employee_info (token 컬럼) ✅ 기존 존재 - [x] 06 테이블 2개 생성 (google_group, report_group_share) ✅ 기존 존재 - [x] 07 테이블 4개 생성 (vcs_server, vcs_account, repository, commit_log) ✅ commit_log 신규 생성 - [x] 인덱스 생성 확인 ✅ - [x] FK 관계 검증 ✅ --- ### Phase 01-P1: 회의록 기본 구조 ✅ 완료 - [x] 시작일시: 2026-01-11 17:05 종료일시: 2026-01-11 17:45 수행시간: 40분 - [x] Tiptap 에디터 컴포넌트 구성 ⚠️ (textarea로 구현, Tiptap 설치 필요) - [x] 회의록 CRUD API (list, detail, create, update, delete) ✅ - [x] 회의록 목록 페이지 (/meeting) ✅ - [x] 회의록 작성 페이지 (/meeting/write) ✅ - [x] 회의록 상세 페이지 (/meeting/[id]) ✅ - [x] 참석자 선택 (내부/외부) ✅ - [x] 프로젝트/내부업무 구분 ✅ ### Phase 01-P2: AI 분석 연동 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] OpenAI 프롬프트 구현 (회의 정리) - [ ] 저장 시 자동 AI 분석 실행 - [ ] AI 결과 → 안건 테이블 저장 - [ ] AI 결과 → TODO 후보 추출 - [ ] 상세 화면에 AI 분석 결과 표시 - [ ] 재분석 기능 - [ ] 확정 기능 (→ TODO 생성) ### Phase 01-P3: TODO 기능 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] TODO CRUD API - [ ] TODO 목록 페이지 (/todo) - [ ] 내 TODO 필터 - [ ] 상태 변경 (대기/완료/폐기) - [ ] 담당자 지정 - [ ] 프로젝트 연결 ### Phase 01-P4: 주간보고 연계 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] 주간보고 작성 시 유사 TODO 감지 API - [ ] 유사 TODO 팝업 UI - [ ] TODO 완료 연계 처리 - [ ] 테스트 및 버그 수정 --- ### Phase 02-P1: 사업 CRUD ✅ 완료 - [x] 시작일시: 2026-01-11 00:28 KST 종료일시: 2026-01-11 00:31 KST 수행시간: 3분 - [x] 사업 CRUD API (list, detail, create, update, delete) ✅ - [x] 사업 목록 페이지 (/business) ✅ - [x] 사업 상세 페이지 (/business/[id]) ✅ - [x] 사업 등록/수정 모달 ✅ - [ ] 메뉴 권한 설정 (매니저 이상) ⏳ 추후 ### Phase 02-P2: 프로젝트-사업 연결 ✅ 완료 - [x] 시작일시: 2026-01-11 01:02 KST 종료일시: 2026-01-11 01:08 KST 수행시간: 6분 - [x] 프로젝트 수정 화면에 사업 선택 추가 ✅ - [x] 프로젝트 배정 API (business_id 필드) ✅ - [x] 사업 상세에 소속 프로젝트 목록 ✅ - [x] 주간보고 작성 시 사업명 표시 ⏳ 추후 ### Phase 02-P3: 사업 주간보고 취합 ✅ 완료 - [x] 시작일시: 2026-01-11 01:10 KST 종료일시: 2026-01-11 01:18 KST 수행시간: 8분 - [x] OpenAI 프롬프트 구현 (취합 요약) ✅ - [x] 사업 주간보고 취합 API ✅ - [x] 사업 주간보고 상세 페이지 ✅ - [x] 확정 기능 ✅ ### Phase 02-P4: 테스트 ✅ 완료 - [x] 시작일시: 2026-01-11 01:20 KST 종료일시: 2026-01-11 01:24 KST 수행시간: 4분 - [x] 전체 플로우 테스트 ✅ - [x] 기존 취합보고와 연계 확인 ✅ - [x] 버그 수정 (없음) ✅ --- ### Phase 03-P1: 유지보수 기본 CRUD ✅ 완료 - [x] 시작일시: 2026-01-11 00:51 KST 종료일시: 2026-01-11 00:56 KST 수행시간: 5분 - [x] 유지보수 CRUD API ✅ - [x] 목록 페이지 (/maintenance) ✅ - [x] 상세 페이지 (/maintenance/[id]) ✅ - [x] 등록/수정 화면 ✅ - [x] 상태 변경 기능 ✅ - [x] 반영 체크 (개발/운영/고객확인) ✅ ### Phase 03-P2: 파일 업로드 + AI 파싱 ✅ 완료 - [x] 시작일시: 2026-01-11 01:26 KST 종료일시: 2026-01-11 01:33 KST 수행시간: 7분 - [x] 파일 업로드 API (엑셀/CSV) ✅ - [x] SheetJS 연동 ✅ (npm install xlsx 필요) - [x] OpenAI 프롬프트 구현 (파싱) ✅ - [x] 파싱 결과 검토 화면 ✅ - [x] 중복 감지 로직 ✅ - [x] 일괄 등록 기능 ✅ ### Phase 03-P3: 주간보고 연계 🔄 진행중 - [x] 시작일시: 2026-01-11 01:35 KST 종료일시: ____ 수행시간: ____ - [ ] 주간보고 작성 시 유지보수 업무 조회 API - [ ] OpenAI 프롬프트 (실적 문장 생성) - [ ] 유사 실적 병합 기능 - [ ] 연계 정보 저장 - [ ] 주간보고 작성 화면 수정 ### Phase 03-P4: 통계 + 테스트 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] 통계 API (주간/월간/담당자별) - [ ] 통계 대시보드 페이지 - [ ] 전체 테스트 및 버그 수정 --- ### Phase 04-P1: 인증 환경 설정 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] Google Cloud Console OAuth 설정 - [ ] 환경 변수 설정 (GOOGLE_*, SMTP_*) - [ ] wr_employee_info 컬럼 추가 완료 확인 ### Phase 04-P2: 비밀번호 인증 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] bcrypt 해시 처리 유틸 - [ ] 이메일/비밀번호 로그인 API - [ ] 비밀번호 변경 API - [ ] 비밀번호 초기화 API (관리자) ### Phase 04-P3: Google OAuth - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] Google OAuth 시작 API (/api/auth/google) - [ ] Google 콜백 API (/api/auth/google/callback) - [ ] 사용자 매칭 로직 (email 기준) - [ ] 비밀번호 미설정 시 리다이렉트 ### Phase 04-P4: 비밀번호 찾기 + 이메일 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] nodemailer 설정 - [ ] 이메일 발송 유틸 - [ ] 비밀번호 찾기 API (이름+이메일+핸드폰) - [ ] 임시 비밀번호 생성 및 발송 - [ ] 비밀번호 찾기 페이지 ### Phase 04-P5: 로그인 UI + 테스트 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] 로그인 페이지 수정 (OAuth + 비밀번호) - [ ] 비밀번호 설정 페이지 - [ ] 로그인 실패 페이지 - [ ] 마이페이지 비밀번호 변경 UI - [ ] 관리자 사용자 관리 수정 - [ ] 전체 플로우 테스트 --- ### Phase 05-P1: Synology SSO API - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] Synology SSO Server 애플리케이션 등록 - [ ] 환경 변수 설정 (SYNOLOGY_*) - [ ] Synology OAuth 시작 API (/api/auth/synology) - [ ] Synology 콜백 API (/api/auth/synology/callback) - [ ] 사용자 매칭 로직 ### Phase 05-P2: Synology UI + 테스트 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] 로그인 페이지에 Synology 버튼 추가 - [ ] 마이페이지 외부 계정 연결 표시 - [ ] 로그인 이력에 login_type 기록 - [ ] 전체 플로우 테스트 --- ### Phase 06-P1: OAuth Scope 확장 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] Google Cloud Console scope 추가 (gmail.readonly, gmail.send) - [ ] wr_employee_info 토큰 컬럼 확인 - [ ] OAuth 콜백에서 토큰 저장 - [ ] 토큰 갱신 로직 ### Phase 06-P2: 그룹 게시물 조회 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] wr_google_group 테이블에 그룹 등록 - [ ] 그룹 목록 API - [ ] 그룹 게시물 목록 API (Gmail API 연동) - [ ] 게시물 상세 API - [ ] 그룹 게시물 조회 페이지 (/google-group) ### Phase 06-P3: 주간보고 그룹 공유 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] 그룹 공유 API (Gmail 발송) - [ ] 공유 이력 API - [ ] 이메일 본문 템플릿 - [ ] 주간보고 상세에 공유 UI 추가 ### Phase 06-P4: 테스트 + 마무리 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] 전체 플로우 테스트 - [ ] 토큰 만료 시 갱신 테스트 - [ ] 오류 처리 (권한 없음 등) - [ ] 관리자 그룹 목록 관리 페이지 --- ### Phase 07-P1: VCS 서버/계정 관리 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] VCS 서버 CRUD API (관리자) - [ ] VCS 서버 관리 페이지 (/admin/vcs-server) - [ ] 사용자 VCS 계정 API - [ ] 마이페이지 VCS 계정 설정 UI ### Phase 07-P2: 저장소 관리 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] 저장소 CRUD API - [ ] 프로젝트 상세에 저장소 관리 UI - [ ] 저장소 추가/수정 모달 ### Phase 07-P3: Git 커밋 수집 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] simple-git 패키지 설치 - [ ] Git clone/pull 로직 - [ ] 커밋 로그 파싱 - [ ] 작성자 매칭 (VCS 계정 기반) - [ ] DB 저장 ### Phase 07-P4: SVN 커밋 수집 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] svn CLI 연동 - [ ] svn log 실행 및 XML 파싱 - [ ] 작성자 매칭 - [ ] DB 저장 ### Phase 07-P5: 커밋 조회 화면 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] 프로젝트별 커밋 조회 API - [ ] 프로젝트 커밋 조회 페이지 (/project/[id]/commits) - [ ] 필터 (기간, 저장소, 작성자) - [ ] 주간보고 작성 시 커밋 참고 UI - [ ] 새로고침 버튼 ### Phase 07-P6: 자동화 + 테스트 - [ ] 시작일: ____ 완료일: ____ 소요: ____ - [ ] Cron Job 설정 (매일 새벽 자동 동기화) - [ ] 인증 정보 암호화 - [ ] 전체 플로우 테스트 - [ ] 오류 처리 --- ## 10. 작업 완료 결과 요약 ### 전체 Phase별 시간 기록 | Stage | Phase ID | 작업 내용 | 시작 | 완료 | 소요시간 | |:-----:|:--------:|----------|:----:|:----:|:--------:| | 0 | 00 | 통합 DB 마이그레이션 | 01-11 | 01-11 | 0.5h ✅ | | 1 | 01-P1 | 회의록 기본 구조 | 01-11 17:05 | 01-11 17:45 | 40분 ✅ | | 1 | 02-P1 | 사업 CRUD | 01-11 00:28 | 01-11 00:31 | 3분 ✅ | | 1 | 03-P1 | 유지보수 기본 CRUD | 01-11 00:51 | 01-11 00:56 | 5분 ✅ | | 1 | 04-P1 | 인증 환경 설정 | - | - | - | | 2 | 04-P2 | 비밀번호 인증 | - | - | - | | 2 | 04-P3 | Google OAuth | - | - | - | | 2 | 04-P4 | 비밀번호 찾기 | - | - | - | | 2 | 04-P5 | 로그인 UI | - | - | - | | 2 | 05-P1 | Synology API | - | - | - | | 2 | 05-P2 | Synology UI | - | - | - | | 3 | 01-P2 | AI 분석 연동 | - | - | - | | 3 | 02-P2 | 프로젝트-사업 연결 | - | - | - | | 3 | 03-P2 | 파일 업로드 + AI 파싱 | - | - | - | | 3 | 07-P1 | VCS 서버/계정 관리 | - | - | - | | 4 | 01-P3 | TODO 기능 | - | - | - | | 4 | 02-P3 | 사업 주간보고 취합 | - | - | - | | 4 | 03-P3 | 유지보수-주간보고 연계 | - | - | - | | 4 | 07-P2 | 저장소 관리 | - | - | - | | 5 | 06-P1 | OAuth Scope 확장 | - | - | - | | 5 | 07-P3 | Git 커밋 수집 | - | - | - | | 5 | 07-P4 | SVN 커밋 수집 | - | - | - | | 6 | 01-P4 | 주간보고-TODO 연계 | - | - | - | | 6 | 02-P4 | 사업 테스트 | - | - | - | | 6 | 03-P4 | 유지보수 통계 | - | - | - | | 6 | 06-P2 | 그룹 게시물 조회 | - | - | - | | 6 | 07-P5 | 커밋 조회 화면 | - | - | - | | 7 | 06-P3 | 주간보고 그룹 공유 | - | - | - | | 7 | 06-P4 | 구글 그룹 테스트 | - | - | - | | 7 | 07-P6 | VCS 자동화 | - | - | - | | 8 | - | 통합 테스트 | - | - | - | | | | | | **총 소요시간** | **-** | --- ### 마일스톤 달성 현황 | 마일스톤 | 목표일 | 실제 완료일 | 상태 | |----------|:------:|:----------:|:----:| | M1: DB 완료 | 1주차 | 2026-01-11 | ✅ | | M2: 기본 CRUD 완료 | - | - | ⬜ | | M3: 인증 완료 | - | - | ⬜ | | M4: AI 연동 완료 | - | - | ⬜ | | M5: VCS 연동 완료 | - | - | ⬜ | | M6: 구글 그룹 완료 | - | - | ⬜ | | M7: 전체 완료 | - | - | ⬜ | --- ## 11. 참조 문서 | # | 문서명 | 파일명 | |:-:|--------|--------| | 01 | 회의록 + TODO 작업계획서 | 01_회의록_TODO_작업계획서.md | | 02 | 사업-프로젝트 계층 작업계획서 | 02_사업_프로젝트_계층구조_작업계획서.md | | 03 | 유지보수 업무관리 작업계획서 | 03_유지보수_업무관리_작업계획서.md | | 04 | Gmail OAuth 로그인 작업계획서 | 04_Gmail_OAuth_로그인_작업계획서.md | | 05 | Synology SSO 연동 작업계획서 | 05_Synology_SSO_연동_작업계획서.md | | 06 | 구글 그룹 연동 작업계획서 | 06_구글그룹_연동_작업계획서.md | | 07 | SVN/Git 커밋 연동 작업계획서 | 07_SVN_Git_커밋내역_연동_작업계획서.md | --- ## 변경 이력 | 버전 | 날짜 | 변경 내용 | 작성자 | |:----:|:----:|----------|:------:| | 1.0 | 2026-01-10 | 최초 작성 | - |