diff --git a/docs/리포트_관리_시스템_구현_완료_기능.md b/docs/리포트_관리_시스템_구현_완료_기능.md new file mode 100644 index 00000000..69ad5670 --- /dev/null +++ b/docs/리포트_관리_시스템_구현_완료_기능.md @@ -0,0 +1,1033 @@ +# 리포트 관리 시스템 - 구현 완료 기능 + +## 📋 목차 + +1. [리포트 목록 관리](#1-리포트-목록-관리) +2. [리포트 디자이너](#2-리포트-디자이너) +3. [쿼리 관리](#3-쿼리-관리) +4. [컴포넌트 시스템](#4-컴포넌트-시스템) +5. [레이아웃 도구](#5-레이아웃-도구) +6. [템플릿 시스템](#6-템플릿-시스템) +7. [페이지 관리](#7-페이지-관리) +8. [미리보기 및 출력](#8-미리보기-및-출력) + +--- + +## 1. 리포트 목록 관리 + +### 1.1 리포트 목록 화면 + +- **경로**: `/admin/report` +- **기능**: + - 전체 리포트 목록 조회 + - 검색 필터링 (리포트명) + - 정렬 (생성일, 수정일) + +### 1.2 리포트 기본 관리 + +- 리포트 생성 +- 리포트 수정 +- 리포트 복사 +- 리포트 삭제 +- 리포트 상세 정보 표시 + +### 1.3 UI 개선사항 + +- 타입 컬럼 제거 (디자인 간소화) +- 복사/삭제 액션 추가 + +--- + +## 2. 리포트 디자이너 + +### 2.1 기본 구조 + +- **경로**: `/admin/report/designer/[reportId]` +- **레이아웃**: + - 좌측: 페이지 목록 패널 + - 중앙 좌측: 컴포넌트 팔레트 + - 중앙: 캔버스 + - 우측: 속성/쿼리/페이지 설정 패널 (탭) + +### 2.2 캔버스 기능 + +- 드래그 앤 드롭으로 컴포넌트 배치 +- 컴포넌트 선택/이동/크기 조절 +- 그리드 스냅 (10px 단위) +- 정렬 가이드라인 (빨간색 라인) +- 캔버스 중심선 가이드 +- 눈금자 표시 (상단/좌측) +- 페이지 여백 가이드 (파란색 점선) +- 컴포넌트가 여백 밖으로 나가지 않도록 제한 + +### 2.3 컴포넌트 조작 + +- 다중 선택 (Ctrl/Cmd + 클릭) +- 복사/붙여넣기 (Ctrl/Cmd + C/V) +- 실행 취소/재실행 (Ctrl/Cmd + Z/Y) +- 키보드 화살표 이동 (1px, Shift + 10px) +- 컴포넌트 잠금/해제 +- 레이어 순서 조정 (맨 앞/뒤, 앞/뒤로) + +### 2.4 정렬 도구 + +- **그룹 정렬**: + - 왼쪽/오른쪽/상단/하단 정렬 + - 수평/수직 중앙 정렬 +- **분산**: + - 수평 분산 + - 수직 분산 +- **크기 조정**: + - 너비 맞춤 + - 높이 맞춤 + - 크기 맞춤 (너비+높이) + +### 2.5 컴포넌트 그룹화 + +- 여러 컴포넌트를 그룹으로 묶기 +- 그룹 해제 +- 그룹 단위 이동 + +--- + +## 3. 쿼리 관리 + +### 3.1 쿼리 목록 + +- **UI**: 아코디언 방식 (피그마 스타일) +- 쿼리 추가/삭제 +- 쿼리 타입: MASTER (1건) / DETAIL (반복) +- 부드러운 열기/닫기 애니메이션 + +### 3.2 쿼리 설정 + +- 쿼리 이름 설정 +- SQL 쿼리 입력 (Textarea) +- DB 연결 선택: + - 내부 DB (PostgreSQL) + - 외부 DB 연결 선택 + +### 3.3 파라미터 관리 + +- 자동 파라미터 감지 (`$1`, `$2` 등) +- 작은따옴표 내부 파라미터 무시 +- 파라미터 타입 설정 (텍스트/숫자/날짜) +- 파라미터 입력 필드 동적 생성 +- 등장 순서대로 정렬 + +### 3.4 쿼리 실행 및 검증 + +- SQL 안전성 검증: + - SELECT/WITH 쿼리만 허용 + - 위험한 명령어 차단 (DELETE, DROP, UPDATE 등) + - 단일 쿼리만 실행 가능 +- 실행 버튼 (빨간색) +- 파라미터 미입력 시 실행 버튼 비활성화 +- 실행 결과 표시 (필드명, 데이터 건수) +- 실행 결과 Context에 저장 + +### 3.5 외부 DB 연동 + +- 외부 DB 연결 목록 조회 +- 쿼리별 외부 DB 선택 가능 +- PostgreSQL, MariaDB, MSSQL, Oracle 지원 + +--- + +## 4. 컴포넌트 시스템 + +### 4.1 Text 컴포넌트 + +- 기본 텍스트 표시 +- 쿼리 필드 바인딩 +- 스타일 설정: + - 글꼴 크기 + - 글꼴 색상 + - 글꼴 굵기 (보통/굵게) + - 텍스트 정렬 (왼쪽/가운데/오른쪽) + - 배경색 + - 테두리 (두께, 색상) + +### 4.2 Label 컴포넌트 + +- 고정 텍스트 레이블 +- Text와 동일한 스타일 옵션 + +### 4.3 Image 컴포넌트 + +- 이미지 파일 업로드 (로컬 파일) +- 이미지 표시 옵션: + - Contain (원본 비율 유지) + - Cover (영역 채우기) + - Fill (늘려서 채우기) +- 테두리 설정 + +### 4.4 Divider 컴포넌트 + +- 구분선 표시 +- 방향: 수평/수직 +- 선 스타일: 실선/점선/이중선 +- 선 두께 설정 +- 선 색상 설정 + +### 4.5 Signature (서명란) 컴포넌트 + +- 서명 이미지 업로드 +- 직접 서명 그리기 (마우스 드로잉) +- 탭 방식 전환 (직접 서명/이미지 업로드) +- 서명란 밑줄 표시 옵션 +- 레이블 표시 (서명:) +- 레이블 위치 (좌/우/상/하) +- 기본 테두리 없음 + +### 4.6 Stamp (도장란) 컴포넌트 + +- 도장 이미지 업로드 +- 이름 입력 (좌측 표시) +- "(인)" 레이블 표시/숨김 +- 레이블이 도장 이미지와 겹침 +- 기본 테두리 없음 + +### 4.7 Table 컴포넌트 + +- 쿼리 결과를 테이블로 표시 +- 자동 컬럼 생성 (쿼리 필드 기반) +- 컬럼 설정: + - 필드명 + - 헤더명 + - 너비 + - 정렬 (좌/가운데/우) +- 테이블 스타일: + - 헤더 배경색 + - 헤더 텍스트 색상 + - 테두리 표시/숨김 + - 행 높이 +- 캔버스에서 전체 데이터 표시 (최대 20행 + "외 N건") + +### 4.8 컴포넌트 공통 기능 + +- 위치 (X, Y) +- 크기 (너비, 높이) +- 배경색 +- 테두리 (두께, 색상) +- Z-index (레이어 순서) +- 잠금 상태 + +--- + +## 5. 레이아웃 도구 + +### 5.1 그리드 스냅 + +- 10px 단위 그리드 스냅 +- 컴포넌트 배치/크기 조절 시 자동 적용 + +### 5.2 정렬 가이드라인 + +- 드래그 중 다른 컴포넌트와 정렬 시 빨간색 라인 표시 +- 정렬 기준: + - 좌측/우측/상단/하단 가장자리 + - 수평/수직 중앙 +- 캔버스 중심선 가이드 + +### 5.3 눈금자 + +- 캔버스 상단/좌측에 눈금자 표시 +- mm 단위 표시 + +### 5.4 레이어 관리 + +- 컴포넌트 레이어 순서 조정 +- 맨 앞으로 가져오기 +- 맨 뒤로 보내기 +- 앞으로 가져오기 +- 뒤로 보내기 + +### 5.5 컴포넌트 잠금 + +- 선택한 컴포넌트 잠금 +- 잠금 시 이동/크기 조절/삭제 불가 +- 잠금 해제 + +--- + +## 6. 템플릿 시스템 + +### 6.1 시스템 템플릿 + +- 기본 제공 템플릿: + - 구매 요청서 + - 발주서 + - 기본 템플릿 +- 템플릿 적용 시 레이아웃 및 쿼리 자동 로드 + +### 6.2 사용자 정의 템플릿 + +- 현재 레이아웃을 템플릿으로 저장 +- 템플릿 이름, 설명, 카테고리 설정 +- 저장 시 리포트 저장 불필요 +- 저장된 템플릿은 기본 템플릿 목록에 추가 + +--- + +## 7. 페이지 관리 + +### 7.1 페이지 목록 (좌측 패널) + +- 페이지 목록 표시 +- 페이지 이름 표시 +- 페이지 크기 및 컴포넌트 개수 표시 +- 현재 선택된 페이지 하이라이트 + +### 7.2 페이지 조작 + +- 페이지 추가 (무제한) +- 페이지 삭제 (최소 1개 유지) +- 페이지 복제 +- 페이지 이름 변경 (인라인 편집) +- 드래그로 페이지 순서 변경 (GripVertical 핸들) + +### 7.3 페이지 설정 (우측 패널) + +- 페이지 정보: + - 페이지 이름 +- 페이지 크기: + - 너비/높이 (mm) + - 방향 (세로/가로) + - A4 프리셋 (세로/가로) +- 페이지 여백: + - 상단/하단/좌측/우측 (mm) + - 여백 프리셋 (좁게/보통/넓게) + +### 7.4 페이지별 컴포넌트 관리 + +- 각 페이지마다 독립적인 컴포넌트 목록 +- 페이지 전환 시 해당 페이지의 컴포넌트만 표시 +- 컴포넌트는 여백 밖으로 이동 불가 + +### 7.5 데이터 구조 + +- JSONB 기반 페이지 저장 +- 기존 단일 페이지 레이아웃 자동 마이그레이션 +- 하위 호환성 유지 + +--- + +## 8. 미리보기 및 출력 + +### 8.1 미리보기 모달 + +- 모든 페이지 순서대로 렌더링 +- 페이지 번호 및 이름 표시 +- 실제 출력과 동일한 모습 +- 편집 UI 요소 제거 (섹션 라벨, 테두리 등) +- 쿼리 실행 결과 반영 + +### 8.2 인쇄 기능 + +- 브라우저 네이티브 인쇄 대화상자 +- 모든 페이지 인쇄 +- 페이지 나누기 자동 처리 +- 이미지 로드 대기 후 인쇄 + +### 8.3 PDF 출력 + +- 브라우저 인쇄 기능 이용 +- "PDF로 저장" 안내 토스트 + +### 8.4 WORD 출력 + +- `docx` 라이브러리 사용 +- 순차적 흐름 방식 (절대 위치 미지원) +- 텍스트 및 테이블 출력 +- 텍스트 편집 가능 + +### 8.5 출력 옵션 + +- 테이블 헤더: + - 첫 페이지에만 표시 + - 다음 페이지부터 헤더 없이 데이터만 표시 + +--- + +## 9. 기술 스택 + +### 9.1 Frontend + +- **Framework**: Next.js 14 +- **Language**: TypeScript +- **UI Library**: Shadcn UI +- **State Management**: React Context API +- **Drag & Drop**: react-dnd +- **File Upload**: Multer (Backend) +- **Document Export**: docx + +### 9.2 Backend + +- **Runtime**: Node.js +- **Language**: TypeScript +- **Database**: PostgreSQL +- **External DB**: DatabaseConnectorFactory + - PostgreSQL + - MariaDB + - MSSQL + - Oracle + +### 9.3 주요 라이브러리 + +- `lucide-react`: 아이콘 +- `uuid`: 고유 ID 생성 +- `pg`: PostgreSQL 연결 +- `docx`: WORD 문서 생성 + +--- + +## 10. 주요 파일 구조 + +### 10.1 Frontend + +``` +frontend/ +├── app/(main)/admin/report/ +│ ├── page.tsx # 리포트 목록 +│ └── designer/[reportId]/ +│ └── page.tsx # 리포트 디자이너 +├── components/report/ +│ ├── designer/ +│ │ ├── ReportDesignerCanvas.tsx # 캔버스 +│ │ ├── ReportDesignerLeftPanel.tsx # 좌측 패널 +│ │ ├── ReportDesignerRightPanel.tsx # 우측 패널 +│ │ ├── ReportDesignerToolbar.tsx # 툴바 +│ │ ├── PageListPanel.tsx # 페이지 목록 +│ │ ├── QueryManager.tsx # 쿼리 관리 +│ │ ├── CanvasComponent.tsx # 캔버스 컴포넌트 +│ │ ├── ComponentPropertiesPanel.tsx # 속성 패널 +│ │ ├── ReportPreviewModal.tsx # 미리보기 +│ │ └── Ruler.tsx # 눈금자 +│ └── ReportList.tsx # 리포트 목록 +├── contexts/ +│ └── ReportDesignerContext.tsx # 디자이너 Context +├── types/ +│ └── report.ts # 타입 정의 +└── lib/api/ + └── reportApi.ts # API 클라이언트 +``` + +### 10.2 Backend + +``` +backend-node/ +├── src/ +│ ├── controllers/ +│ │ └── reportController.ts # 리포트 컨트롤러 +│ ├── services/ +│ │ └── reportService.ts # 리포트 서비스 +│ ├── routes/ +│ │ └── reportRoutes.ts # 리포트 라우트 +│ └── database/ +│ └── connectors/ # 외부 DB 커넥터 +└── uploads/ # 업로드 파일 +``` + +--- + +## 11. 데이터베이스 스키마 + +### 11.1 주요 테이블 + +- `REPORT`: 리포트 기본 정보 +- `REPORT_LAYOUT`: 레이아웃 설정 (JSONB) +- `REPORT_QUERY`: 쿼리 정보 +- `REPORT_TEMPLATE`: 템플릿 정보 +- `EXTERNAL_DB_CONNECTION`: 외부 DB 연결 정보 + +### 11.2 JSONB 구조 + +```json +{ + "pages": [ + { + "page_id": "uuid", + "page_name": "페이지 1", + "page_order": 0, + "width": 210, + "height": 297, + "orientation": "portrait", + "margins": { + "top": 10, + "bottom": 10, + "left": 10, + "right": 10 + }, + "background_color": "#ffffff", + "components": [ + { + "id": "uuid", + "type": "text", + "x": 50, + "y": 50, + "width": 200, + "height": 30, + "defaultValue": "텍스트", + "queryId": "query_uuid", + "fieldName": "field_name", + "fontSize": 13, + "fontColor": "#000000", + "fontWeight": "normal", + "textAlign": "left", + "backgroundColor": "transparent", + "borderWidth": 0, + "borderColor": "#000000" + } + ] + } + ] +} +``` + +--- + +## 12. 보안 및 검증 + +### 12.1 SQL 인젝션 방지 + +- 파라미터 바인딩 사용 +- 위험한 SQL 명령어 차단 +- SELECT/WITH 쿼리만 허용 +- 단일 쿼리 실행만 가능 + +### 12.2 파일 업로드 보안 + +- 허용된 파일 확장자만 업로드 +- 파일 크기 제한 +- 안전한 파일명 생성 + +### 12.3 권한 관리 + +- 사용자별 리포트 접근 권한 +- 세션 기반 인증 + +--- + +## 13. 개선 예정 기능 + +### 13.1 테이블 페이지 분할 + +- 테이블이 페이지를 넘어갈 때 자동으로 다음 페이지로 분할 +- 현재는 단일 페이지에만 표시 + +### 13.2 기업 사용자를 위한 필수 기능 ⭐ + +> **현재는 기본 기능만 구현되어 있어, 기업 환경에서 사용하기 위해서는 아래 기능들이 추가로 필요합니다.** + +#### A. 보안 및 접근 제어 🔒 + +##### 리포트 권한 관리 + +- **조회 권한**: 부서별/팀별/역할별 조회 권한 설정 +- **수정 권한**: 작성자/관리자/공동 편집자 권한 +- **출력 권한**: 출력 권한 별도 관리, 워터마크 삽입 +- **삭제 권한**: 승인 프로세스, 논리적 삭제 + +##### 데이터 보안 + +- **민감 정보 마스킹**: 주민번호, 계좌번호 등 자동 마스킹 +- **데이터 필터링**: 사용자 권한에 따른 데이터 자동 필터링 +- **쿼리 실행 제한**: 실행 시간, 결과 행 수, 복잡도 제한 + +##### 감사 로그 (Audit Trail) + +- **접근 로그**: 누가, 언제, 어떤 리포트를 조회했는지 기록 +- **수정 로그**: 수정 이력, 버전 관리, 롤백 +- **출력 로그**: 출력 이력, 다운로드 추적 + +#### B. 문서 관리 📄 + +##### 문서 번호 체계 + +- **자동 채번**: 부서별/카테고리별/연도별 고유 번호 자동 부여 + - 예: `SALES-2025-001`, `HR-2025-0001` +- **문서 번호 포맷**: 커스터마이징 가능한 번호 형식 +- **문서 번호 컴포넌트**: 리포트에 문서 번호 자동 삽입, 바코드/QR코드 표시 + +##### 문서 상태 관리 + +- **작성 중** → **검토 중** → **승인 대기** → **승인 완료** / **반려** → **폐기** +- 각 상태별 권한 및 동작 제어 +- 상태 변경 이력 추적 + +##### 문서 생명주기 + +- **보존 기간 설정**: 1년/3년/5년/영구 보존 +- **보존 기간 만료 알림**: 자동 알림 및 보관 이관 +- **보관 문서 관리**: 별도 보관 문서함, 조회 권한 제한 + +#### C. 승인 워크플로우 ✅ + +##### 승인 프로세스 + +- **승인선 설정**: 부서별/직급별 자동 승인선 구성 +- **단계별 승인**: 1차(팀장) → 2차(부서장) → 최종(임원) +- **병렬 승인**: 다수 승인자 동시 승인 +- **승인 알림**: 이메일/시스템/모바일 푸시 알림 + +##### 승인 후 처리 + +- **리포트 잠금**: 승인 완료 후 수정 불가 +- **배포 관리**: 자동 배포, 배포 대상자 지정 +- **승인 이력**: 승인자, 승인 시점, 승인 의견 기록 + +#### D. 협업 기능 👥 + +##### 공유 및 협업 + +- **리포트 공유**: 링크 공유, 특정 사용자 공유, 공유 기간 설정 +- **공동 편집**: 실시간 편집, Lock 기능, 충돌 방지 +- **댓글 및 리뷰**: 컴포넌트별 댓글, 검토 의견 + +##### 템플릿 공유 + +- **템플릿 라이브러리**: 공용 템플릿, 부서별 템플릿 +- **템플릿 승인**: 공용 템플릿 등록 시 승인 필요 +- **템플릿 평점**: 사용자 평가 및 리뷰 + +#### E. 조직 관리 🏢 + +##### 부서/팀 관리 + +- **부서별 리포트**: 부서별 리포트 목록 관리 +- **권한 상속**: 상위 부서 권한 자동 상속 +- **부서 이동 처리**: 부서 이동 시 리포트 이관 + +##### 역할 관리 + +- **역할 정의**: 작성자/검토자/승인자/관리자 +- **역할별 권한**: 조회/생성/수정/삭제 권한 세분화 + +#### F. 규정 준수 (Compliance) ⚖️ + +##### 전자문서법 준수 + +- **전자서명**: 리포트에 전자서명 첨부, 서명 검증 +- **타임스탬프**: 생성/수정/승인 시점 타임스탬프, 위변조 방지 + +##### 개인정보보호법 준수 + +- **개인정보 표시**: 개인정보 포함 여부 표시, 처리 동의 기록 +- **개인정보 파기**: 보존 기간 만료 후 자동 파기, 복구 불가 + +#### G. 통합 및 연동 🔗 + +##### ERP 시스템 연동 + +- **마스터 데이터 연동**: 거래처, 품목, 고객 정보 실시간 동기화 +- **워크플로우 연동**: 구매/영업 프로세스와 연계 + +##### 외부 시스템 연동 + +- **이메일 연동**: 리포트 자동 발송, 승인 알림 +- **클라우드 스토리지**: Google Drive, OneDrive 연동 +- **전자결재 시스템**: SSO 연동, 통합 승인선 + +#### H. 사용자 편의 기능 💡 + +##### 즐겨찾기 및 최근 문서 + +- **즐겨찾기**: 자주 사용하는 리포트 북마크 +- **최근 문서**: 최근 조회/수정 리포트 목록 + +##### 검색 및 필터링 + +- **고급 검색**: 전체 텍스트 검색, 필드별 검색 +- **스마트 필터**: 나의 리포트, 공유된 리포트, 승인 대기 + +##### 대시보드 + +- **리포트 통계**: 생성 수, 조회수, 출력 횟수 +- **사용자 통계**: 부서별/사용자별 활동 내역 + +#### I. 성능 및 최적화 ⚡ + +##### 대용량 데이터 처리 + +- **스트리밍 출력**: 대용량 데이터 효율적 처리 +- **캐싱**: 쿼리 결과/템플릿 캐싱 (Redis) + +##### 동시 접속 처리 + +- **부하 분산**: 로드 밸런싱, 세션 클러스터링 +- **큐잉 시스템**: 대량 출력 요청 백그라운드 처리 + +#### J. 모바일 지원 📱 + +##### 모바일 웹 + +- **반응형 디자인**: 모바일 화면 최적화 +- **모바일 기능**: 조회, 승인, 간단한 수정 + +##### 모바일 앱 + +- **네이티브 앱**: iOS/Android, 오프라인 모드 +- **푸시 알림**: 승인 요청, 문서 공유 알림 + +#### K. AI/ML 기반 고급 기능 🤖 + +##### 지능형 리포트 작성 지원 + +- **AI 기반 템플릿 추천**: 사용자의 과거 리포트 패턴 분석하여 최적 템플릿 자동 추천 +- **스마트 레이아웃 제안**: 데이터 유형에 따라 최적의 컴포넌트 배치 자동 제안 +- **자동 데이터 매핑**: 쿼리 필드와 컴포넌트 자동 연결 제안 + +##### 자연어 처리 (NLP) + +- **음성 명령**: "작년 매출 리포트 작성해줘" 같은 음성 명령으로 리포트 생성 +- **자동 요약 생성**: 긴 리포트 내용을 AI가 자동으로 요약 +- **다국어 자동 번역**: 리포트 내용을 여러 언어로 실시간 번역 + +##### 이상 탐지 및 예측 분석 + +- **데이터 이상 감지**: 리포트 데이터에서 비정상 패턴 자동 감지 및 경고 +- **트렌드 예측**: 과거 데이터 기반 미래 추세 예측 및 시각화 +- **자동 인사이트 생성**: 데이터에서 의미있는 패턴 발견 및 설명 제공 + +#### L. 데이터 거버넌스 🏛️ + +##### 데이터 품질 관리 + +- **데이터 검증 규칙**: 입력 데이터 유효성 자동 검증 +- **데이터 표준화**: 일관된 데이터 형식 강제 적용 +- **중복 데이터 감지**: 중복 리포트 및 데이터 자동 감지 + +##### 데이터 계보 (Data Lineage) + +- **데이터 흐름 추적**: 리포트 데이터의 출처부터 최종 사용까지 전체 흐름 시각화 +- **영향도 분석**: 데이터 변경 시 영향받는 리포트 자동 파악 +- **의존성 관리**: 리포트 간 의존 관계 매핑 + +##### 데이터 카탈로그 + +- **메타데이터 관리**: 모든 리포트 및 데이터셋의 메타데이터 중앙 관리 +- **데이터 검색**: 키워드로 관련 리포트 및 데이터 빠르게 검색 +- **데이터 사전**: 필드명, 설명, 데이터 타입 등 표준 용어 정의 + +#### M. 고급 분석 및 BI 통합 📊 + +##### 내장 분석 도구 + +- **OLAP 큐브**: 다차원 데이터 분석 지원 +- **피벗 테이블**: 동적 데이터 집계 및 분석 +- **드릴다운/드릴업**: 계층적 데이터 탐색 + +##### BI 도구 연동 + +- **Power BI 커넥터**: Power BI와 원활한 데이터 연동 +- **Tableau 통합**: Tableau 대시보드 임베딩 +- **Google Data Studio 연결**: 클라우드 기반 시각화 + +##### 고급 시각화 + +- **인터랙티브 차트**: 사용자 상호작용 가능한 동적 차트 +- **지도 시각화**: 지역별 데이터 지도 표시 (Heatmap, Choropleth) +- **네트워크 다이어그램**: 관계형 데이터 네트워크 시각화 + +#### N. 자동화 및 스케줄링 ⏰ + +##### 리포트 자동 생성 + +- **스케줄 실행**: 일별/주별/월별 자동 리포트 생성 +- **트리거 기반 실행**: 특정 이벤트 발생 시 자동 생성 +- **배치 처리**: 대량 리포트 일괄 생성 + +##### 자동 배포 + +- **이메일 자동 발송**: 생성된 리포트 자동 이메일 발송 +- **FTP/SFTP 업로드**: 외부 서버로 자동 업로드 +- **클라우드 스토리지 동기화**: 자동 백업 및 동기화 + +##### 워크플로우 자동화 + +- **조건부 워크플로우**: IF-THEN 조건에 따른 자동 실행 +- **연쇄 작업**: 여러 리포트를 순차적으로 자동 생성 +- **실패 처리**: 실행 실패 시 자동 재시도 및 알림 + +#### O. 버전 관리 및 변경 추적 📝 + +##### 고급 버전 관리 + +- **Git 방식 버전 관리**: Branch, Merge, Commit 개념 도입 +- **변경 사항 비교 (Diff)**: 버전 간 변경 내용 시각적 비교 +- **체크포인트 및 태그**: 주요 버전에 태그 부여 + +##### 변경 승인 프로세스 + +- **Pull Request 방식**: 변경 제안 및 리뷰 프로세스 +- **코드 리뷰**: 쿼리 및 레이아웃 변경 사항 동료 검토 +- **머지 승인**: 최종 승인 후 메인 버전에 반영 + +#### P. 테스트 및 품질 관리 🧪 + +##### 자동화 테스트 + +- **쿼리 유효성 테스트**: 쿼리 실행 전 자동 검증 +- **레이아웃 테스트**: 다양한 데이터셋으로 레이아웃 검증 +- **출력 품질 테스트**: PDF/WORD 출력 품질 자동 검증 + +##### A/B 테스트 + +- **템플릿 A/B 테스트**: 여러 버전의 리포트 동시 배포 및 성과 비교 +- **사용자 피드백 수집**: 사용자 선호도 분석 + +##### 품질 메트릭 + +- **리포트 품질 점수**: 가독성, 데이터 정확도 등 자동 평가 +- **성능 모니터링**: 쿼리 실행 시간, 렌더링 속도 추적 +- **에러율 추적**: 실행 실패율 및 원인 분석 + +#### Q. 커스터마이징 및 확장성 🔧 + +##### 플러그인 시스템 + +- **커스텀 컴포넌트**: 사용자 정의 컴포넌트 개발 및 등록 +- **확장 마켓플레이스**: 커뮤니티 개발 컴포넌트/템플릿 공유 +- **API 확장**: Custom Hook 및 이벤트 리스너 제공 + +##### 스크립트 지원 + +- **JavaScript 스크립트**: 고급 데이터 처리 로직 작성 +- **Python 통합**: 데이터 과학 라이브러리 활용 +- **SQL 함수 확장**: 사용자 정의 SQL 함수 등록 + +##### 테마 및 브랜딩 + +- **커스텀 테마**: 기업 CI/BI에 맞는 색상/폰트 적용 +- **로고 및 워터마크**: 자동 브랜딩 요소 삽입 +- **다국어 커스터마이징**: 기업별 용어 정의 + +#### R. 비용 관리 및 최적화 💰 + +##### 리소스 사용량 추적 + +- **쿼리 비용 추적**: 각 쿼리의 DB 비용 계산 +- **저장소 사용량**: 리포트 저장 공간 모니터링 +- **API 호출 추적**: 외부 API 사용량 및 비용 + +##### 비용 최적화 제안 + +- **비효율적 쿼리 감지**: 성능이 낮은 쿼리 자동 식별 +- **캐싱 전략 제안**: 반복 쿼리에 대한 캐싱 권장 +- **아카이빙 제안**: 오래된 리포트 아카이빙 권장 + +#### S. 고급 보안 기능 🔐 + +##### 위협 탐지 + +- **비정상 접근 패턴 감지**: AI 기반 이상 행동 탐지 +- **SQL 인젝션 방어**: 고급 SQL 인젝션 패턴 탐지 +- **브루트포스 공격 방어**: 로그인 시도 제한 및 차단 + +##### 암호화 및 키 관리 + +- **필드 레벨 암호화**: 민감 필드 개별 암호화 +- **키 로테이션**: 암호화 키 자동 교체 +- **Hardware Security Module (HSM) 연동**: 하드웨어 기반 보안 + +##### 보안 인증 + +- **SOC 2 준수**: 보안 감사 표준 준수 +- **ISO 27001 인증**: 정보 보안 관리 체계 +- **GDPR 준수**: 유럽 개인정보보호 규정 준수 + +#### T. 사용자 교육 및 온보딩 📚 + +##### 인터랙티브 튜토리얼 + +- **가이드 투어**: 신규 사용자 대상 단계별 안내 +- **인터랙티브 도움말**: 각 기능에 대한 실시간 도움말 +- **비디오 튜토리얼**: 주요 기능 사용법 영상 + +##### 학습 관리 + +- **학습 경로 제공**: 초급/중급/고급 학습 코스 +- **인증 프로그램**: 사용자 숙련도 인증 +- **커뮤니티 포럼**: 사용자 간 지식 공유 + +##### 컨텍스트 도움말 + +- **AI 어시스턴트**: 자연어로 질문하고 답변 받기 +- **실시간 제안**: 작업 중 관련 팁 자동 제공 +- **오류 해결 가이드**: 오류 발생 시 해결 방법 제시 + +#### U. 통합 협업 플랫폼 🤝 + +##### 프로젝트 관리 통합 + +- **Jira 연동**: 이슈와 리포트 연결 +- **Asana 통합**: 작업 관리와 리포트 동기화 +- **Monday.com 커넥터**: 워크플로우 통합 + +##### 커뮤니케이션 도구 + +- **Slack 봇**: 리포트 알림 및 명령 실행 +- **MS Teams 통합**: 팀즈 내에서 리포트 조회 +- **Zoom 통합**: 화상회의 중 리포트 공유 + +##### 문서 관리 시스템 + +- **SharePoint 연동**: 리포트 자동 업로드 +- **Confluence 통합**: 위키 페이지에 리포트 임베딩 +- **Notion 커넥터**: Notion 데이터베이스 동기화 + +### 13.3 추가 컴포넌트 + +- **Barcode**: 1D/2D 바코드 자동 생성 +- **QR Code**: URL/텍스트 QR코드 생성 +- **Chart**: 막대/선/파이/도넛/레이더/산점도 차트 +- **Gauge**: 게이지/미터기 시각화 +- **Watermark**: 반투명 워터마크 자동 삽입 +- **전자서명 필드**: 전자서명 영역 지정 +- **문서 번호 필드**: 자동 채번 번호 표시 +- **승인란**: 승인자 서명 및 날인 영역 +- **변경 이력**: 문서 변경 히스토리 자동 표시 +- **목차**: 다중 페이지 리포트 목차 자동 생성 +- **색인**: 키워드 색인 자동 생성 +- **각주/미주**: 참고 자료 삽입 +- **하이퍼링크**: 외부 링크 또는 페이지 내 링크 +- **북마크**: 특정 위치 마크 및 링크 +- **조건부 컴포넌트**: 데이터 조건에 따라 표시/숨김 + +### 13.4 고급 기능 + +#### 데이터 처리 + +- **조건부 표시** (IF-THEN-ELSE): 데이터 값에 따른 조건부 렌더링 +- **반복 섹션** (DETAIL 쿼리 기반): 동적 행 반복 +- **계산 필드**: 런타임 계산 (price \* quantity) +- **집계 함수**: SUM, AVG, COUNT, MIN, MAX, STDEV +- **수식 필드**: 복잡한 수식 지원 (Excel 유사) +- **룩업 함수**: 다른 데이터셋 참조 +- **문자열 함수**: CONCAT, SUBSTRING, REPLACE, FORMAT +- **날짜 함수**: DATE_ADD, DATE_DIFF, DATE_FORMAT + +#### 레이아웃 고급 기능 + +- **마스터 페이지**: 공통 헤더/푸터 템플릿 +- **섹션 구분**: Header/Body/Footer 섹션 분리 +- **컬럼 레이아웃**: 2단/3단 컬럼 지원 +- **플로팅 컴포넌트**: 고정 위치 컴포넌트 (페이지 상관없이) +- **동적 높이**: 내용에 따라 자동 높이 조절 +- **페이지 번호/총 페이지 수**: 자동 계산 +- **현재 날짜/시간**: 출력 시점 시간 자동 삽입 +- **헤더/푸터 변수**: 챕터명, 섹션명 자동 표시 + +#### 출력 고급 기능 + +- **조건부 페이지 나누기**: 특정 조건에서만 페이지 분리 +- **그룹 단위 페이지 유지**: 그룹이 페이지 경계에서 분리 방지 +- **반복 헤더/푸터**: 페이지마다 헤더/푸터 반복 +- **챕터 구분**: 챕터별 페이지 번호 재시작 +- **대체 페이지 레이아웃**: 홀수/짝수 페이지 다른 레이아웃 +- **출력 형식별 최적화**: PDF/WORD/EXCEL 각각 최적화 +- **북마크 및 목차 자동 생성**: PDF 북마크 트리 + +--- + +## 14. 개발 가이드 + +### 14.1 로컬 개발 환경 + +```bash +# Frontend +cd frontend +npm install +npm run dev + +# Backend +cd backend-node +npm install +npm run dev +``` + +### 14.2 환경 변수 + +```env +# Backend +DATABASE_URL=postgresql://... +PORT=3001 + +# Frontend +NEXT_PUBLIC_API_URL=http://localhost:3001 +``` + +### 14.3 빌드 및 배포 + +```bash +# Frontend +npm run build +npm run start + +# Backend +npm run build +npm run start +``` + +--- + +## 15. 구현 우선순위 및 로드맵 + +### Phase 1: 현재 완료 ✅ + +- 기본 리포트 디자이너 +- 컴포넌트 시스템 +- 쿼리 관리 +- 페이지 관리 +- 미리보기 및 출력 + +### Phase 2: 기업 필수 기능 (우선순위 높음) + +1. **문서 번호 자동 채번 시스템** +2. **문서 상태 관리** (작성중 → 검토 → 승인 → 완료) +3. **기본 권한 관리** (조회/수정/삭제 권한) +4. **감사 로그** (접근/수정/출력 이력) +5. **승인 워크플로우** (단계별 승인) + +### Phase 3: 협업 및 보안 (우선순위 중간) + +1. **리포트 공유 기능** +2. **댓글 및 리뷰 시스템** +3. **민감 정보 마스킹** +4. **전자서명 지원** +5. **문서 보존 기간 관리** + +### Phase 4: 고급 기능 (우선순위 낮음) + +1. **모바일 지원** +2. **대시보드 및 통계** +3. **외부 시스템 연동** (이메일, 클라우드) +4. **고급 컴포넌트** (차트, 바코드, QR코드) +5. **성능 최적화** (캐싱, 큐잉) + +--- + +## 16. 마무리 + +### 현재 상태 📊 + +현재 구현된 리포트 관리 시스템은 **기본적인 리포트 디자인, 쿼리 연동, 페이지 관리, 출력 기능**을 모두 갖추고 있습니다. + +사용자는 직관적인 **드래그 앤 드롭 인터페이스**로 리포트를 디자인하고, **데이터베이스 쿼리**를 연결하여 동적 리포트를 생성할 수 있으며, **다양한 형식(PDF, WORD)**으로 출력할 수 있습니다. + +### 기업 환경 적용을 위한 과제 🎯 + +하지만 **기업 환경에서 실제로 사용**하기 위해서는 다음 기능들이 필수적으로 추가되어야 합니다: + +1. **문서 번호 관리**: 체계적인 문서 관리를 위한 자동 채번 시스템 +2. **승인 워크플로우**: 문서의 검토 및 승인 프로세스 +3. **권한 관리**: 부서별/역할별 세분화된 접근 권한 +4. **감사 로그**: 규정 준수를 위한 상세한 이력 관리 +5. **보안 강화**: 민감 정보 보호 및 데이터 보안 + +### 향후 계획 🚀 + +**Phase 2**의 기업 필수 기능부터 순차적으로 구현하여, 실제 기업 환경에서 안정적으로 사용할 수 있는 **엔터프라이즈급 리포트 관리 시스템**으로 발전시킬 계획입니다. + +특히 **문서 번호 자동 채번**, **승인 워크플로우**, **권한 관리**는 가장 먼저 구현되어야 할 핵심 기능으로 판단됩니다. diff --git a/frontend/constants/auth.ts b/frontend/constants/auth.ts index c1880a69..a871351d 100644 --- a/frontend/constants/auth.ts +++ b/frontend/constants/auth.ts @@ -3,7 +3,7 @@ */ export const AUTH_CONFIG = { - API_BASE_URL: process.env.NEXT_PUBLIC_API_URL || "http://39.117.244.52:8080/api", + API_BASE_URL: process.env.NEXT_PUBLIC_API_URL || "http://localhost:8080/api", ENDPOINTS: { LOGIN: "/auth/login", STATUS: "/auth/status", diff --git a/frontend/constants/layout.ts b/frontend/constants/layout.ts index b447e9f4..5d595a2d 100644 --- a/frontend/constants/layout.ts +++ b/frontend/constants/layout.ts @@ -4,7 +4,7 @@ export const LAYOUT_CONFIG = { COMPANY_NAME: "WACE 솔루션", - API_BASE_URL: process.env.NEXT_PUBLIC_API_URL || "http://39.117.244.52:8080/api", + API_BASE_URL: process.env.NEXT_PUBLIC_API_URL || "http://localhost:8080/api", ENDPOINTS: { USER_MENUS: "/admin/user-menus", diff --git a/frontend/lib/api/company.ts b/frontend/lib/api/company.ts index 4945dfee..6babf0d7 100644 --- a/frontend/lib/api/company.ts +++ b/frontend/lib/api/company.ts @@ -5,7 +5,7 @@ import { Company, CompanyFormData } from "@/types/company"; import { apiClient } from "./client"; -const API_BASE_URL = process.env.NEXT_PUBLIC_API_URL || "http://39.117.244.52:8080/api"; +const API_BASE_URL = process.env.NEXT_PUBLIC_API_URL || "http://localhost:8080/api"; // API 응답 타입 정의 interface ApiResponse {