feat: xavis ai_platform 기능 이전 및 ncue 환경 전환

xavis 소스·DB 스키마·활용사례/F-Scan/프롬프트 라이브러리 등 기능 반영.
@xavis.co.kr → @ncue.net, 관리자 토큰 ncue-admin, 런타임 data/ Git 추적 제외.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/DEPLOYMENT-xavis.ncue.net.md

@@ -44,7 +44,18 @@ cd /var/www/webplatform
 npm install --production
 ```
 
-### 2.4 환경 변수 설정
+### 2.4 코드 갱신(`git pull`) 직후 (503·앱 기동 실패 시)
+
+`package.json`에 새 npm 패키지가 추가되면, **pull만 하고 `npm install`을 하지 않은 상태로 PM2(또는 node)를 재시작**하면 `Cannot find module`로 프로세스가 바로 종료됩니다. Apache는 업스트림이 없다고 **503 Service Unavailable**을 반환할 수 있습니다.
+
+```bash
+cd /var/www/webplatform   # 실제 배포 경로
+git pull
+npm install --production
+pm2 restart webplatform   # PM2로 실행 중인 앱 이름에 맞게
+```
+
+### 2.5 환경 변수 설정
 
 ```bash
 # .env 파일이 없다면 .env.example 복사
@@ -237,3 +248,11 @@ sudo ufw reload
 ### 썸네일/슬라이드 이미지 미생성
 - LibreOffice, poppler-utils 설치 여부 확인
 - PM2 로그 확인: `pm2 logs webplatform`
+
+### 업로드 413 Request Entity Too Large (Apache)
+- `VirtualHost`에 **`LimitRequestBody`**가 작게 잡혀 있지 않은지 확인합니다. 회의 음성·엑셀 등은 바이트 단위로 크게 필요합니다 (`deploy/apache-ai.ncue.net-ssl.conf.example`의 예시 참고).
+
+### 회의록 음성(SSE)·진행 막대가 한동안 안 움직임
+- 노드 처리 전체가 길므로 같은 VirtualHost에서 **`TimeOut`** / **`ProxyTimeout`** 이 충분한지 확인합니다.
+- 브라우저로 직접 `http://127.0.0.1:8030`(또는 앱 바인 포트)에 붙였을 때는 정상인데 Apache 경유만 이상하면, 프록시 앞단 **`mod_deflate`** 등 출력 필터가 `text/event-stream` 응답을 버퍼링하지 않는지 점검합니다.
+- 앱이 붙이는 **`X-Accel-Buffering: no`** 는 **Nginx 전용**이며, **Apache에서는 동작하지 않습니다**(무시됨).

docs/ai-platform-menu-guide-for-ppt.md

