31 KiB
31 KiB
주간보고 시스템 마스터 작업계획서
작성일: 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일 |
생성 테이블 목록:
-- 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 마이그레이션 ✅ 완료
- 시작일: 2026-01-11 완료일: 2026-01-11 소요: 0.5시간
- 01 테이블 4개 생성 (meeting, attendee, agenda, todo) ✅ 기존 존재
- 02 테이블 2개 생성 (business, business_weekly_report) ✅ 기존 존재
- 02 ALTER wr_project_info (business_id 추가) ✅ 기존 존재
- 03 테이블 2개 생성 (maintenance_task, upload_batch) ✅ 기존 존재
- 04 ALTER wr_employee_info (password, google 컬럼) ✅ 기존 존재
- 04 테이블 1개 생성 (login_history) ✅ 기존 존재
- 05 ALTER wr_employee_info (synology 컬럼) ✅ 기존 존재
- 06 ALTER wr_employee_info (token 컬럼) ✅ 기존 존재
- 06 테이블 2개 생성 (google_group, report_group_share) ✅ 기존 존재
- 07 테이블 4개 생성 (vcs_server, vcs_account, repository, commit_log) ✅ commit_log 신규 생성
- 인덱스 생성 확인 ✅
- FK 관계 검증 ✅
Phase 01-P1: 회의록 기본 구조 ✅ 완료
- 시작일시: 2026-01-11 17:05 종료일시: 2026-01-11 17:45 수행시간: 40분
- Tiptap 에디터 컴포넌트 구성 ⚠️ (textarea로 구현, Tiptap 설치 필요)
- 회의록 CRUD API (list, detail, create, update, delete) ✅
- 회의록 목록 페이지 (/meeting) ✅
- 회의록 작성 페이지 (/meeting/write) ✅
- 회의록 상세 페이지 (/meeting/[id]) ✅
- 참석자 선택 (내부/외부) ✅
- 프로젝트/내부업무 구분 ✅
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 ✅ 완료
- 시작일시: 2026-01-11 00:28 KST 종료일시: 2026-01-11 00:31 KST 수행시간: 3분
- 사업 CRUD API (list, detail, create, update, delete) ✅
- 사업 목록 페이지 (/business) ✅
- 사업 상세 페이지 (/business/[id]) ✅
- 사업 등록/수정 모달 ✅
- 메뉴 권한 설정 (매니저 이상) ⏳ 추후
Phase 02-P2: 프로젝트-사업 연결 ✅ 완료
- 시작일시: 2026-01-11 01:02 KST 종료일시: 2026-01-11 01:08 KST 수행시간: 6분
- 프로젝트 수정 화면에 사업 선택 추가 ✅
- 프로젝트 배정 API (business_id 필드) ✅
- 사업 상세에 소속 프로젝트 목록 ✅
- 주간보고 작성 시 사업명 표시 ⏳ 추후
Phase 02-P3: 사업 주간보고 취합 ✅ 완료
- 시작일시: 2026-01-11 01:10 KST 종료일시: 2026-01-11 01:18 KST 수행시간: 8분
- OpenAI 프롬프트 구현 (취합 요약) ✅
- 사업 주간보고 취합 API ✅
- 사업 주간보고 상세 페이지 ✅
- 확정 기능 ✅
Phase 02-P4: 테스트 ✅ 완료
- 시작일시: 2026-01-11 01:20 KST 종료일시: 2026-01-11 01:24 KST 수행시간: 4분
- 전체 플로우 테스트 ✅
- 기존 취합보고와 연계 확인 ✅
- 버그 수정 (없음) ✅
Phase 03-P1: 유지보수 기본 CRUD ✅ 완료
- 시작일시: 2026-01-11 00:51 KST 종료일시: 2026-01-11 00:56 KST 수행시간: 5분
- 유지보수 CRUD API ✅
- 목록 페이지 (/maintenance) ✅
- 상세 페이지 (/maintenance/[id]) ✅
- 등록/수정 화면 ✅
- 상태 변경 기능 ✅
- 반영 체크 (개발/운영/고객확인) ✅
Phase 03-P2: 파일 업로드 + AI 파싱 ✅ 완료
- 시작일시: 2026-01-11 01:26 KST 종료일시: 2026-01-11 01:33 KST 수행시간: 7분
- 파일 업로드 API (엑셀/CSV) ✅
- SheetJS 연동 ✅ (npm install xlsx 필요)
- OpenAI 프롬프트 구현 (파싱) ✅
- 파싱 결과 검토 화면 ✅
- 중복 감지 로직 ✅
- 일괄 등록 기능 ✅
Phase 03-P3: 주간보고 연계 🔄 진행중
- 시작일시: 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 | 최초 작성 | - |