# Mother AI 실운영 안내 — 몽생이(관광) · 오로라(스펙트럼 연구)

IKCTA Mother AI 컨트롤타워의 **대화·관광 안내 별칭은「몽생이」** 한 가지입니다.

**「오로라」**는 관광·플랜 채팅과 **분리된 별도 AI**로, **지구 무선 할당·실측 RF에 해당하지 않는(모델·연구용) 주파수**만 추적·분석하는 스펙트럼 연구 모듈입니다. Mother AI 허브에 붙어 있지만 **몽생이의 별칭이 아닙니다.**

## 시작

1. `mother-ai` 디렉터리에서 `npm install` 후 `npm run dev` 또는 `npm start` (기본 개발 런타임).
2. **운영 서버**에서는 `npm run start:prod` — `NODE_ENV=production`으로 기동하며, 있으면 `.env.production`을 `.env` 위에 덮어씁니다(`.env.production.example` 참고).
3. 브라우저에서 `http://localhost:8787` (포트는 `.env`의 `PORT`).
4. 상단 **`ADMIN_TOKEN`** 입력 후 「저장」 (`mother-ai/.env`).
5. 등록·배포·일부 API는 「엄격」 모드에서 **`I_AGREE`** 저장 필요.

## 몽생이 · 관광 채팅

- **`몽생이 · 관광 채팅`** 카드 또는 헤더 **「몽생이 채팅」** — 채팅 풍선에는 **몽생이**로 표시됩니다.
- **OPENAI_API_KEY** 설정 필요 (`/api/config` 에서 확인).
- **말하기**: 브라우저 음성 인식 · **몽생이 답변 읽기**: 음성 합성 (Chrome/Edge 권장).

## 오더창 패널 (작업·오더)

- **`오더창 패널`** 카드 — **입력**(텍스트·단축 버튼·Web Speech 말하기) → **승인 게이트**(`.env` 토큰 역할 + `I_AGREE`) → **실행 엔진**(`POST /api/mother/command` 슬래시·스냅샷 API).
- **조회 슬래시** (`/help`, `/status`, `/st`, `/snap`, `/jobs`, `/resilience`): 서버에서 `MOTHER_COMMAND_ALLOW_PUBLIC_READ=true` 이면 토큰 없이 가능(속도 제한).
- **민감 슬래시** (`/ops-scan`, `/deploy`, `/restart`): **ADMIN_TOKEN** + 헤더 **`x-policy-ack: I_AGREE`** (대시보드 상단 ack 저장).
- **일반 텍스트 스냅샷**(job·큐·요약): 토큰 필요(운영자 이상 권장). **자동 갱신**은 끔 / 12초 / 45초 선택.

## 업무 플로우

- **대화 / 지시**: 목표 작성 → **계획 생성** → **운영 실행** · 필요 시 파일 업로드 후 진행.
- **자료수집 파이프라인**: 주제 입력(또는 주제 말하기) → 실행 · SFTP 배포는 `DEPLOY_*` 및 방화벽 TCP 22.
- **배포**: SFTP 설정 저장 후 **지금 배포**.

## AI 소통·오더 허브 (전체 워커)

- 「소통·오더」또는 **AI 소통·오더 현황**: 각 AI 카드로 이동하는 앵커, **말하기** 버튼이 붙은 입력란, **진행 중 job**·**워커 큐** 요약.
- job·큐 요약 API는 **유효한 역할 토큰**(ADMIN / OPERATOR / OBSERVER)이 있어야 채워집니다.
- **계획(Plan)** 의 「계획 읽어주기」로 TTS 재생.

## 나반존좌 (가치 연구·배포)

- 「보고 체계」 바로 아래 카드에서 **연구 실행** 또는 **연구 + LLM 보완**으로 `data/values_naban_state.json`에 최신 초안을 쌓습니다.
- **HTML 발행**은 엄격 모드에서 `I_AGREE` 저장 후에만 허용됩니다. 결과는 `tour/generated/values/naban-zonza.html`에 기록됩니다.
- 비인증 공개 요약: `GET /api/values-naban/public/summary`.

## 오로라 · 비지구 주파수 연구 AI

- 오른쪽 열 **스펙트럼** 카드에서 제어합니다. **신규 설치 시 자동 스윕은 기본 비활성화**입니다.
- 알림은 **마더 인박스**, **운영자 피드**, **audit.log**로 전달됩니다. 출력은 **연구·시뮬** 목적이며 실측 스펙트럼을 대체하지 않습니다.