zio/kintex
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
117d1b3d56
kintex/docs/WORK_STATUS.md

8.4 KiB
Raw Blame History

킨텍스 자동전시시스템 — 작업 현황·인수인계 (WORK_STATUS)

목적: 다른 PC/세션에서 작업을 이어가기 위한 단일 인수인계 문서. 수시 업데이트(기능 추가·변경·트랙 완료 시 갱신 후 커밋). 최종 갱신: 2026-07-11 · 리포 git.zioinfo.co.kr/zio/kintex(main) · 시크릿(비밀번호·키·서버IP)은 본 문서에 미기재(env·GUARDiA 공용 참조).

0. 빠른 시작 (다른 PC에서 이어받기)

  1. git clone zio/kintex → main.
  2. 핵심 문서: docs/PLANNING.md(v3.0 기획)·docs/design.md(v1.2 화면·MDI)·docs/IMPLEMENTATION_BACKLOG.md·docs/FEATURE_BACKLOG_100.md·docs/architecture/*·docs/GUARDIA_ALIGNMENT.md·docs/SECURITY.md·docs/ENV_SETUP.md·docs/OPS_RUNBOOK.md·CLAUDE.md.
  3. 하네스: .claude/(에이전트 ~20 + kintex-impl-orchestrator 스킬). 구현은 오케스트레이터가 조율.
  4. 이 문서(WORK_STATUS.md)로 "무엇이 됐고/도는 중/남았는지" 파악.

1. 프로젝트 개요

킨텍스 자동전시시스템(다중 전시관 멀티테넌트 SaaS, KINTEX=테넌트#1, COEX 등 온보딩). 전시 생애주기(판매→AI 설계·시각화→공사 옥션→시공→운영→경영분석) 폐루프.

2. 스택·인프라 (시크릿 제외)

  • 프론트 React 18/19(Vite·TS) / 백엔드 Spring Boot 3.2.5(Java17)+MyBatis / DB PostgreSQL+PostGIS(Flyway) / Redis / 나노바나나 Python 워커(google-genai gemini-3.1-flash-image-preview).
  • AI 지능 = Claude 기본(AiTextRouter/AiConfig) + Ollama 폴백. 이미지 = 나노바나나(Gemini, 소유자 승인=G1 라이브).
  • 개발 배포: https://kintex.zioinfo.co.kr(TLS·백엔드 8021·PostGIS·Redis·워커 systemd). 운영 도메인 kintex.wise.ai.kr(후속). 서버 접속 자격증명은 GUARDiA 공용(env·리포 미기재).
  • CI/CD: Gitea webhook → deploy_kintex.sh(백엔드 sh gradlew bootJar + 프론트 vite 빌드 → 배포 → health → 롤백). push하면 자동배포.

3. 요구사항 로그 (이번 세션 누적 — 스코프 진화)

  1. Gitea kintex 리포 생성 + 로컬 소스 push.
  2. kintex.com 전 페이지 분석 + ReRoomAI 소스 분석 → AI 전시시스템 하네스 생성(부스 배치·인테리어·전기·조명·네트워크 배선 자동화 → 나노바나나 시공 후 사진).
  3. 웹/모바일 UI는 디자인 에이전트로 design.md 생성 후 Google Stitch 전달.
  4. 스택 확정: React + Spring Boot + MyBatis + PostgreSQL.
  5. 구현용 하네스 전체 생성(전문 에이전트 + 오케스트레이터 + 백로그).
  6. 자동전시시스템으로 확장: 전시 관련 모든 기능·경영분석(BI)·웹/모바일 역할별 분리·별도 관리자 시스템·CMS.
  7. 사용자 역할: 전시하려는자/공사 입찰사/킨텍스 직원 등 + 일반 대중 공개 홍보 페이지.
  8. 공사업체가 AI 생성 자료 열람 → 견적서 제출 → 옥션(역경매) → 전시업체가 업체 확정.
  9. 부스 구성 AI 1·2·3안 생성 → 선택 또는 병합.
  10. UIWS(WISE) 시스템관리·공통기능 전체 이식(2FA/OTP 포함).
  11. AI·QA·AA·SA·NA·TA·DA + PM·개발PM·PMO 에이전트 고용. AI는 Claude(클로드코드)로 구현 + 설정에서 모델 변경.
  12. 전시장 평면도 크롤링 확보(CAD+JPG) + CAD/JPG 포맷 지원.
  13. 개발서버 + CI/CD 구축(WISE env 참조·kintex.zioinfo.co.kr).
  14. 멀티테넌시(tenant_id) — 코엑스 등 다중 전시관.
  15. MDI(다중문서 인터페이스) 셸.
  16. DB 별도 구성(전용 kintex_db).
  17. GUARDiA 솔루션 재사용 패턴(py/md) kintex 흡수.
  18. 로그인 좌측 히어로 이미지 + CI 로고(ci/ 폴더).
  19. Stitch 전 화면 디자인 반영(이미지 포함) + 신규 화면.
  20. 회원가입·비밀번호 찾기/초기화·아이디 기억.
  21. 반응형 풀스크린 + 모바일 앱.
  22. 전시관리 100대 기능 크롤링·기획(AI 자동화로 수작업 최소화) + 백로그.
  23. 웹접근성·시큐어코딩·다국어·라이트/다크 테마(공통 NFR).
  24. 행안부 산출물 표준 → 사업수행계획서 + 전 산출물 Excel/PPT/Doc. 기능 변경 시 자동 업데이트 → (2026-07-11 변경) 최초 1회 생성 + 개발 완료 시 최종 1회만 갱신(중간 갱신 금지·비용 절감, 자동갱신 스크립트는 최종 시점 실행용).
  25. 사용자·운영자·개발자 지침서 PPT.
  26. 프로그램 사양서(기능별 상세) + 순서도 PPT.
  27. 본 WORK_STATUS.md로 인수인계·수시 업데이트.

4. 완료·라이브 (커밋 기준)

  • 문서: PLANNING v3.0(멀티테넌시)·design.md v1.2(MDI)·아키텍처 5종(app/system/tech/data/network)·WISE 개발문서 6종·FEATURE_BACKLOG_100 + GAP_ANALYSIS·GUARDIA_ALIGNMENT·SECURITY·OPS_RUNBOOK.
  • 백엔드(라이브): 스캐폴드 + 인증(JWT/RBAC) + M2~M5 매퍼 배선(501 해소·PostGIS) + 룰엔진 + Phase B 공통레이어(2FA/OTP·시스템관리·공통 업무기능 V7/V8) + 공개 인증(register·forgot·reset V9). Flyway V1~V9(테이블 39).
  • 프론트(라이브): 로그인(히어로+CI로고+인증 UI: 회원가입·비번찾기·아이디기억) + Stitch 반영(부스 설계 스튜디오·대시보드·갤러리·신규 8화면 SCR-04/05/08/09/10/11 + 모바일 M1/M2) + 번들 이미지 25.
  • 인프라(라이브): 개발서버 8021·PostGIS·Redis·나노바나나 워커(Gemini 라이브)·TLS·CI/CD 자동배포·배포 파이프라인 근본수정.
  • 계정: admin@kintex.zioinfo.co.kr(env 시더, role ADMIN) — 로그인 200 확인.
  • 자산: 평면도 JPG 15 + CAD(트렌치) docs/assets/floorplans/(CAD는 gitignore). Stitch 프로젝트 9385904003821333054 화면 stitch_kintex_ai_system_architect/.

5. 진행 중(백그라운드 에이전트) — 커밋 대기

  • 모바일 앱(Expo, mobile/) 스캐폴드.
  • 산출물: 사업수행계획서 + 행안부 표준양식 크롤링 + 전 산출물 Excel/PPT/Doc(docs/deliverables/) + 자동갱신 스크립트.
  • 지침서 3종(사용자·운영자·개발자) PPT(docs/deliverables/지침서/).
  • 프로그램 사양서(기능별 상세) + 순서도 PPT(docs/deliverables/프로그램사양서/).

6. 남은 큐 (후속)

상세 미개발 통합 목록: docs/UNDEVELOPED_BACKLOG.md (2026-07-11 세션 스캔 — 화면별 샘플→실데이터 전환·커밋 대기·NFR·대형 트랙 전체)

  • 신규 5화면: 반영 대기 → 구현 완료(2026-07-11) — SCR-13~17(경영분석 /analytics·현장운영 /ops/operations·전시일정 /schedule·관리자 랜딩 /admin·스타일가이드 /_styleguide) design.md v1.3 매핑 + React 이식(tsc 통과·Recharts 도입). QA·reviewer·커밋 마감 진행 중. 데이터는 대부분 샘플(집계 API 미구축 — UNDEVELOPED_BACKLOG §1).
  • 아이콘 세트 교체(이모지 → Stitch 정식 아이콘, _icons/).
  • 반응형 풀스크린 + 라이트/다크 테마 + 다국어(i18n) + 접근성 전면 적용.
  • 100대 기능 갭(신규19/부분18) → orchestrator Phase 편입 구현(관람객·네트워킹·참가업체 서비스 집중).
  • 멀티테넌시 구현(DA 데이터모델 → db-engineer tenant_id 스키마 → backend 테넌트 컨텍스트).
  • MDI 프론트 전환(design.md §2.7 기준).
  • 도메인 모듈 구현: 옥션(M15)·관람객(M10)·CMS/공개사이트(M12/M17)·BI(M16)·관리자(M18).

7. 배포·운영 함정 (반드시 숙지)

  • deploy_kintex.sh는 백엔드도 빌드해야 함(과거 미빌드 버그·수정됨). gradlew는 sh ./gradlew(실행권한 이슈). grep -q SIGPIPE 회피.
  • git 대용량(CAD·PNG·build)로 커밋/푸시 느림 → 특정 경로 add + push 재시도. CAD/build/node_modules gitignore.
  • 로컬 vite build는 win32 rollup 크래시 가능 → 서버 빌드 신뢰(tsc 통과로 검증).
  • 서버 /opt/zioinfo/deploy_server.py(kintex 블록)·/opt/kintex/ 수정 시 반영+재시작.
  • 보안 불변: 외부API 금지(Claude·Gemini 예외)·자격증명 미노출·AI 이미지 워터마크·admin env 시더.

8. 변경 이력 (이 문서)

일자 갱신
2026-07-11 최초 작성 — 요구사항 27건·현황·남은 큐·함정
2026-07-11 신규 5화면(SCR-13~17) 구현 완료 반영 + 미개발 통합 백로그 UNDEVELOPED_BACKLOG.md 신설·연결