docs: 산출물 4종(개발계획서·설계서·사용자/운영자 지침서) UIMS 이식 반영

doc/_content/admin_guide.json

@@ -0,0 +1,64 @@
+{
+  "solution": "zioinfo-esn",
+  "doc_type": "운영자지침서",
+  "out": "C:/GUARDiA/workspace/zioinfo-esn/doc/zioinfo-esn_운영자지침서_v2.pptx",
+  "subtitle": "설치·운영·권한관리(RBAC) / 지오정보기술 / 2026",
+  "design": {"primary":"1F3A5F","accent":"2E86C1","text":"222222","font_ko":"맑은 고딕"},
+  "sections": [
+    {"type":"table", "title":"1. 설치 / 배포 정보", "headers":["항목","값"], "rows":[
+      ["서비스","zioinfo-esn (단일 JAR · esn-1.0.0)"],
+      ["백엔드 포트","8015"],
+      ["프론트(개발)","Vite 3014"],
+      ["빌드","Maven (Java 17) · React 빌드 → backend static 번들"],
+      ["배포","Gitea webhook → 자동 배포 파이프라인"],
+      ["DB","PostgreSQL / esn_db"]
+    ]},
+    {"title":"2. 환경 설정 (환경변수)", "bullets":[
+      "DB_URL / DB_USER : PostgreSQL esn_db 접속 (비밀번호는 환경변수로 주입, 문서 미기재)",
+      "OLLAMA_URL : 온프레미스 Ollama 엔드포인트(기본 11434) · 텍스트 모델 llama3.2:1b",
+      "ITSM_URL : ITSM 연계(기본 9001)",
+      "JWT_SECRET : JWT 서명 키(운영 시 환경변수로 교체 · 문서/코드 노출 금지)",
+      "메일 설정 미구성 시 2FA 인증코드는 LogMailSender 폴백으로 로그 기록"
+    ], "note":"자격증명·비밀번호·시크릿 값은 본 문서에 기재하지 않음"},
+    {"title":"3. DB 스키마 / 마이그레이션", "bullets":[
+      "부팅 시 멱등 적용: sql.init mode:always, continue-on-error",
+      "적용 순서: schema.sql → 90_uiws_system.sql → 91_uiws_port.sql",
+      "90_uiws_system.sql: 권한관리 10테이블 + 시드(역할 ADMIN/MANAGER/USER, ZIOINFO 회사, ROOT 부서)",
+      "91_uiws_port.sql: 업무 9테이블 + esn_user 2FA 컬럼 ALTER",
+      "전 구문 IF NOT EXISTS / ON CONFLICT DO NOTHING → 재배포 안전(중복 무해)",
+      "UIMS 테이블은 tb_uiws_* 프리픽스 → 기존 esn_*(ESL) 충돌 없음"
+    ]},
+    {"title":"4. 권한관리(RBAC) 운영 — 신규", "bullets":[
+      "시스템관리 메뉴는 esn_role ∈ {ADMIN, MANAGER}에게만 노출",
+      "역할관리: 역할 등록·수정·다중삭제(검색·페이징)",
+      "메뉴권한: 역할별 메뉴 읽기/쓰기 토글 → 전체 저장(쓰기 ON 시 읽기 자동 ON)",
+      "메뉴·공통코드·부서·거래처 관리(CRUD)",
+      "신규 가입자 승인: 승인 전 로그인 차단 → ADMIN 승인 처리 필요"
+    ]},
+    {"title":"5. 백업 / 복구", "bullets":[
+      "PostgreSQL esn_db 정기 백업(pg_dump) 권장 — ESL 운영데이터 + UIMS 업무데이터 포함",
+      "스키마는 멱등 부팅으로 자동 재생성되나 데이터는 별도 백업 필요",
+      "복구 시 DB 복원 후 서비스 재기동 → 스키마 보강 SQL 멱등 재적용으로 정합 유지"
+    ]},
+    {"type":"table", "title":"6. 모니터링 / 헬스", "headers":["항목","확인 방법"], "rows":[
+      ["헬스체크","GET /actuator/health (show-details: never)"],
+      ["서비스 기동","8015 포트 응답 확인"],
+      ["AI 상태","Ollama 11434 가용성 · 미가용 시 폴백 동작 확인"],
+      ["DB 연결","Hikari pool(max 3) 포화 여부 모니터링"]
+    ]},
+    {"title":"7. 장애 대응", "bullets":[
+      "AI 응답 없음: Ollama 미가용/RAM 부족 가능 → 폴백 동작으로 핵심 기능 유지, 모델/리소스 점검",
+      "테이블 없음(relation does not exist): 보강 SQL(90/91) 멱등 재적용 후 재기동",
+      "DB 연결 포화: Hikari max-pool=3 — 동시 부하 시 풀 상향 검토",
+      "2FA 메일 미발송: 메일 설정 확인, 미설정 시 LogMailSender 로그에서 코드 확인",
+      "계정 잠금 누적: 권한관리에서 사용자 잠금 해제"
+    ]},
+    {"title":"8. 보안 운영", "bullets":[
+      "외부 API 호출 0 — Ollama·메일(내부)만 사용",
+      "자격증명·비밀번호·내부IP·JWT 시크릿은 응답/로그/문서에 노출 금지",
+      "2FA verify-token(purpose=2fa)은 보호 API 접근 불가 — 우회 차단 가드 유지",
+      "RBAC 변경 API는 ADMIN/MANAGER 한정(백엔드 403) · 비밀번호 BCrypt 저장",
+      "회원가입 승인대기·아이디찾기 마스킹·스택트레이스 미노출 정책 준수"
+    ]}
+  ]
+}

