# AICS 운영 기준 인덱스 분류: AICS 운영 기준 상태: 초안 중요도: 상 작성일: 2026-06-22 관련 화면: /aics/rules, /aics/manual, /aics/apis, /aics/db --- ## 1. 목적 이 문서는 키즈빌 AICS에서 관리하는 운영 기준 문서의 상위 목차다. 근무자와 AI 도구가 같은 기준으로 업무를 이해하도록, 키즈빌 화면별 업무 기준과 판단 문서를 연결한다. --- ## 2. AICS 운영 기준 원칙 1. 기존 `/cs` 화면과 새 `/aics` 화면은 섞지 않는다. 2. 새 기능은 `/aics` 기준으로 만든다. 3. 기존 `/cs` 화면은 참고만 하고 안정 화면은 함부로 수정하지 않는다. 4. 본서버 데이터를 변경하는 쓰기 API는 당분간 보류한다. 5. 읽기 API, DB 미러링, 문서화, 업무 화면화 순서로 진행한다. 6. 업무 판단 기준이 생기면 `/aics/rules`에 문서로 남긴다. 7. DB 구조가 바뀌면 `/aics/db`에서 `DB_SCHEMA.md`를 갱신한다. 8. 매뉴얼 내용이 바뀌면 `/aics/manual`에서 `AICS_MANUAL.md`를 갱신한다. --- ## 3. 키즈빌 화면별 업무 기준표 | 업무 영역 | 실제 화면/위치 | 근무자가 보는 기준 | 연결 문서 | |---|---|---|---| | 쇼핑몰 상단 | 쇼핑몰 > 상단 메뉴 | 소매점이 진입하는 주요 메뉴와 용어 기준 | `KIDSVILLAGE_SHOP_TOP.md` | | 상품현황 | 쇼핑몰 > 상품현황 | 소매점이 주문/입고/미송/배송요청 가능 여부를 확인하는 핵심 화면 | `SHOP_ITEM_STATUS_POLICY.md` | | 고객센터 게시판 | 쇼핑몰 > 고객센터 | 게시판 문의 유형 분류와 답변 기준 | `BOARD_REPLY_POLICY.md` | | 주소변경 | 게시판/카톡/주문상세 | 주소 변경 가능 여부와 오배송 방지 기준 | `ADDRESS_CHANGE_POLICY.md` | | 관리자 주문내역 | 관리자 > 쇼핑몰관리 > 주문내역 | 주문번호, 입금, 미수금, 주문/배송 상태 확인 기준 | `KIDSVILLAGE_ADMIN_ORDER_LIST.md` | | 배송요청 대기 | OM > 배송요청 대기 상품 | 소매점 배송요청 상품 확인 및 출고 처리 기준 | `SHIPPING_REQUEST_WAITING.md` | | 재교환 정상상품 | OM > 배송요청/교환 관련 화면 | 정상상품 재입고 후 배송요청 대기 노출 기준 | `RE_EXCHANGE_NORMAL_ITEM.md` | | 이미지/엑셀 다운로드 | 관리자 > 상품 목록 업로드 기록 / 트래픽 분석 | 과다 다운로드, 차단 후보 판단 기준 | `TRAFFIC_DOWNLOAD_BLOCK_POLICY.md` | --- ## 4. 현재 문서 목록과 역할 ### `KIDSVILLAGE_SHOP_TOP.md` 쇼핑몰 상단 메뉴 기준 문서다. 로그인, 회원가입, 장바구니, 상품현황, 원클릭, 고객센터 같은 소매점 진입 메뉴를 정의한다. ### `KIDSVILLAGE_ADMIN_ORDER_LIST.md` 관리자 주문내역 화면 기준 문서다. 주문번호, 주문자, 입금합계, 미수금, 중도매 정보, 붉은 배경 주문 같은 운영 판단 기준을 정리한다. ### `BOARD_STATUS_BADGE_POLICY.md` 게시판 상태 배지 표시 기준 문서다. 문의유형, 상품 진행상태, OM상태, 불량/교환/오배송 이슈 배지를 분리해서 표시하는 기준을 정리한다. 미송/리오더/발주/주문접수를 `OM미확인`으로 표시하지 않는 원칙을 고정한다. ### `BOARD_REPLY_POLICY.md` 게시판 답변 기준 문서다. 작성자, 주문번호, 상품명, 문의 유형, 상태, 불량/교환/오배송 이력 확인 기준을 정리한다. ### `ADDRESS_CHANGE_POLICY.md` 주소변경 요청 처리 기준 문서다. 주문 존재 여부, 소매점 일치 여부, 송장 출력/출고 여부, 개인정보 노출 주의 기준을 정리한다. ### `SHIPPING_REQUEST_WAITING.md` 배송요청 대기 상품 기준 문서다. 소매점 배송요청 상품, 픽업 대기, 택배 요청, 출고완료 제외 기준을 정리한다. ### `RE_EXCHANGE_NORMAL_ITEM.md` 재교환 정상상품 입고 후 배송요청 대기 기준 문서다. 과거 송장과 최신 정상상품입고 사이클을 구분하는 기준을 정리한다. ### `OM_STATUS_POLICY.md` OM 입고/출고 상태 기준 문서다. OM미확인은 입고된 상품 중 OM에서 아직 확인하지 않은 상품에만 사용하며, 미송/리오더/발주/주문접수와 혼동하지 않는 기준을 정리한다. ### `TRAFFIC_DOWNLOAD_BLOCK_POLICY.md` 이미지/엑셀 다운로드 과다 기준 문서다. 최근 주문 수, 다운로드 수, 트래픽 MB, 다운로드/주문 비율, 최근 주문일 등을 기준으로 차단 후보를 판단한다. --- ## 5. 추가로 만들어야 할 문서 | 예정 문서 | 목적 | 우선순위 | |---|---|---| | `SHOP_ITEM_STATUS_POLICY.md` | 소매점 상품현황의 주문접수/발주/입고/미송/리오더/배송요청 가능 상태 기준 | 상 | | `OM_STATUS_POLICY.md` | OM 입고/출고 상태와 소매점 표시 상태의 차이 정리 | 상 | | `BOARD_STATUS_BADGE_POLICY.md` | AICS 게시판 상태 배지 기준. 미송/리오더를 OM미확인으로 바꾸지 않는 원칙 포함 | 상 | | `WHOLESALE_KAKAO_POLICY.md` | 중도매 카톡 업무추적의 분류/상태/답변대기 기준 | 중 | | `API_MIRRORING_POLICY.md` | 키빌 본서버 읽기 API를 AICS DB로 미러링하는 순서와 원칙 | 중 | --- ## 6. AI 작업자 확인 순서 새 AI 도구가 AICS 작업을 이어갈 때는 아래 순서로 확인한다. 1. `https://a094756.shop/aics-public/handoff.md` 2. `/aics/manual` 3. `/aics/editplus` 4. `/aics/db` 5. `/aics/rules` 6. 관련 rules 문서 7. 수정 대상 코드 8. 변경 전 백업 9. 수정 10. 검증 11. `CHANGELOG_AI.md` 기록 --- ## 7. 주의사항 - rules 문서는 코드보다 먼저 업무 판단 기준을 고정하기 위한 문서다. - 기준이 불명확하면 코드로 자동화하지 않는다. - 근무자가 실제로 보는 화면 단어를 우선한다. - AI가 임의 용어를 만들지 않는다. - 소매점 화면 기준과 관리자/OM 기준을 섞지 않는다. - 상태값은 원본 시스템의 의미를 보존한다.