86 lines
7.6 KiB
Markdown
86 lines
7.6 KiB
Markdown
# 킨텍스 자동전시시스템 — 작업 현황·인수인계 (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** + **기능 변경 시 자동 업데이트**.
|
|
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. 남은 큐 (후속)
|
|
- **신규 5화면**: BI(M16)·Hall Operations(M14)·Exhibition Schedule·Admin Dashboard(M18)·Component Guide — Stitch 재취득 완료, 반영 대기.
|
|
- **아이콘 세트 교체**(이모지 → 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건·현황·남은 큐·함정 |
|