doc/_content/design_spec.json

@@ -0,0 +1,77 @@
+{
+  "solution": "zioinfo-esn",
+  "doc_type": "설계서",
+  "out": "C:/GUARDiA/workspace/zioinfo-esn/doc/zioinfo-esn_설계서_v2.pptx",
+  "subtitle": "ESL 통합관리 + UIMS 업무협업 / 지오정보기술 / 2026",
+  "design": {"primary":"1F3A5F","accent":"2E86C1","text":"222222","font_ko":"맑은 고딕"},
+  "sections": [
+    {"title":"1. 시스템 구성도", "bullets":[
+      "[Client] React 19 SPA  →  [App] Spring Boot 3.5 단일 JAR (8015)  →  [DB] PostgreSQL esn_db",
+      "[App] ─ Ollama(11434, llama3.2:1b) : 알람분석·POS 분류 (폴백 내장)",
+      "[App] ─ ITSM(9001) 연계 (선택)",
+      "정적 리소스: backend classpath:/static/ 에 프론트 빌드 번들",
+      "스키마 멱등 부팅: schema.sql → 90_uiws_system.sql → 91_uiws_port.sql"
+    ], "note":"단일 JAR · 에이전트리스 · 온프레미스 AI"},
+    {"type":"table", "title":"2. 도메인 요약 — ESL 코어", "headers":["도메인","역할"], "rows":[
+      ["Tenant","멀티테넌트(LGInnotek/LGIT/Emart/ZIOINFO)"],
+      ["StoreGroup / Store","매장그룹 · 매장"],
+      ["Product","상품 / 가격"],
+      ["Template","ESL 화면 템플릿"],
+      ["TagBinding","ESL 기기 ↔ 상품 바인딩"],
+      ["UpdateQueue","가격/화면 갱신 큐"],
+      ["PosCvt","POS 데이터 변환·분류"],
+      ["Alarm","알람 / 이력"],
+      ["HCore","게이트웨이·허브 상태 관제"],
+      ["Firmware","펌웨어 버전 관리"],
+      ["WorkHistory","작업 이력"]
+    ]},
+    {"type":"table", "title":"3. 도메인 요약 — UIMS (신규)", "headers":["도메인","역할","테이블(tb_uiws_*)"], "rows":[
+      ["Worklog","업무일지·진행상태·코멘트","worklog / worklog_dtl / worklog_cmt"],
+      ["Schedule","일정·캘린더·첨부","schedule / diary / attach"],
+      ["Message","쪽지 송수신·미읽음","message / message_rcv"],
+      ["Stats","개인·회사별 업무 집계 피벗","(worklog 집계)"],
+      ["System(RBAC)","역할·메뉴·코드·부서·거래처","role / menu / role_menu / code* / dept / company / sys_user"],
+      ["Auth 2FA","로그인 인증코드 검증","login_verify"]
+    ]},
+    {"type":"table", "title":"4. API 설계 — 주요 엔드포인트", "headers":["영역","Base Path"], "rows":[
+      ["ESL 코어","/api/stores · /api/store-groups · /api/tenants"],
+      ["ESL 코어","/api/products · /api/templates · /api/tag-binding"],
+      ["ESL 코어","/api/update-queue · /api/pos-cvt · /api/works"],
+      ["ESL 코어","/api/alarms · /api/hcore · /api/firmware · /api/dashboard"],
+      ["AI","/api/ai"],
+      ["UIMS 업무","/api/worklogs · /api/schedules · /api/messages · /api/stats · /api/attachments · /api/diaries"],
+      ["UIMS 시스템","/api/system/{roles,menus,programs,codes,depts,companies,users}"],
+      ["인증","/api/auth (login·verify·signup·find-id·reset-password) · /api/public (depts·companies)"]
+    ]},
+    {"type":"table", "title":"5. 화면 설계 — 메뉴 목록", "headers":["메뉴 그룹","화면"], "rows":[
+      ["대시보드","Dashboard"],
+      ["ESL 운영","StoreList · TemplateList · ProductList · TagBindingList"],
+      ["ESL 운영","UpdateQueueList · PosCvtList · WorkHistory"],
+      ["관제","AlarmList · HCoreStatus · FirmwareList"],
+      ["관리","TenantAdmin · UserList · AiAnalysis"],
+      ["UIMS","WorklogList · ScheduleCalendar · MessageBox · StatsPivot"],
+      ["시스템관리","RoleManagement · RoleMenuManagement · MenuManagement"],
+      ["시스템관리","CodeManagement · DeptManagement · CompanyManagement"],
+      ["인증","Login(2FA) · Signup · FindId · ResetPw · MobileApp(QR)"]
+    ]},
+    {"type":"table", "title":"6. DB 스키마 — 멱등 적용", "headers":["파일","내용"], "rows":[
+      ["schema.sql","ESL 코어 테이블(esn_*)"],
+      ["90_uiws_system.sql","권한관리 10테이블 + 시드(ADMIN/MANAGER/USER·ZIOINFO·ROOT)"],
+      ["91_uiws_port.sql","업무 9테이블 + esn_user 2FA 컬럼 ALTER"],
+      ["멱등 규칙","CREATE TABLE IF NOT EXISTS / ADD COLUMN IF NOT EXISTS / ON CONFLICT DO NOTHING"]
+    ]},
+    {"title":"7. 보안 설계", "bullets":[
+      "인증: JWT(만료 24h) + 2FA(이메일 인증코드 5분, verify-token 5분, 실패 5회 잠금)",
+      "2FA 우회 차단: verify-token purpose=2fa 클레임 → JwtFilter가 verify-token은 인증 컨텍스트 미설정(보호 API 접근 불가)",
+      "회원가입 승인대기(approved=false) → ADMIN 승인 전 로그인 차단",
+      "RBAC: /api/system/** 변경(POST/PUT/DELETE)은 ADMIN/MANAGER 한정 (UI 차단 + 백엔드 403 이중 방어)",
+      "자격증명·비밀번호·내부IP 응답/로그 미노출 · 스택트레이스 차단 · 외부 API 0",
+      "비밀번호 BCrypt 저장 · 아이디찾기 username 마스킹 반환"
+    ]},
+    {"type":"table", "title":"8. 연계 설계", "headers":["연계 대상","용도"], "rows":[
+      ["Ollama (11434)","알람 원인 분석 · POS 데이터 자동 분류 (폴백)"],
+      ["ITSM (9001)","운영 연계 (선택)"],
+      ["메일/로그","2FA 인증코드 발송 (미설정 시 LogMailSender 폴백)"]
+    ]}
+  ]
+}

