@readerseye2/cr_type 1.0.135 → 1.0.137

package/dist/book/child-reading-progress.type.d.ts

@@ -1,3 +1,4 @@
+import type { EyeTrackerType } from '../gaze/eye-tracker.types';
 /** 읽은 구간 (globalIndex 범위, inclusive) */
 export interface ReadRange {
     from: number;
@@ -8,6 +9,8 @@ export type CalibrationType = "quick" | "full";
 /** 섹션 읽기 중 발생한 캘리브레이션 기간 */
 export interface CalibrationPeriod {
     type: CalibrationType;
+    /** 사용한 시선추적 트래커 */
+    trackerType: EyeTrackerType;
     /** 사용한 포인트 수 (quick: 3, full: 5) */
     points: number;
     startedAt: string;
@@ -15,6 +18,14 @@ export interface CalibrationPeriod {
     durationMs: number;
     /** 캘리브레이션 결과 품질 (0~1, 기기 제공) */
     quality?: number;
+    /** 화면 가로 해상도 (px) */
+    screenWidth?: number;
+    /** 화면 세로 해상도 (px) */
+    screenHeight?: number;
+    /** 평균 오차 (px) */
+    accuracyPx?: number;
+    /** 평균 오차 (degree) */
+    accuracyDeg?: number;
 }
 /** 퀴즈 시도 결과 (개별 퀴즈, 서버 저장용) */
 export interface QuizAttemptResult {
@@ -78,9 +89,9 @@ export interface ReadingProgressReport {
     /** 섹션 전체 GI 수 (ViewerSnapshot.totalItems) */
     sectionGIMax: number;
     /** 이 구간에서 뷰포트에 표시된 GI 범위의 최소값 */
-    scrolledFrom: number;
+    exposedFrom: number;
     /** 이 구간에서 뷰포트에 표시된 GI 범위의 최대값 */
-    scrolledTo: number;
+    exposedTo: number;
     /**
      * GI별 시선 dwell time (ms)
      * - 키: globalIndex (string), 값: 해당 5초 윈도우 내 누적 dwell ms
@@ -120,24 +131,24 @@ export interface ChildSectionProgress {
     sectionGIMax: number;
     /** 섹션 단어 수 (SectionSummary.word_count, WPM 계산용) */
     sectionWordCount: number;
-    scrolledRanges: ReadRange[];
+    exposedRanges: ReadRange[];
     /** unique GI 수 (mergeReadRanges 후) */
-    scrolledCount: number;
-    /** scrolledCount / sectionGIMax */
-    scrolledCoverage: number;
-    gazeReadRanges: ReadRange[];
-    gazeReadCount: number;
-    gazeReadCoverage: number;
-    /** 모든 flush의 (scrolledTo - scrolledFrom + 1) 합산 */
-    totalRawScrolledGIs: number;
+    exposedCount: number;
+    /** exposedCount / sectionGIMax */
+    exposedCoverage: number;
+    eyeReadRanges: ReadRange[];
+    eyeReadCount: number;
+    eyeReadCoverage: number;
+    /** 모든 flush의 (exposedTo - exposedFrom + 1) 합산 */
+    totalRawExposedGIs: number;
     /** 모든 flush의 gaze dwell ≥ threshold GI 수 합산 */
-    totalRawGazeReadGIs: number;
+    totalRawEyeReadGIs: number;
     totalReadMs: number;
     lastGlobalIndex: number;
     lastReadAt: string;
-    /** 검증된 읽기속도: gazeReadCount / (totalReadMs / 60000) — WPM 근사 (GI ≈ word) */
+    /** 검증된 읽기속도: eyeReadCount / (totalReadMs / 60000) — WPM 근사 (GI ≈ word) */
     readingSpeedWPM: number | null;
-    /** 미검증 읽기속도: scrolledCount / (totalReadMs / 60000) */
+    /** 미검증 읽기속도: exposedCount / (totalReadMs / 60000) */
     unverifiedReadingSpeedWPM: number | null;
     /** 누적: 시선이 텍스트 위에 있었던 시간 (ms) */
     totalGazeOnTextMs: number;
@@ -172,10 +183,10 @@ export interface ChildBookBookmark {
     lastReadSectionId: string;
     lastGlobalIndex: number;
     totalGIMax: number;
-    totalScrolledCount: number;
-    totalScrolledCoverage: number;
-    totalGazeReadCount: number;
-    totalGazeReadCoverage: number;
+    totalExposedCount: number;
+    totalExposedCoverage: number;
+    totalEyeReadCount: number;
+    totalEyeReadCoverage: number;
     totalReadingScore: number;
     /** 책 전체 평균 WPM (검증된 속도) */
     avgReadingSpeedWPM: number | null;
@@ -190,8 +201,8 @@ export interface ChildReadingLog {
     childIdx: number;
     bookIdx: number;
     sectionId: string;
-    scrolledFrom: number;
-    scrolledTo: number;
+    exposedFrom: number;
+    exposedTo: number;
     /** 전체 dwell map 그대로 보존 */
     gazeDwellMap: Record<string, number>;
     blinkCount: number;
@@ -209,17 +220,27 @@ export interface ChildReadingLog {
 }
 export interface ChildCalibrationLog {
     childIdx: number;
-    /** 읽기 세션 중 발생 시 세션 ID */
-    sessionId?: string;
+    /** 읽기 세션 중 발생 시 읽기 세션 ID */
+    readingSessionId?: string;
     /** 읽기 중이었던 섹션 */
     sectionId?: string;
     type: CalibrationType;
+    /** 사용한 시선추적 트래커 */
+    trackerType: EyeTrackerType;
     /** 사용한 포인트 수 */
     points: number;
     startedAt: string;
     endedAt: string;
     durationMs: number;
     quality?: number;
+    /** 화면 가로 해상도 (px) */
+    screenWidth?: number;
+    /** 화면 세로 해상도 (px) */
+    screenHeight?: number;
+    /** 평균 오차 (px) */
+    accuracyPx?: number;
+    /** 평균 오차 (degree) */
+    accuracyDeg?: number;
     createdAt: string;
 }
 export interface SegmentReadingSummary {
@@ -230,17 +251,17 @@ export interface SegmentReadingSummary {
     startedAt: string;
     endedAt: string;
     durationMs: number;
-    scrolledFrom: number;
-    scrolledTo: number;
-    scrolledGICount: number;
-    gazeReadGICount: number;
-    rawScrolledGICount: number;
-    rawGazeReadGICount: number;
-    /** gazeReadGICount / (durationMs / 60000) — WPM 근사 */
+    exposedFrom: number;
+    exposedTo: number;
+    exposedGICount: number;
+    eyeReadGICount: number;
+    rawExposedGICount: number;
+    rawEyeReadGICount: number;
+    /** eyeReadGICount / (durationMs / 60000) — WPM 근사 */
     readingSpeedWPM: number | null;
-    /** scrolledGICount / (durationMs / 60000) */
+    /** exposedGICount / (durationMs / 60000) */
     unverifiedReadingSpeedWPM: number;
-    /** gazeReadGICount / scrolledGICount (시선 없으면 null) */
+    /** eyeReadGICount / exposedGICount (시선 없으면 null) */
     focusRatio: number | null;
     /** 평균 dwell time (ms per GI) */
     avgDwellMs: number | null;
@@ -259,13 +280,13 @@ export interface SegmentReadingSummary {
 }
 export interface ChildReadingSessionSummary {
     childIdx: number;
-    sessionId: string;
+    readingSessionId: string;
     startedAt: string;
     endedAt: string;
     totalDurationMs: number;
     segments: SegmentReadingSummary[];
-    totalScrolledGICount: number;
-    totalGazeReadGICount: number;
+    totalExposedGICount: number;
+    totalEyeReadGICount: number;
     overallFocusRatio: number | null;
     avgReadingSpeedWPM: number | null;
     avgUnverifiedReadingSpeedWPM: number;
@@ -287,9 +308,9 @@ export interface ChildReadingSessionSummary {
  */
 export interface ReadingScoreInput {
     /** 진도 (중첩비허용 coverage, 0~1) */
-    scrolledCoverage: number;
-    /** 검증된 진도 (gazeRead coverage, 0~1) */
-    gazeReadCoverage: number;
+    exposedCoverage: number;
+    /** 검증된 진도 (eyeRead coverage, 0~1) */
+    eyeReadCoverage: number;
     /** 집중도 (%, 0~100) */
     concentrationPercent: number | null;
     /** 시선일치도 (0~1) */
@@ -312,9 +333,9 @@ export interface ReadingAccumulatedState {
     sectionId: string;
     sectionGIMax: number;
     sectionWordCount: number;
-    scrolledRanges: ReadRange[];
-    scrolledCoverage: number;
-    totalRawScrolledGIs: number;
+    exposedRanges: ReadRange[];
+    exposedCoverage: number;
+    totalRawExposedGIs: number;
     totalReadMs: number;
     lastGlobalIndex: number;
     totalGazeOnTextMs: number;
@@ -329,6 +350,41 @@ export interface ReadingAccumulatedState {
     quizMaxScore: number;
     estimatedReadingScore: number;
 }
+export interface ChildDailySummary {
+    childIdx: number;
+    /** KST 기준 날짜 "YYYY-MM-DD" */
+    date: string;
+    totalReadMs: number;
+    sessionCount: number;
+    /** 오늘 읽은 bookIdx 목록 (unique) */
+    booksRead: number[];
+    /** 오늘 노출 GI 합 (세션별 누적) */
+    totalExposedGICount: number;
+    /** 오늘 시선 확인 GI 합 (세션별 누적) */
+    totalEyeReadGICount: number;
+    avgConcentrationPercent: number | null;
+    avgFocusRatio: number | null;
+    avgReadingSpeedWPM: number | null;
+    totalQuizScore: number;
+    totalQuizMaxScore: number;
+    totalBlinks: number;
+    totalLookedUpWords: number;
+    /** 집중도 가중합 (concentrationPercent × durationMs 누적) */
+    _weightedConcentrationMs: number;
+    /** 집중도 분모 (concentration 데이터가 있는 세션의 durationMs 누적) */
+    _concentrationDurationMs: number;
+    /** 속도 가중합 (speedWPM × durationMs 누적) */
+    _weightedSpeedMs: number;
+    /** 속도 분모 (speed 데이터가 있는 세션의 durationMs 누적) */
+    _speedDurationMs: number;
+    /** focusRatio 가중합 */
+    _weightedFocusRatioMs: number;
+    /** focusRatio 분모 */
+    _focusRatioDurationMs: number;
+    lastReadingSessionId: string;
+    createdAt: string;
+    updatedAt: string;
+}
 /** GET /api/reading-progress/:bookIdx */
 export interface ChildBookProgressResponse {
     bookmark: ChildBookBookmark | null;

package/dist/book/child-reading-progress.type.js

@@ -8,5 +8,5 @@
 //   시선일치도(gazeAlignment, 오디오재생+시선추적시)
 //   집중도(concentration, gazeOnText/total %)
 //   찾아본단어(lookedUpWords) 퀴즈점수/정답률
-//   미검증 읽은양/속도(scrollOnly) 종합 읽기점수(readingScore, 누적)
+//   미검증 읽은양/속도(exposedOnly) 종합 읽기점수(readingScore, 누적)
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/socket/reading-section.types.d.ts

@@ -54,5 +54,5 @@ export interface SessionEventPayload {
 }
 /** 세션 구독 페이로드 */
 export interface SessionSubscribePayload {
-    sessionId: string;
+    readingSessionId: string;
 }

package/dist/socket/socket-serverToClientEvents.type.d.ts

@@ -21,34 +21,34 @@ export interface ServerToClientEvents {
     }) => void;
     /** 세션 종료됨 (서버 확인) */
     'session:ended': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         durationMs?: number;
     }) => void;
     /** 구독 성공 (Parent가 자녀 세션 구독 시) */
     'session:subscribed': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         snapshot: ViewerSnapshot | null;
     }) => void;
     /** 구독 중인 세션의 진행 상황 */
     'session:progress': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         snapshot: ViewerSnapshot;
     }) => void;
     /** 구독 중인 세션의 이벤트 */
     'session:events': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         events: ViewerEvent[];
     }) => void;
     /** 구독 중인 세션의 실시간 시선 데이터 (~1초 간격) */
     'session:gaze': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         gazeData: GazeDataPayload;
     }) => void;
     /** 구독 중인 세션의 세그먼트 변경 (섹션 변경) */
     'session:segment-changed': (payload: SessionSegmentChangedPayload) => void;
     /** 구독 중인 세션의 청크 (10초 간격) */
     'session:chunk': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         segmentIndex: number;
         chunk: UnifiedChunkFile;
     }) => void;
