2026-10-12 12:37:46 +09:00
2026-10-12 12:37:46 +09:00
2026-10-12 12:37:46 +09:00
2026-10-12 12:37:46 +09:00
2026-10-12 12:37:46 +09:00
2026-10-12 12:37:46 +09:00
2026-10-12 12:37:46 +09:00
2026-10-12 12:37:46 +09:00
2026-10-12 12:37:46 +09:00

KART

KART 설문 데이터 시각화 시스템

실행

npm run dev

기본 포트: 4014

환경변수

프로젝트 생성 시 .env, .env.local, .env.development, .env.production, .env.example이 함께 생성됩니다.

  • .env: 모든 환경 공통값
  • .env.local: 개발자 PC 전용값(Git 제외)
  • .env.development: 개발 빌드값
  • .env.production: 운영 빌드값
  • .env.example: 환경변수 작성 예시

.env.local은 다른 환경 파일보다 우선 적용되므로 운영 빌드에서는 제거하거나 Jenkins 정책에 맞게 관리합니다.

공통 자원

  • npm package: @kri/common
  • UI Registry: https://ui-registry.kric.com/r

검증

npm run typecheck
npm run build

Agent Harness

  • 프로젝트 ID: kart-front-next
  • 프로젝트 유형: internal-service
  • 권위 원본: .agent/profile.yml, .agent/project.md, .agent/references/*.md

AGENTS.md와 CLAUDE.md는 중앙 Agent Harness가 합성합니다. 두 파일을 직접 수정하지 않습니다.

기본 업무 화면

  • 로그인/로그아웃, 프로젝트 검색·선택, 최신 6개, /Report/Current?projectType=0&pkey=... 진행 현황을 연결했다. 기본 포트는 프런트 4014, 서버 API는 http://localhost:4015/api/v1이다. 운영 API_SERVER는 실제 배포 주소로 별도 설정해야 한다.
  • 브라우저는 /api/login, /api/logout, /api/project/..., /api/log/visit만 호출하며 서버 API Key를 갖지 않는다. Next 서버가 로그인 accessToken을 24시간 HttpOnly/SameSite=Lax 쿠키에 저장하고 검증한 사용자 필드만 브라우저로 반환한다. ENV=prod/production은 Secure 쿠키다. 백엔드 logout/session API는 호출하지 않고 Next에서 쿠키를 삭제한다.
  • 공용 @kri/common 0.19.1 HTTP와 persistent atom의 hydratedAtom, 기존 앱 셸·UI 및 TanStack Query를 사용한다. 캐시 키는 사용자 id/role/team과 프로젝트 유형·원문 PKEY를 포함하고, 로그인/로그아웃 시 캐시를 비운다. 데이터는 30초 staleTime, 수동 새로고침을 지원한다. 브라우저와 서버 응답은 런타임 검증하며 표시 단계에서만 레이블/날짜를 정리한다.
  • 현황은 응답자 현황, 서버가 반환한 LOI 문자열, 일별 Total 막대·완료/스크린/쿼터 선, 문항별 스크린 표를 표시한다. 날짜 범위는 실제 날짜·양끝·순서를 검증하고 type/loi/screen에만 전달한다. daily는 기존처럼 전체 기간이며 일자 선택으로 상세 조회한다. 빈 결과/오류/재시도와 기본 반응형을 포함한다. 기존 화면과 픽셀 수준의 시각 동일성은 아직 검수하지 않았다.
  • 쿼터·북마크·파생변수 관리·import/export·공유/External UI는 다음 구현 범위다. 현재 기본 화면을 전체 프런트 구현 완료로 간주하지 않는다. 실데이터 구/신 결과 및 실제 Excel 비교는 사용자 결정에 따라 전체 프런트 연결 후 수행한다.

기본 기능 검증

  • npm run typecheck
  • npm run build
  • 변경 파일 lint는 통과했다. 전체 npm run lint는 기존 수정하지 않은 KriEditorWysiwyg.tsx의 React Compiler memoization/refs 오류 5개로 실패한다. 공용 에디터 수정은 이번 범위에 포함하지 않았다.
  • 브라우저 UI 자동 검증은 Windows 도구가 현재 URL을 확인하지 못해 중단됐다. 합성 API 기반 HTTP 통합 검증과 빌드는 통과했지만 실제 클릭·새로고침·뷰포트별 화면 검수는 완료하지 못했다.
  • 지침 검증은 새 프로젝트 ID kart-front-next로 실행했다. 기존 AGENTS.md가 생성 원본과 불일치(stale)하여 전체 하네스 검증은 통과하지 못했으며, 이번에 생성 지침 파일을 덮어쓰지는 않았다.

일반 집계·교차표

  • /Report/Tabulation, /Report/Crosstab에서 문항 선택·순서 변경, 중첩 필터, 배너 그룹과 보기 묶음을 설정한다. 일반 집계는 기존처럼 표본의 특성을 먼저 요청하고 선택 문항 배열을 집계한다.
  • 공용 streamPost와 TanStack Query를 사용한다. Next 프록시는 응답을 버퍼링하지 않고 전달하며 결과를 요청 순서대로 표시한다. 일부 문항 오류, 중단, 잘린 응답을 구분하고 도착한 결과는 유지한다. 스트림은 전역 로딩에서 제외하여 결과 조회와 취소가 가능하다.
  • N/%/함께 보기는 서버가 반환한 값으로 셀과 Total에 함께 적용하며 재요청하지 않는다. 병합 셀·통계·주관식 단어 결과를 표시한다. 쿼터 및 Excel 출력은 이번 단계에 포함하지 않는다.
  • 타입 검사·17개 테스트·운영 빌드와 격리 HTTP 통합 검증을 수행한다. 통합 검증은 최초 결과 즉시 전달, 문항 오류 후 계속 처리, 주관식·병합 메타데이터 및 취소의 업스트림 전달을 확인한다. 브라우저 클릭·시각 검수와 실데이터 비교는 별도이며 공유 DB는 호출하지 않는다.
Description
No description provided
Readme 5.4 MiB
Languages
TypeScript 86.7%
CSS 13.2%