doc/_content/development_plan.json

@@ -0,0 +1,70 @@
+{
+  "solution": "zioinfo-esn",
+  "doc_type": "개발계획서",
+  "out": "C:/GUARDiA/workspace/zioinfo-esn/doc/zioinfo-esn_개발계획서_v2.pptx",
+  "subtitle": "ESL 통합관리 플랫폼 + UIMS 업무협업 통합 / 지오정보기술 / 2026",
+  "design": {"primary":"1F3A5F","accent":"2E86C1","text":"222222","font_ko":"맑은 고딕"},
+  "sections": [
+    {"title":"1. 개요 / 배경", "bullets":[
+      "레거시 ESN 6개 프로젝트(ESN_WEB_ZIOINFO·ESN_WEB_LGInnotek·ESN_DAEMON_EMART 등)를 단일 플랫폼으로 현대화 통합",
+      "전자가격표(ESL)·전자선반 통합 관리: 매장·템플릿·기기 바인딩·가격 갱신·펌웨어·HCore 게이트웨이 관제",
+      "멀티테넌트 구조(LGInnotek / LGIT / Emart / ZIOINFO)로 다수 고객사 동시 운영",
+      "2026-06-21 UIMS(URP 업무협업) 전체 이식: 업무일지·일정·쪽지·통계 + 시스템관리(RBAC) + 2차 인증(2FA) 추가"
+    ]},
+    {"title":"2. 목표", "bullets":[
+      "Spring Boot 1.5/Java 8 레거시 → Spring Boot 3.5 / Java 17 / React 19 단일 JAR 현대화",
+      "ESL 운영 전 과정(상품→가격→템플릿→기기 바인딩→갱신 큐→펌웨어) 통합 관제",
+      "Ollama 온프레미스 AI로 알람 원인 분석 · POS 데이터 자동 분류 (외부 API 미사용)",
+      "UIMS 공통 업무협업 레이어로 운영팀 업무일지·일정·쪽지·업무통계 일원화",
+      "JWT + 2FA(이메일 인증코드) 보안 인증 및 권한관리(RBAC) 체계 확립"
+    ]},
+    {"type":"table", "title":"3. 범위 — 모듈 구성", "headers":["영역","모듈","비고"], "rows":[
+      ["ESL 코어","테넌트 / 매장그룹 / 매장","멀티테넌트 4사"],
+      ["ESL 코어","상품 / 가격 / 템플릿","ESL 화면 템플릿"],
+      ["ESL 코어","태그 바인딩 / 갱신 큐","ESL 기기 ↔ 상품"],
+      ["ESL 코어","알람 / HCore / 펌웨어","게이트웨이/허브 관제"],
+      ["ESL 코어","POS 변환 / 작업이력 / 대시보드","POS 데이터 분류"],
+      ["AI","Ollama 알람분석 / POS 자동분류","폴백 내장"],
+      ["UIMS (신규)","업무일지 / 일정 / 쪽지 / 통계","공통 업무협업"],
+      ["UIMS (신규)","시스템관리(역할·메뉴·코드·부서·거래처)","RBAC"],
+      ["인증 (신규)","로그인 2FA / 회원가입·아이디찾기·비번초기화","보안 강화"]
+    ]},
+    {"type":"table", "title":"4. 기술 스택", "headers":["레이어","기술"], "rows":[
+      ["Backend","Spring Boot 3.5.0 / Java 17 / Maven (finalName esn-1.0.0)"],
+      ["ORM / DB","MyBatis + PostgreSQL (esn_db)"],
+      ["Frontend","React 19 + Vite + TypeScript + Tailwind"],
+      ["AI","Ollama 온프레미스 (llama3.2:1b 텍스트)"],
+      ["인증","JWT + 2FA(이메일 인증코드)"],
+      ["배포","단일 JAR (frontend → backend static 번들), 백엔드 포트 8015"]
+    ]},
+    {"title":"5. 아키텍처 개요", "bullets":[
+      "단일 JAR: React 빌드 산출물을 backend static에 번들 → 8015 단일 서비스",
+      "MyBatis @MapperScan(annotationClass=Mapper.class) · 매퍼 classpath:mapper/**/*.xml",
+      "스키마 멱등 부팅 적용: schema.sql → 90_uiws_system.sql → 91_uiws_port.sql (mode:always, continue-on-error)",
+      "UIMS 테이블은 전부 tb_uiws_* 프리픽스 → 기존 esn_*(ESL) 충돌 0",
+      "Ollama·ITSM(9001) 연계는 폴백 내장으로 미가용 시에도 핵심 기능 동작"
+    ], "note":"상세 구성도는 설계서 참조"},
+    {"type":"table", "title":"6. 일정 (WBS 요약)", "headers":["단계","주요 산출","상태"], "rows":[
+      ["Phase 1","레거시 6개 분석 · 도메인 정의","완료"],
+      ["Phase 2","ESL 코어(백엔드 12도메인·프론트 13페이지)","완료"],
+      ["Phase 3","단일 JAR · CI/CD 자동배포","완료"],
+      ["Phase 4","UIMS 업무모듈 + 시스템관리 + 2FA 이식","완료(2026-06-21)"],
+      ["Phase 5","라이브 배포·통합 검증","진행"]
+    ]},
+    {"type":"table", "title":"7. 역할 분담", "headers":["역할","담당 범위"], "rows":[
+      ["오케스트레이터","하네스 조율 · 산출물 관리"],
+      ["백엔드","Spring Boot 도메인/매퍼/API"],
+      ["프론트엔드","React 화면 · 테마 토큰"],
+      ["DB","스키마 멱등화 · 마이그레이션"],
+      ["DevOps","단일 JAR · Gitea webhook · 배포"],
+      ["QA","경계면 정합 · 회귀 · 보안 검증"]
+    ]},
+    {"title":"8. 기대효과", "bullets":[
+      "레거시 6종 분산 운영 → 단일 현대화 플랫폼으로 운영비·유지보수 부담 절감",
+      "멀티테넌트로 고객사별 ESL 운영을 단일 콘솔에서 통합 관제",
+      "Ollama 온프레미스 AI로 알람 분석·POS 분류 자동화(외부 의존 0)",
+      "UIMS 통합으로 ESL 운영 업무와 업무협업(일지·일정·쪽지·통계)을 한 시스템에서 처리",
+      "2FA·RBAC 도입으로 공공/기업 고객 보안 요구 충족"
+    ]}
+  ]
+}

