zio/kintex
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
433eb83a16
kintex/docs
History
zio 433eb83a16 feat(ux,domain,data): checkpoint — search domain, approval WISE, calendar M/W/D, holidays 2050, dept org-tree, offcanvas, settings icon, V39 demo realism 
- search: domain results (event/exhibition/company/auction/booth/lead/CMS) with routes; PII-safe
- approval WISE: compose + approval-line editor, reject flow, resubmit rejected, 4-tab inbox
- schedule: month/week/day views (WISE CalendarView), 50:50 split, day-number top, no bottom gap
- holidays: system-mgmt holiday admin + V41 KR holidays 2024~2050 (lunar+substitute),
  calendar red + holiday-name label; route/menu wired
- dept: WISE org-tree 2-pane
- shared Offcanvas component; hall-assign chip -> right slide-in detail
- top-bar settings icon; home 2-col bottom-aligned; analytics ?tab= deep-link; grid font
  unified to Nifty "Advanced table headers"; form width cap; 2-pane 50:50
- data V39: 3 ongoing exhibitions + rich closed-loop (e-2026-live) + demo-account event
  membership + demo OTP seed — resolves "everything goes home" / floorplan+gallery 403
- Nifty design-system learning doc + refs index; product name unified; new harnesses
  (wise-ui, renewal/testdata, benchmark/crawler, menu-ia)
- i18n: all pending keys merged, missing=0 (except in-progress 3-track keys)
- verified: tsc -b --force, vite build, compileJava, test all EXIT 0

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-12 17:44:30 +09:00
..
analysis feat(ux,domain,data): checkpoint — search domain, approval WISE, calendar M/W/D, holidays 2050, dept org-tree, offcanvas, settings icon, V39 demo realism 2026-07-12 17:44:30 +09:00
architecture feat(v2.0): Phase A 아키텍처 + WISE 개발문서 + PM/PMO + DB 계층 + 프론트 착수 2026-07-11 18:10:01 +09:00
assets/floorplans feat(v2.0): 자동전시시스템 하네스 재구성 + PLANNING v2.0 + 백엔드 스캐폴드 + 평면도 자산 2026-07-11 17:32:40 +09:00
deliverables feat: login slide CMS + G2B RFP doc + 4 report decks + SCR-31 screen 2026-07-12 01:00:35 +09:00
API_GUIDE.md feat(v2.0): Phase A 아키텍처 + WISE 개발문서 + PM/PMO + DB 계층 + 프론트 착수 2026-07-11 18:10:01 +09:00
BACKLOG.md feat(frontend): 신규 5화면 SCR-13~17 — 경영분석·현장운영·전시일정·관리자·스타일가이드 2026-07-11 21:56:28 +09:00
BUILD_DEPLOY.md feat(v2.0): Phase A 아키텍처 + WISE 개발문서 + PM/PMO + DB 계층 + 프론트 착수 2026-07-11 18:10:01 +09:00
COMMON_CODES.md feat(v2.0): Phase A 아키텍처 + WISE 개발문서 + PM/PMO + DB 계층 + 프론트 착수 2026-07-11 18:10:01 +09:00
DESIGN_SYSTEM_NIFTY.md feat(ux,domain,data): checkpoint — search domain, approval WISE, calendar M/W/D, holidays 2050, dept org-tree, offcanvas, settings icon, V39 demo realism 2026-07-12 17:44:30 +09:00
design.md feat(ux,system,identity): waves 10-12 + renewal-1 — WISE shell (hamburger/accordion IA), system-mgmt basics (V37), email channel (V36), product identity, home AI hub, demo seed (V38), menu IA, app-QR, product rename 2026-07-12 15:57:34 +09:00
DEVELOPMENT_GUIDE.md feat(v2.0): Phase A 아키텍처 + WISE 개발문서 + PM/PMO + DB 계층 + 프론트 착수 2026-07-11 18:10:01 +09:00
ENV_SETUP.md feat(v2.0): Phase A 아키텍처 + WISE 개발문서 + PM/PMO + DB 계층 + 프론트 착수 2026-07-11 18:10:01 +09:00
FEATURE_BACKLOG_100.md docs: 전시관리 100대 기능 백로그 + 갭분석 (AI 자동화·NFR 강조) 2026-07-11 20:55:04 +09:00
FEATURE_GAP_ANALYSIS.md docs: 전시관리 100대 기능 백로그 + 갭분석 (AI 자동화·NFR 강조) 2026-07-11 20:55:04 +09:00
GUARDIA_ALIGNMENT.md chore: GUARDiA 재사용 패턴 흡수 — 스모크 러너·push·정합/보안/운영 문서 2026-07-11 19:54:35 +09:00
IMPLEMENTATION_BACKLOG.md feat: mobile harness + design v2.1 (84 screens) + PLANNING v3.1 + deliverables + Stitch screens 2026-07-11 23:31:45 +09:00
OPS_RUNBOOK.md chore: GUARDiA 재사용 패턴 흡수 — 스모크 러너·push·정합/보안/운영 문서 2026-07-11 19:54:35 +09:00
PLANNING.md feat(ux,domain,data): checkpoint — search domain, approval WISE, calendar M/W/D, holidays 2050, dept org-tree, offcanvas, settings icon, V39 demo realism 2026-07-12 17:44:30 +09:00
README.md feat(v2.0): Phase A 아키텍처 + WISE 개발문서 + PM/PMO + DB 계층 + 프론트 착수 2026-07-11 18:10:01 +09:00
RFP_나라장터_제안요청서.md feat: login slide CMS + G2B RFP doc + 4 report decks + SCR-31 screen 2026-07-12 01:00:35 +09:00
SECURITY.md chore: GUARDiA 재사용 패턴 흡수 — 스모크 러너·push·정합/보안/운영 문서 2026-07-11 19:54:35 +09:00
UNDEVELOPED_BACKLOG.md docs: backlog full status sweep — reflect waves 2-6 completions 2026-07-12 10:56:43 +09:00
WORK_STATUS.md feat(ux,system,identity): waves 10-12 + renewal-1 — WISE shell (hamburger/accordion IA), system-mgmt basics (V37), email channel (V36), product identity, home AI hub, demo seed (V38), menu IA, app-QR, product rename 2026-07-12 15:57:34 +09:00

README.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. 신규 개발자 시작 순서 (권장)

  1. 이 문서로 문서 지도 파악 → ../CLAUDE.md 규칙 숙지
  2. ENV_SETUP.md — 로컬 개발환경 구축(JDK17·Node·PostGIS·Redis·Python 워커)
  3. PLANNING.md §1~2(배경·역할) + design.md(화면) 로 도메인 이해
  4. DEVELOPMENT_GUIDE.md + API_GUIDE.md + COMMON_CODES.md 로 개발 표준 습득
  5. IMPLEMENTATION_BACKLOG.md 에서 자기 Phase/모듈 확인 후 착수 (Phase A 아키텍처 → B 공통 → C 코어 → D 도메인 → E 배포)

중복 회피 원칙: 기획·화면·모듈 정의는 PLANNING/design/BACKLOG가 정본이다. 본 개발 문서 세트는 그 내용을 재서술하지 않고 링크·요약만 한다. 아키텍처(app/system/tech/data/network)는 Phase A 아키텍트 산출물(architecture/)이 정본이며 본 세트에서 생성하지 않는다.