zio
4049b7c222
- fix(security): verifyOtp/enrollVerify consumed the challenge BEFORE code verification — one mistyped TOTP burned the session and every retry hit "세션 만료" (live incident). Now consume only on success, keep challenge for up to 5 failures (OtpChallengeStoreTest) - SCR-14 ops: congestion from real check-in aggregates, power from utility orders; hardware widgets stay as honest "sensor not connected" empty states - M9 settlement: /api/settlement (dashboard/invoices/generate/issue/payments), V24 invoice tables, server-authoritative amounts (ST_Area x rate + VAT), PG-delegation notice, /settlement UI - M1 hall assign: /api/halls CRUD + period-overlap conflict (409 with details) + rates-v1.0 auto-quote, V25 idempotent period columns, /halls board UI - shared: AuthUser.roleCode (JWT rc claim, additive), AdminGuard precise check, AppShell placeholder nav wired via event-context builders, /_styleguide dev-only route Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| analysis | ||
| architecture | ||
| assets/floorplans | ||
| deliverables | ||
| API_GUIDE.md | ||
| BACKLOG.md | ||
| BUILD_DEPLOY.md | ||
| COMMON_CODES.md | ||
| design.md | ||
| DEVELOPMENT_GUIDE.md | ||
| ENV_SETUP.md | ||
| FEATURE_BACKLOG_100.md | ||
| FEATURE_GAP_ANALYSIS.md | ||
| GUARDIA_ALIGNMENT.md | ||
| IMPLEMENTATION_BACKLOG.md | ||
| OPS_RUNBOOK.md | ||
| PLANNING.md | ||
| README.md | ||
| RFP_나라장터_제안요청서.md | ||
| SECURITY.md | ||
| UNDEVELOPED_BACKLOG.md | ||
| WORK_STATUS.md | ||
킨텍스 자동전시시스템 — 문서 인덱스 (문서 지도)
WISE(UIWS) 참조 — 본 문서 세트는 GUARDiA 표준 프레임워크 정본
workspace/uiws(UIMS/WISE)의 개발 문서 구성을 레퍼런스로 킨텍스에 맞게 구성했다. 목적: 처음 합류하는 개발자가 "어떤 문서가 무엇을 담는지" 한눈에 파악하고, 중복 없이 정본 문서로 이동하게 한다.
1. 프로젝트 한 줄 요약
킨텍스(한국국제전시장) 전시 운영 전 과정 — 부스 배치 → 부스/장치 설계 → 유틸리티 배선 → 나노바나나(Gemini) 시공 후 사진 시각화 → 공사 옥션 → 관람객·경영분석·공개사이트 — 을 AI로 자동화하는 자동전시시스템(Exhibition Automation Platform).
- 스택: React(Vite·TS) + Spring Boot 3.x(Java 17)·MyBatis + PostgreSQL(PostGIS) + Redis + 나노바나나 Python 워커
- 패키지:
com.zioinfo.kintex· DB:kintex_db - AI: Claude 기본 + 설정형 프로바이더 전환(
AiTextRouter/AiConfig) — GUARDiA 표준 프레임워크 준수 - 공통 레이어(인증 2FA·시스템관리·업무기능) 레퍼런스: WISE(UIWS)
workspace/uiws
2. 문서 지도
2-1. 기획·설계 (정본 — 해당 에이전트 경유로만 수정)
| 문서 | 담는 내용 | 수정 경로 |
|---|---|---|
PLANNING.md |
시스템 기획서 v2.0 — 배경·역할/페르소나·모듈(M1~M18)·역할별 포털 분리·아키텍처 개요·나노바나나 파이프라인·리스크(R1~R12) | planner 에이전트 |
design.md |
UI 디자인 스펙 v1.1 — 화면(SCR-*) Stitch 프롬프트·화면 흐름·컴포넌트 | designer 에이전트 |
IMPLEMENTATION_BACKLOG.md |
구현 백로그 v2.0 — Phase A~E, 모듈별 작업·담당 에이전트·완료 기준·선행 게이트(G1/G2) | kintex-impl-orchestrator |
BACKLOG.md |
검증(reviewer) 지적사항 티켓 목록 | reviewer 에이전트 |
architecture/ (Phase A 예정) |
애플리케이션·시스템·기술·데이터·네트워크 아키텍처 — kintex-aa/sa/ta/da/na 산출 예정 | 아키텍트 팀 (Phase A) |
2-2. 개발·온보딩·표준 (본 세트 — WISE 참조로 신규 작성)
| 문서 | 담는 내용 |
|---|---|
README.md |
(이 문서) 문서 인덱스·문서 지도 |
DEVELOPMENT_GUIDE.md |
개발 표준 — 패키지/레이어·코딩 규약·인증(JWT+2FA/OTP)·보안 불변·브랜치/커밋(conventional)·테스트·PR |
ENV_SETUP.md |
개발환경 구축 — JDK17·Node·PostgreSQL+PostGIS·Redis·Python 워커 설치·실행·환경변수 목록 |
COMMON_CODES.md |
공통코드 정의 — WISE 공통코드 체계 + 킨텍스 도메인 코드(역할·부스타입·상태·규정 심각도·옥션 상태 등) |
API_GUIDE.md |
API 규약 — 경로·응답 봉투·오류 코드·인증 헤더·RBAC. 상세 계약은 백엔드 계약서 링크 |
BUILD_DEPLOY.md |
빌드/실행 개요 — gradlew·vite·나노바나나 워커·단일 산출물. 상세 CI/CD는 Phase E devops |
2-3. API·워커 계약 (정본 — 경계면 단일 진실원천)
| 문서 | 담는 내용 |
|---|---|
../_workspace/01_backend_contracts.md |
P0 백엔드 API 계약 — 인증·M2~M5 엔드포인트·응답 shape·오류 코드·DB 매퍼 인수 목록 (frontend·db·qa 대조용) |
../tools/nanobanana/_workspace/01_worker_contract.md |
나노바나나 워커 계약 — RenderJob 큐·scene 스키마·콜백 |
2-4. 리서치·자산
| 위치 | 담는 내용 |
|---|---|
analysis/kintex-website.md |
kintex.com 전 페이지 + 주최자/참가업체 매뉴얼 분석 |
analysis/reroomai-source.md |
ReRoomAI 소스 분석(나노바나나 image-to-image 패턴) |
assets/floorplans/ |
홀별 평면도 JPG 15장 + CAD(트렌치 DWG, gitignore·로컬 보존) |
2-5. 하네스
| 위치 | 담는 내용 |
|---|---|
../CLAUDE.md |
프로젝트 마스터 컨텍스트 — 규칙·에이전트 워크플로·하네스 이력 |
../.claude/agents/ |
전문 에이전트 17종(아키텍트·공통·코어·도메인·AI·QA·devops) + 범용(planner·designer·developer·visualizer·reviewer) |
../.claude/skills/ |
스킬(kintex-impl-orchestrator·nanobanana-visualize) |
3. 신규 개발자 시작 순서 (권장)
- 이 문서로 문서 지도 파악 →
../CLAUDE.md규칙 숙지 ENV_SETUP.md— 로컬 개발환경 구축(JDK17·Node·PostGIS·Redis·Python 워커)PLANNING.md§1~2(배경·역할) +design.md(화면) 로 도메인 이해DEVELOPMENT_GUIDE.md+API_GUIDE.md+COMMON_CODES.md로 개발 표준 습득IMPLEMENTATION_BACKLOG.md에서 자기 Phase/모듈 확인 후 착수 (Phase A 아키텍처 → B 공통 → C 코어 → D 도메인 → E 배포)
중복 회피 원칙: 기획·화면·모듈 정의는 PLANNING/design/BACKLOG가 정본이다. 본 개발 문서 세트는 그 내용을 재서술하지 않고 링크·요약만 한다. 아키텍처(app/system/tech/data/network)는 Phase A 아키텍트 산출물(
architecture/)이 정본이며 본 세트에서 생성하지 않는다.