doc/_content/user_guide.json

@@ -0,0 +1,60 @@
+{
+  "solution": "zioinfo-esn",
+  "doc_type": "사용자지침서",
+  "out": "C:/GUARDiA/workspace/zioinfo-esn/doc/zioinfo-esn_사용자지침서_v2.pptx",
+  "subtitle": "ESL 운영 + UIMS 업무협업 사용 안내 / 지오정보기술 / 2026",
+  "design": {"primary":"1F3A5F","accent":"2E86C1","text":"222222","font_ko":"맑은 고딕"},
+  "sections": [
+    {"title":"1. 시작하기 — 로그인", "bullets":[
+      "웹 브라우저로 zioinfo-esn 콘솔 접속 후 아이디/비밀번호 입력",
+      "2차 인증(2FA) 활성 계정: 로그인 후 이메일로 받은 인증코드 입력 → 인증 완료 시 접속",
+      "인증코드 유효시간 5분, 비밀번호 5회 연속 실패 시 계정 잠금",
+      "처음 사용 시: 화면 하단 '회원가입' → 가입 후 관리자 승인 대기(승인 전 로그인 불가)"
+    ], "note":"2FA·승인대기는 이번 세션 신규 적용"},
+    {"title":"2. 계정 보조 기능", "bullets":[
+      "회원가입: 이름·이메일·부서/거래처 선택 후 가입 신청 (승인 후 사용)",
+      "아이디 찾기: 이름 + 이메일 입력 → 마스킹된 아이디 확인",
+      "비밀번호 초기화: 본인 확인 후 임시 비밀번호를 이메일로 수신 → 로그인 후 변경 권장"
+    ]},
+    {"type":"table", "title":"3. ESL 운영 메뉴 사용법", "headers":["메뉴","주요 작업"], "rows":[
+      ["대시보드","매장·기기·알람 현황 한눈에 확인"],
+      ["매장(Store)","매장그룹/매장 조회 및 관리"],
+      ["상품(Product)","상품·가격 조회 및 등록"],
+      ["템플릿(Template)","ESL 화면 템플릿 관리"],
+      ["태그 바인딩","ESL 기기에 상품 연결(바인딩)"],
+      ["갱신 큐","가격/화면 갱신 작업 상태 확인"],
+      ["POS 변환","POS 데이터 변환·분류 결과 확인"]
+    ]},
+    {"type":"table", "title":"4. 관제 메뉴 사용법", "headers":["메뉴","주요 작업"], "rows":[
+      ["알람(Alarm)","발생 알람 조회 · AI 원인 분석 참고"],
+      ["HCore","게이트웨이/허브 상태 모니터링"],
+      ["펌웨어","ESL 펌웨어 버전 관리"],
+      ["작업이력","수행 작업 이력 조회"],
+      ["AI 분석","Ollama 기반 알람 분석·POS 분류 결과 확인"]
+    ]},
+    {"type":"table", "title":"5. UIMS 업무협업 사용법 (신규)", "headers":["메뉴","사용법"], "rows":[
+      ["업무일지","일일 업무 작성·진행상태·코멘트, 시간대별 상세 입력"],
+      ["일정","캘린더에서 일정 등록·조회·삭제, 첨부파일 관리"],
+      ["쪽지","보낸/받은 쪽지 확인, 미읽음 수 확인, 송신·삭제"],
+      ["업무통계","개인·회사별 업무 집계 피벗 조회"]
+    ]},
+    {"title":"6. 업무 흐름 예시", "bullets":[
+      "오전: 로그인(2FA) → 대시보드로 알람/기기 현황 확인 → 알람 발생 시 AI 분석 참고",
+      "운영: 상품/가격 변경 → 템플릿·태그 바인딩 → 갱신 큐로 반영 상태 확인",
+      "협업: 업무일지 작성 → 일정 등록 → 담당자에게 쪽지 전달",
+      "마감: 업무통계로 당일/기간 업무 집계 확인"
+    ]},
+    {"title":"7. 모바일 앱", "bullets":[
+      "MobileApp(QR) 화면에서 통합 메신저 앱 다운로드 QR 코드 확인",
+      "QR 스캔 → APK 설치(앱스토어 불필요) → 모바일에서 주요 기능 이용",
+      "모바일도 동일한 2FA 인증 적용"
+    ]},
+    {"type":"table", "title":"8. FAQ", "headers":["질문","답변"], "rows":[
+      ["로그인 후 코드 입력 화면이 떠요","2FA 활성 계정입니다. 이메일 인증코드를 5분 내 입력하세요"],
+      ["가입했는데 로그인이 안 돼요","관리자 승인 대기 상태입니다. 승인 후 로그인됩니다"],
+      ["계정이 잠겼어요","비밀번호 5회 실패로 잠금. 관리자에게 해제 요청하세요"],
+      ["아이디를 잊었어요","'아이디 찾기'에서 이름+이메일로 확인하세요"],
+      ["AI 분석이 비어 있어요","Ollama 미가용 시 폴백 동작. 잠시 후 재시도하세요"]
+    ]}
+  ]
+}