# AICS_MANUAL

생성일: 2026-06-22 23:26:04

## 1. 먼저 확인할 URL

- 대표 주소: `https://a094756.shop`
- 매뉴얼: `https://a094756.shop/aics/manual`
- 대시보드: `https://a094756.shop/aics`
- API 목록: `https://a094756.shop/aics/apis`
- MD 문서: `https://a094756.shop/aics/docs`
- 에디트플러스: `https://a094756.shop/aics/editplus`
- DB 관리: `https://a094756.shop/aics/db`
- 실시간 DB Schema: `https://a094756.shop/aics/db/schema`

## 2. 새 방 첫 메시지

```text
KidsVillage AICS 작업 이어가자.

이 작업은 ChatGPT, Claude, Codex, 그리고 앞으로 추가될 다른 AI 도구가 번갈아 작업할 수 있다.
사용자가 매번 최신 코딩 내용, 프로그램 구조, DB 구조, 작업 이력을 다시 설명하기 어렵기 때문에,
작업을 시작하는 AI는 반드시 아래 기준 페이지와 문서를 먼저 확인하고 현재 상태를 파악한 뒤 진행한다.

먼저 확인할 기준 페이지:
1. AICS 최신 매뉴얼
   https://a094756.shop/aics/manual

2. 파일 구조 / 최신 코드 확인
   https://a094756.shop/aics/editplus

3. DB 구조 / 테이블 / 최근 데이터 확인
   https://a094756.shop/aics/db

4. 실시간 DB Schema
   https://a094756.shop/aics/db/schema

5. 운영 기준 / 사이트맵 / 업무 룰북
   https://a094756.shop/aics/rules

6. MD 문서 목록
   https://a094756.shop/aics/docs

반드시 먼저 읽을 기준 문서:
- PROJECT_RULES.md
- AICS_MASTER_PLAN.md
- AICS_MANUAL.md
- DB_SCHEMA.md
- WORKFLOW_GUIDE.md
- CHANGELOG_AI.md
- API_STRATEGY.md
- 추후 생성될 API_CATALOG.md

중요한 작업 원칙:
- 기존 /cs 화면과 새 /aics 화면은 섞지 않는다.
- 새 기능은 /aics 기준으로 만든다.
- 기존 /cs 화면은 참고만 하고, 안정 화면은 함부로 수정하지 않는다.
- 본서버 데이터를 변경하는 쓰기 API는 당분간 보류한다.
- 읽기 API, DB 미러링, 문서화, 업무 화면화 순서로 진행한다.
- 변경 전 백업은 필수다.
- route_loader.py에 모듈을 등록할 때는 기존 등록 방식과 함수 위치를 먼저 확인한다.
- 공용 JS/CSS를 수정할 때는 기존 화면 영향 범위를 먼저 확인한다.
- DB 구조가 바뀌면 /aics/db 에서 DB_SCHEMA 생성을 눌러 DB_SCHEMA.md를 갱신한다.
- 매뉴얼 내용까지 파일로 남길 때는 /aics/manual 에서 AICS_MANUAL 생성을 눌러 AICS_MANUAL.md를 갱신한다.
- 운영 정책이나 업무 판단 기준이 생기면 /aics/rules 에 기록한다.

현재 AICS 주요 경로:
- /aics : 새 AICS 대시보드
- /aics/manual : 최신 매뉴얼 / 새 방 인수인계
- /aics/apis : API 목록/상태
- /aics/docs : MD 문서
- /aics/editplus : 파일 구조 보기 / 허용 파일 수정
- /aics/db : SQLite DB 조회 전용 뷰어
- /aics/rules : 운영 기준 / 사이트맵 / 업무 룰북

현재 서버 기준:
- 서버 경로: /opt/kvcs
- FastAPI 서비스: kvcs
- DB: /opt/kvcs/data/ai_cs.db
- 정적 파일: /opt/kvcs/static
- 문서 폴더: /opt/kvcs/docs
- 운영 기준 폴더: /opt/kvcs/docs/rules

현재 작업 흐름:
1. ChatGPT와 작업하다가 Claude로 크로스체크할 수 있다.
2. Codex로 실제 코드 수정 작업을 할 수 있다.
3. 다시 ChatGPT 또는 Claude로 돌아올 수 있다.
4. 이때 사용자가 최신 코드/DB/작업 내용을 다시 설명하지 않아도 되도록,
   각 AI는 /aics/manual, /aics/editplus, /aics/db, /aics/rules를 먼저 확인해야 한다.

현재 마지막 주요 작업:
- /aics/manual 에 새 방 첫 메시지 수정/저장 기능 추가
- /aics/db 에 DB_SCHEMA.md 자동 생성 기능 추가
- /aics/editplus 에 서버 파일 구조 보기/수정 기능 추가
- /aics/rules 에 운영 기준/사이트맵/도식 수정 기능 추가
- /aics/rules 는 사람 중심의 키즈빌 화면별 업무 기준표로 정리 중

작업을 시작하기 전에 할 일:
1. /aics/manual 에 접속해서 최신 기준을 확인한다.
2. /aics/editplus 에서 현재 파일 구조와 수정 대상 파일을 확인한다.
3. /aics/db 에서 DB 테이블과 row 수, 필요한 테이블 구조를 확인한다.
4. /aics/rules 에서 관련 업무 기준이나 정책 기준을 확인한다.
5. 필요한 경우 먼저 현재 상태 확인 명령을 사용자에게 요청한 뒤 코드를 작성한다.

이 인수인계문은 새 ChatGPT 방, Claude, Codex, Gemini 등 다른 AI 도구에 그대로 붙여넣는 시작 메시지로 사용한다.

*robots차단으로 https://a094756.shop/aics-public/handoff.md 이문서부터 읽어야돼\n
```