@@ -0,0 +1,424 @@
+# XAVIS AI Platform — 메뉴별 PPT 안내 자료
+
+> **용도**: https://ai.xavis.co.kr/ 정식 오픈 교육·안내 PPT 제작용  
+> **PPT 파일**: [`XAVIS-AI-Platform-메뉴안내.pptx`](./XAVIS-AI-Platform-메뉴안내.pptx) (화면 캡처 포함)  
+> **캡처 원본**: [`ppt-screenshots/`](./ppt-screenshots/)  
+> **재생성**: `OPS_STATE=PROD npm start` 실행 후 `node scripts/capture-menu-screenshots.mjs` → `python scripts/build-menu-guide-ppt.py`  
+> **구성**: 메뉴 1개 = 슬라이드 1~2장 권장 (제목 슬라이드 + 상세 슬라이드)  
+> **접속**: `@ncue.net` 이메일 매직 링크 인증 후 이용
+
+---
+
+## 슬라이드 0. 표지 / 서비스 개요
+
+**제목**: XAVIS AI Platform 메뉴 안내
+
+**한 줄 소개**
+- 사내 AI 도구·학습·과제·활용 사례를 한곳에서 이용하는 임직원 전용 포털
+
+**접속**
+- URL: https://ai.xavis.co.kr/
+- 최초 1회: 회사 메일 입력 → 인증 메일 링크 클릭 (15분 유효)
+
+**좌측 메뉴 구성**
+| 순서 | 메뉴 | 한 줄 설명 |
+|------|------|------------|
+| 1 | 회사규정 | 사내 규정·지침 AI 검색(NotebookLM) |
+| 2 | WM | WM 관련 자료 AI 검색(NotebookLM) |
+| 3 | AI | 회의록·채팅·FScan 등 AI 서비스 허브 |
+| 4 | 프롬프트 | 업무용 프롬프트 템플릿·팀 공유 |
+| 5 | 학습센터 | YouTube·PPT·동영상 강의 시청 |
+| 6 | 과제신청 | AX(AI Transformation) 과제 신청 |
+| 7 | AI 활용 사례 | 현장 AI 도입 사례 열람·작성 |
+| 8 | 대시보드 | 허용 계정 전용 경영 지표(선택) |
+
+---
+
+## 슬라이드 1. 서비스 접속 (로그인)
+
+**경로**: `/login` (미인증 시 자동 이동)
+
+**화면 설명**
+- XAVIS·AI Platform 로고와 「서비스 접속」 카드형 로그인 화면
+- `@ncue.net` 이메일만 허용
+
+**이용 방법**
+1. 회사 이메일 입력
+2. **[검증]** 클릭 → 메일함 확인
+3. **[인증 완료하기]** 링크 클릭 → 학습센터 등 원하는 화면으로 이동
+
+**활용 팁**
+- 인증 링크가 만료되면 같은 화면에서 다시 [검증]을 누르면 됩니다.
+- 다른 PC·브라우저에서는 다시 인증이 필요할 수 있습니다.
+
+**유의사항**
+- 개인 메일·외부 도메인은 사용할 수 없습니다.
+- 로그아웃: 좌측 하단 **로그아웃**
+
+---
+
+## 슬라이드 2. 회사규정
+
+**경로**: 좌측 **회사규정** → Google NotebookLM (새 탭)
+
+**화면 설명**
+- AI Platform 레이아웃을 벗어나 **NotebookLM** 회사규정 노트북으로 이동
+- 업로드된 사내 규정·지침 자료를 AI가 검색·요약·질의응답
+
+**주요 기능**
+- 규정 문구 검색, 요약, 관련 조항 질문
+- 회의·업무 전 규정 확인용 Q&A
+
+**활용 팁**
+- 「○○ 절차가 뭐야?」「휴가 신청 규정 알려줘」처럼 **구체적 질문**이 정확도가 높습니다.
+- AI 답변은 **원문 규정·다우오피스 공식 문서**와 반드시 대조하세요.
+
+**대안**
+- NotebookLM 접속이 어려우면 다우오피스 전자결재·규정 게시판을 우선 확인
+
+---
+
+## 슬라이드 3. WM
+
+**경로**: 좌측 **WM** → Google NotebookLM WM 노트북 (새 탭)
+
+**화면 설명**
+- WM(Work Management 등 사내 WM 체계) 관련 자료를 AI로 검색·질의
+
+**주요 기능**
+- WM 프로세스·용어·가이드 질의
+- 업무 방법·템플릿 관련 Q&A
+
+**활용 팁**
+- WM 업무를 처음 맡았을 때 용어·절차를 빠르게 파악하는 용도로 적합합니다.
+
+**유의사항**
+- 회사규정과 동일하게, AI 답변은 공식 매뉴얼·담당 부서 확인을 병행하세요.
+
+---
+
+## 슬라이드 4. AI (메인 허브)
+
+**경로**: `/ai-explore`
+
+**화면 설명**
+- 「지식 시험이나 지식 보강… 맞춤형 AI를 탐색」 안내 문구
+- 검색창 + 타입 필터(전체 / 일반 / XScan / FScan)
+- AI 서비스 **카드 그리드** — 클릭하면 각 도구로 이동
+
+**포함 서비스 (카드)**
+| 카드 | 이동 경로 | 분류 |
+|------|-----------|------|
+| 회의록 AI | `/ai-explore/meeting-minutes` | 일반 |
+| (회의록 기반) 업무 체크리스트 AI | `/ai-explore/task-checklist` | 일반 |
+| 일반 채팅 | `/ai-explore/chat` | 일반 |
+| FSCAN 조사각 선정도우미 | `/ai-explore/fscan` | FScan |
+
+**활용 팁**
+- 검색창에 「회의」「체크」「채팅」「FSCAN」 등 키워드로 카드 필터링
+- AI 관련 업무는 **이 화면을 시작점**으로 두면 메뉴를 빠르게 찾을 수 있습니다.
+
+---
+
+## 슬라이드 5. 회의록 AI
+
+**경로**: AI → **회의록 AI** (`/ai-explore/meeting-minutes`)
+
+**화면 구성**
+- **좌측**: 내 회의록 목록(저장·불러오기)
+- **상단(접기 가능)**: 출력 형식(프롬프트) — 추가 지시 입력·저장
+- **탭 ① 텍스트 입력**: 회의 원문 붙여넣기 → 회의록 생성
+- **탭 ② 음성 파일**: mp3·m4a·wav 등 업로드 → 전사 → 회의록 생성
+- **하단**: 생성 결과(회의록·전사 기록) 편집·저장
+
+**음성 처리 3단계**
+1. **업로드** — 최대 300MB
+2. **전사** — OpenAI 음성→텍스트 (gpt-4o-transcribe 등)
+3. **번역(정리)** — 전사문을 사내 회의록 형식으로 LLM 작성
+
+**텍스트 입력 흐름**
+1. 제목·날짜 입력
+2. 회의 원문(메모·채팅 로그·타 도구 전사문) 붙여넣기
+3. 모델 선택(gpt-5-mini / gpt-5.4) → **회의록 생성**
+4. 결과 수정 후 **저장** → 업무 체크리스트 AI와 연동
+
+**회의록 기본 구조(시스템 프롬프트)**
+- 회의 개요, 참석·언급 인원, 논의 요약, 결정 사항, 액션 아이템(표), 후속 체크리스트 등
+
+**활용 팁 · 대안 (실무 시나리오)**
+
+| 상황 | 추천 |
+|------|------|
+| 회의 **음성 파일**이 있을 때 | **AI Platform 회의록 AI** 음성 탭 — 사내 계정·저장·체크리스트 연동 |
+| Claude·ChatGPT에 음성 올려 회의록 작성 | 개인 구독·용량에 따라 가능. **저장·팀 공유·체크리스트 연동**은 AI Platform이 유리 |
+| 전사만 필요할 때 | 회의록 AI 음성 탭 사용, 또는 **클로버노트(Clova Note)** 등 전사 앱 → 전사문을 **텍스트 입력** 탭에 붙여넣기 |
+| 짧은 메모·채팅 로그만 있을 때 | **텍스트 입력** 탭이 가장 빠름 |
+| 회의록 형식을 팀마다 맞추고 싶을 때 | 「출력 형식(프롬프트)」의 **추가 지시**에 팀 규칙 입력 후 저장 |
+
+**유의사항**
+- 생성 결과는 반드시 **검토·수정** 후 저장·배포
+- 음성·전사에 **개인정보·대외비**가 포함되면 보안 규정 준수
+- 긴 회의는 처리에 **수 분** 걸릴 수 있음(진행 표시 확인)
+
+---
+
+## 슬라이드 6. (회의록 기반) 업무 체크리스트 AI
+
+**경로**: AI → **업무 체크리스트 AI** (`/ai-explore/task-checklist`)
+
+**화면 설명**
+- 회의록 AI에서 **저장한 회의**의 액션 아이템·체크리스트를 한 화면에서 관리
+- 진행상황(전체/진행 중/완료), 회의록별 필터, 정렬(날짜·글자·완료여부)
+
+**주요 기능**
+- 회의록에서 자동 추출된 **할 일** 목록 표시
+- 항목 수정·완료 처리(처리 내용 메모)
+- 회의 제목·일자·요약 툴팁으로 출처 확인
+
+**이용 방법**
+1. 먼저 **회의록 AI**에서 회의록 생성·**저장**
+2. 체크리스트 AI에서 회의록 범위 선택 → 항목 자동 반영
+3. 완료 시 체크 + 처리 내용 기록
+
+**활용 팁**
+- 다우오피스·엑셀 할 일 목록과 병행할 때, **회의에서 나온 액션**은 이 화면에서 추적
+- 회의록을 수정·재저장하면 체크리스트 연동 내용이 갱신될 수 있음
+
+**대안**
+- 개인 To-do는 Outlook·다우오피스 일정, Notion 등과 병행 가능
+- **회의 연계 업무**는 AI Platform 체크리스트가 출처 추적에 유리
+
+---
+
+## 슬라이드 7. 일반 채팅
+
+**경로**: AI → **일반 채팅** (`/ai-explore/chat`)
+
+**화면 설명**
+- ChatGPT 기반 **인앱 채팅** (스트리밍 응답, 마크다운 표시)
+- 「안녕하세요, 오늘 무엇을 도와드릴까요?」 웰come 화면
+
+**주요 기능**
+- 업무 질의, 문서 초안, 아이디어 브레인스토밍
+- (서버 설정 시) **웹 검색** 연동으로 최신 정보 보강
+- 대화 맥락 유지(세션 내)
+
+**이용 조건**
+- **회사 이메일 인증(OPS 로그인)** 후 이용
+
+**활용 팁 · 대안**
+
+| 용도 | 추천 |
+|------|------|
+| 빠른 업무 질의·초안 | **AI Platform 일반 채팅** — 별도 ChatGPT 구독 없이 사내 경로 |
+| Claude·Gemini 선호 | 개인/팀 구독 도구 병행. **사내 기록·규정 연동**은 Platform 채팅·프롬프트 라이브러리 |
+| 회사규정 확인 | **회사규정(NotebookLM)** 또는 채팅 + 반드시 원문 대조 |
+| 반복 업무 프롬프트 | **프롬프트** 메뉴에서 템플릿 복사 후 채팅에 붙여넣기 |
+
+**유의사항**
+- 하단 안내: 「AI 답변은 실수할 수 있습니다. 중요한 정보는 원문 규정과 함께 확인」
+- 기밀·개인정보 입력 자제
+
+---
+
+## 슬라이드 8. FSCAN 조사각 선정도우미
+
+**경로**: AI → **FSCAN 조사각 선정도우미** (`/ai-explore/fscan`)
+
+**화면 설명**
+- 검사 대상물 **치수(H/W)** 입력 기반 FSCAN 시리즈 **모델 선정** 도구
+- AI Platform 레이아웃 안에 도구 화면(iframe) 임베드
+
+**주요 기능**
+- H(높이)·W(폭) 등 조건 입력 → 적합 FSCAN 모델 추천
+- 영업·기술 검토 시 **빠른 1차 선정**용
+
+**활용 팁**
+- 최종 스펙·계약 조건은 **공식 카탈로그·기술팀** 확인 필수
+- XScan 관련 다른 도구는 AI 허브 **타입 필터: XScan** 으로 추후 확장 카드 확인
+
+**대상 사용자**
+- FSCAN 제품·검사 설계 관련 영업, 기술, PM
+
+---
+
+## 슬라이드 9. 프롬프트 (프롬프트 라이브러리)
+
+**경로**: `/ai-explore/prompts`
+
+**화면 설명**
+- 「공식 템플릿을 복사하거나, 팀이 공유한 프롬프트를 고르고…」
+- 4개 탭: **라이브러리** / **워크플로→프롬프트** / **공유하기** / **내가 올린 것**
+
+**라이브러리 탭**
+- 좌측: 시나리오 카드(회의 요약, 이메일 초안, 보고서 목차, OKR, 코드 리뷰, CS 응대, JD, 리스크 메모 등)
+- 우측: 미리보기 + **클립보드에 복사**
+- 필터: 공식/팀 공유, 인기·최신, 검색
+
+**워크플로 탭**
+- ①~④ 단계 입력 → 초안 합치기 → (OpenAI 연동 시) AI로 다듬기
+- 본인 업무에 맞는 **맞춤 지시문** 작성
+
+**공유하기 탭**
+- 팀에 프롬프트·참고 파일 공개(로그인 필요)
+- 민감·개인정보·기밀 미포함 주의
+
+**이용 방법**
+1. 카드 선택 → 미리보기 확인
+2. `[ ]` 플레이스홀더를 상황에 맞게 수정
+3. ChatGPT·Claude·회의록 AI 등 원하는 도구에 붙여넣기
+
+**활용 팁**
+- 매번 같은 형식의 메일·보고·회의 요약 → **공식 템플릿**부터 시작
+- 팀에서 검증된 프롬프트 → **공유하기**로 축적
+
+---
+
+## 슬라이드 10. 학습센터
+
+**경로**: `/learning` (루트 `/` 도 동일 목적지)
+
+**화면 설명**
+- 「최신 컨텐츠로 학습하고, 바로 업무에 적용하세요」
+- 강의 **검색·필터** + **카드 목록** + 페이지 이동
+
+**콘텐츠 유형**
+| 타입 | 시청 방식 |
+|------|-----------|
+| YouTube | 페이지 내 영상 재생 |
+| PPT/PDF | 슬라이드 이미지 뷰어(1·2·3단 보기) |
+| 동영상 파일 | 업로드 mp4 등 재생 |
+| 웹 링크 | 외부 URL 연결 |
+| 뉴스 URL | 뉴스 링크 |
+
+**카테고리 예**
+- AX 사고 전환, AI 툴 활용, AI Agent, 바이브 코딩 등
+
+**이용 방법**
+1. 검색어·타입·태그·카테고리로 필터
+2. 카드 클릭 → 상세에서 학습
+
+**활용 팁**
+- Claude·ChatGPT·Cursor 등 **도구별 학습**은 검색창에 도구명 입력(예: claude, 클로드)
+- 신규 입사·AX 교육 시 **AX 사고 전환** 카테고리부터 순차 학습
+
+**관리자(선택)**
+- 관리자 토큰 인증 시 **학습 등록**(`/admin`)으로 강의 추가 가능
+
+---
+
+## 슬라이드 11. 과제신청 (AX 과제 신청)
+
+**경로**: `/ax-apply`
+
+**화면 설명**
+- **신청된 과제 목록**(부서·이름·이메일로 조회)
+- **AX 과제 신청서** 온라인 작성 + Word 양식 다운로드
+
+**신청서 주요 섹션**
+1. 기본 정보(부서, 이름, 연락처 등)
+2. 업무·Pain Point·AI 기대 효과
+3. 데이터·자동화 수준·보안 관련
+4. 정량·정성 기대 효과
+5. 신청서 파일 첨부(선택)
+
+**이용 방법**
+1. `(신청서 다운로드)`로 Word 양식 참고
+2. 웹 폼 작성 → 제출
+3. **조회** 버튼으로 본인 신청 내역 확인·수정
+
+**활용 팁**
+- 「AI로 무엇을 자동화하고 싶은지」를 **구체적 업무 프로세스**로 적을수록 검토에 유리
+- 유사 사례는 **AI 활용 사례** 메뉴에서 참고
+
+**유의사항**
+- 모든 항목 **성실 작성** (화면 안내 문구)
+- 개인정보·고객 데이터 처리 계획은 보안·Compliance 관점에서 명시
+
+---
+
+## 슬라이드 12. AI 활용 사례
+
+**경로**: `/ai-cases`
+
+**화면 설명**
+- 「현장에서 검증된 AI 업무 혁신 이야기」
+- 카드 그리드 + 검색·태그 필터
+- 카드 클릭 → 상세 본문
+
+**주요 기능**
+- 부서별 **도입 과정·성과** 사례 열람
+- 로그인 사용자 **글쓰기**(`/ai-cases/compose`) — STAR 형식(1.Situation ~ 4.Result)
+- 활용 AI 툴 태그(Claude, Slack 등) 입력
+
+**이용 방법 (열람)**
+1. 검색·태그로 관심 사례 찾기
+2. 카드 클릭 → 상세 읽기
+
+**이용 방법 (작성)**
+1. 상단 **글쓰기** → STAR 본문·썸네일·활용 AI 입력
+2. 제출 → 목록에 반영(승인·노출 정책은 운영 기준 따름)
+
+**활용 팁**
+- AX 과제 기획 전 **유사 부서 사례** 검색
+- 본인 성공 사례 → 팀 공유·과제신청 근거 자료로 활용
+
+---
+
+## 슬라이드 13. 대시보드 (허용 계정)
+
+**경로**: `/dashboard` (메뉴는 **허용 이메일**에게만 표시)
+
+**화면 설명**
+- 경영·업무 지표 대시보드 **허브**(검색 + 카드)
+- 현재 카드: **경영성과 대시보드**
+
+**경영성과 대시보드** (`/dashboard/business-performance`)
+- **상단**: 연도·분기 선택 → Chart.js 기반 KPI·차트 조회
+- **하단**: 매출일보 등 **엑셀(.xlsx) 업로드** → 스냅샷 저장·조회
+- (해당 기간 데이터 없으면 샘플 데이터 + 안내 문구)
+
+**대상**
+- `.env`에 등록된 `DASHBOARD_MENU_ALLOWED_EMAILS` 등 **사전 허용 계정**
+
+**활용 팁**
+- 일반 임직원에게는 메뉴가 보이지 않을 수 있음 — **경영·관리 목적** 전용
+- 엑셀 업로드 후 차트가 기대와 다르면 AI혁신팀·담당 부서에 문의
+
+---
+
+## 슬라이드 14. (부록) 관리자·로그아웃
+
+**관리자 모드** (일반 사용자 참고용)
+- 좌측 하단 **관리자** → 관리자 토큰 입력
+- 강의 등록·삭제, AI 활용 사례 관리, 사용자 현황 등
+
+**로그아웃**
+- 좌측 하단 **로그아웃** → 이메일 세션 종료 → 로그인 화면
+
+---
+
+## 슬라이드 15. (마무리) 업무별 추천 메뉴 Quick Reference
+
+| 업무 | 먼저 열 메뉴 |
+|------|----------------|
+| 회의록(음성) | AI → **회의록 AI** (또는 클로버노트 전사 → 텍스트 입력) |
+| 회의록(메모만) | AI → **회의록 AI** 텍스트 입력 |
+| 할 일 추적 | AI → **업무 체크리스트 AI** |
+| 빠른 AI 질문 | AI → **일반 채팅** |
+| 메일·보고 초안 | **프롬프트** → 템플릿 복사 |
+| 사내 규정 | **회사규정**(NotebookLM) |
+| AI 학습 | **학습센터** |
+| AI 도입 과제 | **과제신청** + **AI 활용 사례** 참고 |
+| FSCAN 모델 선정 | AI → **FSCAN 조사각 선정도우미** |
+
+**문의**: AI혁신팀
+
+---
+
+## PPT 제작 시 권장 사항
+
+1. **메뉴당 2장**: ① 화면 캡처 + 한 줄 설명 ② 이용 방법·팁·대안
+2. **실제 스크린샷**: https://ai.xavis.co.kr/ 에서 로그인 후 각 경로 캡처 삽입
+3. **강조 색**: 인증(파랑), 주의(회색 박스), 대안(별도 불릿)
+4. **발표 스크립트**: 각 슬라이드 노트에 「이 메뉴는 ○○할 때 쓴다」 한 문장 추가