@@ -72,34 +72,34 @@ export interface SessionServerToClientEvents {
     }) => void;
     /** 세션 종료됨 */
     'session:ended': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         durationMs?: number;
     }) => void;
     /** 구독 성공 */
     'session:subscribed': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         snapshot: ViewerSnapshot | null;
     }) => void;
     /** 구독 중인 세션 진행 상황 */
     'session:progress': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         snapshot: ViewerSnapshot;
     }) => void;
     /** 구독 중인 세션 이벤트 */
     'session:events': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         events: ViewerEvent[];
     }) => void;
     /** 구독 중인 세션 실시간 시선 데이터 (~1초 간격) */
     'session:gaze': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         gazeData: GazeDataPayload;
     }) => void;
     /** 세그먼트 변경 (섹션 변경) */
     'session:segment-changed': (payload: SessionSegmentChangedPayload) => void;
     /** 실시간 청크 (10초 간격, 구독자에게) */
     'session:chunk': (payload: {
-        sessionId: string;
+        readingSessionId: string;
         segmentIndex: number;
         chunk: UnifiedChunkFile;
     }) => void;

package/dist/socket/unified-session.types.d.ts

@@ -96,15 +96,14 @@ export interface UnifiedSegmentSummary {
  * - 기존 ReadingSessionRecord + RecordingManifest 대체
  */
 export interface UnifiedSessionManifest {
-    /** 세션 ID (UUID) */
-    sessionId: string;
+    /** 읽기 세션 ID (UUID) */
+    readingSessionId: string;
     /** 상태 */
     status: UnifiedSessionStatus;
     /** 스키마 버전 (구 포맷과 구분용, 항상 2) */
     version: 2;
-    userId: number;
-    userType: 'parent' | 'child';
-    userName: string;
+    childIdx: number;
+    childName: string;
     familyId: number;
     /** 세션 시작 시간 (뷰어 열림, ms) */
     startedAt: number;
@@ -162,10 +161,9 @@ export interface GazeDataPayload {
  * - 현재 세그먼트 정보 포함
  */
 export interface UnifiedSessionInfo {
-    sessionId: string;
-    userId: number;
-    userType: 'parent' | 'child';
-    userName?: string;
+    readingSessionId: string;
+    childIdx: number;
+    childName?: string;
     familyId: number;
     startedAt: string;
     snapshot: ViewerSnapshot;
@@ -184,7 +182,7 @@ export interface UnifiedSessionInfo {
 }
 /** 세그먼트 변경 알림 (섹션 변경 시) */
 export interface SessionSegmentChangedPayload {
-    sessionId: string;
+    readingSessionId: string;
     /** 종료된 세그먼트 인덱스 */
     oldSegmentIndex: number;
     /** 새로 시작된 세그먼트 */
@@ -200,24 +198,24 @@ export interface SessionSegmentChangedPayload {
 /** 세션 이력 목록 조회 요청 */
 export interface SessionHistoryListPayload {
     familyId?: number;
-    userId?: number;
+    childIdx?: number;
     date?: string;
     limit?: number;
     offset?: number;
 }
 /** 세션 이력 상세 조회 요청 */
 export interface SessionHistoryGetPayload {
-    sessionId: string;
+    readingSessionId: string;
     s3Key?: string;
 }
 /** 세션 이력 삭제 요청 */
 export interface SessionHistoryDeletePayload {
-    sessionId: string;
+    readingSessionId: string;
     s3Key?: string;
 }
 /** 통합 청크 조회 요청 (seek/재생용) */
 export interface UnifiedChunksGetPayload {
-    sessionId: string;
+    readingSessionId: string;
     segmentIndex: number;
     /** 시작 timestamp (이 시점부터 청크 조회) */
     fromTimestamp?: number;
@@ -226,7 +224,7 @@ export interface UnifiedChunksGetPayload {
 }
 /** 통합 세그먼트 상세 조회 요청 */
 export interface UnifiedSegmentGetPayload {
-    sessionId: string;
+    readingSessionId: string;
     segmentIndex: number;
 }
 /** 세션 이력 목록 결과 */
@@ -245,7 +243,7 @@ export interface SessionHistoryGetResult {
 }
 /** 청크 조회 결과 */
 export interface UnifiedChunksResult {
-    sessionId: string;
+    readingSessionId: string;
     segmentIndex: number;
     chunks: UnifiedChunkFile[];
     /** Seek 시 가장 가까운 스냅샷 (초기 상태 복원용) */
@@ -253,12 +251,12 @@ export interface UnifiedChunksResult {
 }
 /** 세그먼트 상세 결과 */
 export interface UnifiedSegmentResult {
-    sessionId: string;
+    readingSessionId: string;
     segment: UnifiedSegmentMeta;
 }
 /** 세션 삭제 결과 */
 export interface SessionHistoryDeleteResult {
-    sessionId: string;
+    readingSessionId: string;
     success: boolean;
 }
 /**
@@ -266,11 +264,10 @@ export interface SessionHistoryDeleteResult {
  * - 기존 ActiveRecording + SessionChunkState 대체
  */
 export interface ActiveUnifiedSession {
-    sessionId: string;
+    readingSessionId: string;
     s3Prefix: string;
-    userId: number;
-    userType: 'parent' | 'child';
-    userName: string;
+    childIdx: number;
+    childName: string;
     familyId: number;
     viewerSocketId: string;
     startedAt: number;

package/dist/socket/unified-session.types.js

@@ -11,7 +11,7 @@
 // - Parent + Admin 동일한 subscribe 체계
 //
 // S3 경로:
-// reading-sessions/{familyId}/{userId}/{YYYY-MM-DD}/{sessionId}/
+// reading-sessions/{familyId}/{childIdx}/{YYYY-MM-DD}/{readingSessionId}/
 //   ├── manifest.json                    (UnifiedSessionManifest)
 //   └── segments/
 //       ├── 0/

package/dist/socket/viewer-events.types.d.ts

@@ -130,9 +130,14 @@ export type CalibrationStartEvent = ViewerEventBase<'calibration_start', {
 }>;
 export type CalibrationEndEvent = ViewerEventBase<'calibration_end', {
     type: 'quick' | 'full';
+    trackerType: import('../gaze/eye-tracker.types').EyeTrackerType;
     points: number;
     durationMs: number;
     quality?: number;
+    screenWidth?: number;
+    screenHeight?: number;
+    accuracyPx?: number;
+    accuracyDeg?: number;
 }>;
 export type ShowGazeChangeEvent = ViewerEventBase<'show_gaze_change', {
     showGaze: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@readerseye2/cr_type",
-  "version": "1.0.135",
+  "version": "1.0.137",
   "description": "CheckReading shared TypeScript types",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",