## 3. Claude / Codex 지침

```text
작업 시작 전 /aics/manual 확인. 파일 구조는 /aics/editplus, DB 구조는 /aics/db 및 /aics/db/schema, 문서는 /aics/docs 기준. 변경 전 백업 필수. 기존 /cs 안정 화면은 직접 수정하지 말고 새 /aics 경로에 신규 기능을 만든다.
```

## 4. 기준 문서

| 문서 | 역할 | 존재 | 수정일 |
|---|---|---:|---|
| `PROJECT_RULES.md` | 기존 /cs와 새 /aics를 섞지 않는 원칙, 백업, 금지사항, 개발 순서 | Y | 2026-06-18 22:59:58 |
| `AICS_MASTER_PLAN.md` | AICS 장기 방향, 운영 데이터웨어하우스 방향, 우선순위 | Y | 2026-06-18 23:54:42 |
| `API_CATALOG.md` | 키빌 본서버 API 목록, 미러링 대상, 위험도, 사용 화면 | N | - |
| `DB_SCHEMA.md` | SQLite 테이블/컬럼/용도/주의사항 자동 생성 문서 | Y | 2026-06-19 00:53:02 |
| `WORKFLOW_GUIDE.md` | 근무자 업무 흐름, 게시판/카톡/주소변경 처리 기준 | Y | 2026-06-18 22:59:58 |
| `CHANGELOG_AI.md` | AICS 작업 변경 기록 | Y | 2026-06-22 21:04:07 |

## 5. DB 요약

- DB 파일: `/opt/kvcs/data/ai_cs.db`
- DB 크기: `58.38 MB`
- DB 수정일: `2026-06-22 23:00:49`
- 테이블 수: `5`
- 총 row 수: `74265`

## 6. API 요약

- API 후보 수: `11`
- 운영: `1`
- 준비: `3`
- 예정: `6`
- 보류: `1`

## 7. 절대 원칙

- 기존 `/cs/...` 화면과 새 `/aics` 화면을 섞지 않는다.
- 새 기능은 `/aics` 기준으로 만든다.
- 본서버 데이터를 변경하는 쓰기 API는 보류한다.
- 읽기 API, DB 미러링, 문서화, 업무 화면화 순서로 진행한다.
- 작업 전 백업을 만든다.
- DB 구조가 바뀌면 `/aics/db`에서 `DB_SCHEMA 생성`을 눌러 문서를 갱신한다.
- API 목록이 바뀌면 향후 `API_CATALOG.md`를 갱신한다.