inc4
테이블 (102)
Excel 이슈–Geek+ 티켓 연결 (DOC_F01__opsIssueTickets)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- Excel 이슈 행 참조 (issueRefId) — uuid — 외래 키 → Teams 이슈 Excel 행 참조.고유번호 — NOT NULL
- 티켓 참조 (ticketId) — uuid — 외래 키 → Geek+ 외부 티켓 참조.고유번호 — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 티켓 관계 종류 (relationKind) — text — NOT NULL — support|order|statusReference|handoff|other. 단순 문자열 언급은 이 junction에 넣지 않음
- 관계 확인 상태 (confirmationState) — text — NOT NULL — verified|manualConfirmed. canonical 관계는 명시 증거가 있어야 하며 상태 관찰만으로 생성하지 않음
- 관계 확인 시각 (confirmedAt) — instant
Excel 이슈–Geek+ 티켓 연결 (opsIssueTickets)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- Excel 이슈 행 참조 (issueRefId) — uuid — 외래 키 → Teams 이슈 Excel 행 참조.고유번호 — NOT NULL
- 티켓 참조 (ticketId) — uuid — 외래 키 → Geek+ 외부 티켓 참조.고유번호 — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 티켓 관계 종류 (relationKind) — text — NOT NULL — support|order|statusReference|handoff|other. 단순 문자열 언급은 이 junction에 넣지 않음
- 관계 확인 상태 (confirmationState) — text — NOT NULL — verified|manualConfirmed. canonical 관계는 명시 증거가 있어야 하며 상태 관찰만으로 생성하지 않음
- 관계 확인 시각 (confirmedAt) — instant
Excel 이슈번호 범위 (DOC_F08__opsWorkbookNumberScopes)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 대상 Teams 통합문서 (bindingId) — uuid — 외래 키 → Teams Excel 통합문서 연결.고유번호 — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 외부 row/body 원문이 아니라 식별자·revision·확인시각만 기록
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 번호 범위 종류 (scopeKind) — text — NOT NULL — issueList|maintenanceExport|manual
- 업무 범위 코드 (scopeCode) — text — NOT NULL — 예: INC4-4F-ACR
- 업무 날짜 시간대 (timeZone) — text — NOT NULL
- 표시 번호 규칙 (numberPattern) — text — NOT NULL — 예: MM-DD_N
- 범위 상태 (state) — text — NOT NULL — active|paused|retired
- 마지막 배정 업무일 (lastAllocatedBusinessDate) — text — ISO date YYYY-MM-DD. 표시 번호의 MM-DD와 별개로 검증
- 마지막 배정 순번 (lastAllocatedSequence) — integer
Excel 이슈번호 범위 (opsWorkbookNumberScopes)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 대상 Teams 통합문서 (bindingId) — uuid — 외래 키 → Teams Excel 통합문서 연결.고유번호 — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 외부 row/body 원문이 아니라 식별자·revision·확인시각만 기록
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 번호 범위 종류 (scopeKind) — text — NOT NULL — issueList|maintenanceExport|manual
- 업무 범위 코드 (scopeCode) — text — NOT NULL — 예: INC4-4F-ACR
- 업무 날짜 시간대 (timeZone) — text — NOT NULL
- 표시 번호 규칙 (numberPattern) — text — NOT NULL — 예: MM-DD_N
- 범위 상태 (state) — text — NOT NULL — active|paused|retired
- 마지막 배정 업무일 (lastAllocatedBusinessDate) — text — ISO date YYYY-MM-DD. 표시 번호의 MM-DD와 별개로 검증
- 마지막 배정 순번 (lastAllocatedSequence) — integer
Geek+ 외부 티켓 참조 (DOC_F05__opsTickets)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 티켓 공급사 (provider) — text — NOT NULL
- 실제 티켓번호 (externalNo) — text — NOT NULL
- 포털 내부 ID (externalId) — text
- 티켓 주소 (url) — text
- 마지막 확인 상태 스냅샷 (rawStatus) — text — NOT NULL
- 상태 확인 시각 (statusObservedAt) — instant — NOT NULL
- 확인 방법 (confirmationType) — text — NOT NULL
- 마지막 확인 완료 시각 (completionAt) — instant
Geek+ 외부 티켓 참조 (opsTickets)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 티켓 공급사 (provider) — text — NOT NULL
- 실제 티켓번호 (externalNo) — text — NOT NULL
- 포털 내부 ID (externalId) — text
- 티켓 주소 (url) — text
- 마지막 확인 상태 스냅샷 (rawStatus) — text — NOT NULL
- 상태 확인 시각 (statusObservedAt) — instant — NOT NULL
- 확인 방법 (confirmationType) — text — NOT NULL
- 마지막 확인 완료 시각 (completionAt) — instant
Geek+ 외부 티켓 참조 (DOC_F06__opsTickets)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 티켓 공급사 (provider) — text — NOT NULL
- 실제 티켓번호 (externalNo) — text — NOT NULL
- 포털 내부 ID (externalId) — text
- 티켓 주소 (url) — text
- 마지막 확인 상태 스냅샷 (rawStatus) — text — NOT NULL
- 상태 확인 시각 (statusObservedAt) — instant — NOT NULL
- 확인 방법 (confirmationType) — text — NOT NULL
- 마지막 확인 완료 시각 (completionAt) — instant
Geek+ 외부 티켓 참조 (DOC_F01__opsTickets)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 티켓 공급사 (provider) — text — NOT NULL
- 실제 티켓번호 (externalNo) — text — NOT NULL
- 포털 내부 ID (externalId) — text
- 티켓 주소 (url) — text
- 마지막 확인 상태 스냅샷 (rawStatus) — text — NOT NULL
- 상태 확인 시각 (statusObservedAt) — instant — NOT NULL
- 확인 방법 (confirmationType) — text — NOT NULL
- 마지막 확인 완료 시각 (completionAt) — instant
PC 내부 파일 목록 (localFileManifest)
- 로컬 항목 ID (id) — uuid — 기본 키 — NOT NULL
- 작업실 참조 (workspaceId) — uuid — NOT NULL — 논리 참조; 공유 DB FK 아님
- 공유 파일 메타 ID (serverFileId) — uuid — opsFiles.id 논리 참조
- 현재 PC 식별자 (deviceKey) — text — NOT NULL
- Chrome 다운로드 ID (downloadId) — text
- PC 내 경로 힌트 (localPathHint) — text
- 파일 선택 시각 (selectedAt) — instant
- 로컬 존재 확인 상태 (localStatus) — text — NOT NULL
- 확인 시각 (checkedAt) — instant
Teams Excel 통합문서 연결 (DOC_F07__opsTeamsWorkbookBindings)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 외부 row/body 원문이 아니라 식별자·revision·확인시각만 기록
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- Microsoft tenant 식별자 (tenantId) — text — NOT NULL
- SharePoint/Teams drive ID (driveId) — text — NOT NULL
- Excel file item ID (itemId) — text — NOT NULL
- 전역 순차 처리 키 (workbookLockKey) — text — NOT NULL — tenantId:driveId:itemId. 같은 파일은 작업실이 달라도 하나의 writer lane으로 처리
- 사용자 표시 이름 (displayName) — text — NOT NULL
- Teams/SharePoint 파일 URL (webUrl) — text
- 연결 상태 (state) — text — NOT NULL — draft|active|paused|reconcileRequired|retired
- 현재 writer lane 소유자 (leaseOwner) — text
- 현재 writer lane fencing token (leaseToken) — text
- writer lane lease 만료 (leaseExpiresAt) — instant
- 승인된 시트/표/범위 (approvedTargets) — json — NOT NULL — Issue List, 번역 탭, Ticket Management 등 허용 target만 기록
- 단일 소유 작업실 정책 (ownerPolicy) — json — NOT NULL — 같은 workbook은 원칙적으로 한 workspace만 소유. 예외는 global lock으로 직렬화
- 마지막 파일 ETag (lastKnownETag) — text
- 마지막 workbook version (lastKnownWorkbookVersion) — text
- 마지막 read-back 시각 (lastReadAt) — instant
Teams Excel 통합문서 연결 (opsTeamsWorkbookBindings)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 외부 row/body 원문이 아니라 식별자·revision·확인시각만 기록
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- Microsoft tenant 식별자 (tenantId) — text — NOT NULL
- SharePoint/Teams drive ID (driveId) — text — NOT NULL
- Excel file item ID (itemId) — text — NOT NULL
- 전역 순차 처리 키 (workbookLockKey) — text — NOT NULL — tenantId:driveId:itemId. 같은 파일은 작업실이 달라도 하나의 writer lane으로 처리
- 사용자 표시 이름 (displayName) — text — NOT NULL
- Teams/SharePoint 파일 URL (webUrl) — text
- 연결 상태 (state) — text — NOT NULL — draft|active|paused|reconcileRequired|retired
- 현재 writer lane 소유자 (leaseOwner) — text
- 현재 writer lane fencing token (leaseToken) — text
- writer lane lease 만료 (leaseExpiresAt) — instant
- 승인된 시트/표/범위 (approvedTargets) — json — NOT NULL — Issue List, 번역 탭, Ticket Management 등 허용 target만 기록
- 단일 소유 작업실 정책 (ownerPolicy) — json — NOT NULL — 같은 workbook은 원칙적으로 한 workspace만 소유. 예외는 global lock으로 직렬화
- 마지막 파일 ETag (lastKnownETag) — text
- 마지막 workbook version (lastKnownWorkbookVersion) — text
- 마지막 read-back 시각 (lastReadAt) — instant
Teams Excel 통합문서 연결 (DOC_F08__opsTeamsWorkbookBindings)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 외부 row/body 원문이 아니라 식별자·revision·확인시각만 기록
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- Microsoft tenant 식별자 (tenantId) — text — NOT NULL
- SharePoint/Teams drive ID (driveId) — text — NOT NULL
- Excel file item ID (itemId) — text — NOT NULL
- 전역 순차 처리 키 (workbookLockKey) — text — NOT NULL — tenantId:driveId:itemId. 같은 파일은 작업실이 달라도 하나의 writer lane으로 처리
- 사용자 표시 이름 (displayName) — text — NOT NULL
- Teams/SharePoint 파일 URL (webUrl) — text
- 연결 상태 (state) — text — NOT NULL — draft|active|paused|reconcileRequired|retired
- 현재 writer lane 소유자 (leaseOwner) — text
- 현재 writer lane fencing token (leaseToken) — text
- writer lane lease 만료 (leaseExpiresAt) — instant
- 승인된 시트/표/범위 (approvedTargets) — json — NOT NULL — Issue List, 번역 탭, Ticket Management 등 허용 target만 기록
- 단일 소유 작업실 정책 (ownerPolicy) — json — NOT NULL — 같은 workbook은 원칙적으로 한 workspace만 소유. 예외는 global lock으로 직렬화
- 마지막 파일 ETag (lastKnownETag) — text
- 마지막 workbook version (lastKnownWorkbookVersion) — text
- 마지막 read-back 시각 (lastReadAt) — instant
Teams 이슈 Excel 행 참조 (DOC_F01__opsIssueRefs)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- Excel 행의 자산 연결 (assetId) — uuid — 외래 키 → 자산 마스터.고유번호
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 승인된 통합문서 프로필 (workbookProfile) — text — NOT NULL
- Teams 문서 식별자 (documentId) — text — NOT NULL
- 시트 이름 (sheetName) — text — NOT NULL
- 운영 연도 (operatingYear) — integer — NOT NULL
- Excel 이슈 번호 (issueNumber) — text — NOT NULL
- 현재 행 위치 (rowLocator) — integer — 조회 위치일 뿐 행 번호는 stable key가 아님
- 행 버전/hash (sourceRevision) — text
- 마지막 Excel 조회 시각 (lastReadAt) — instant
Teams 이슈 Excel 행 참조 (opsIssueRefs)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- Excel 행의 자산 연결 (assetId) — uuid — 외래 키 → 자산 마스터.고유번호
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 승인된 통합문서 프로필 (workbookProfile) — text — NOT NULL
- Teams 문서 식별자 (documentId) — text — NOT NULL
- 시트 이름 (sheetName) — text — NOT NULL
- 운영 연도 (operatingYear) — integer — NOT NULL
- Excel 이슈 번호 (issueNumber) — text — NOT NULL
- 현재 행 위치 (rowLocator) — integer — 조회 위치일 뿐 행 번호는 stable key가 아님
- 행 버전/hash (sourceRevision) — text
- 마지막 Excel 조회 시각 (lastReadAt) — instant
Teams 이슈 Excel 행 참조 (DOC_F07__opsIssueRefs)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- Excel 행의 자산 연결 (assetId) — uuid — 외래 키 → 자산 마스터.고유번호 — 외부 FK: opsAssets.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 승인된 통합문서 프로필 (workbookProfile) — text — NOT NULL
- Teams 문서 식별자 (documentId) — text — NOT NULL
- 시트 이름 (sheetName) — text — NOT NULL
- 운영 연도 (operatingYear) — integer — NOT NULL
- Excel 이슈 번호 (issueNumber) — text — NOT NULL
- 현재 행 위치 (rowLocator) — integer — 조회 위치일 뿐 행 번호는 stable key가 아님
- 행 버전/hash (sourceRevision) — text
- 마지막 Excel 조회 시각 (lastReadAt) — instant
Teams 이슈 Excel 행 참조 (DOC_F06__opsIssueRefs)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- Excel 행의 자산 연결 (assetId) — uuid — 외래 키 → 자산 마스터.고유번호
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 승인된 통합문서 프로필 (workbookProfile) — text — NOT NULL
- Teams 문서 식별자 (documentId) — text — NOT NULL
- 시트 이름 (sheetName) — text — NOT NULL
- 운영 연도 (operatingYear) — integer — NOT NULL
- Excel 이슈 번호 (issueNumber) — text — NOT NULL
- 현재 행 위치 (rowLocator) — integer — 조회 위치일 뿐 행 번호는 stable key가 아님
- 행 버전/hash (sourceRevision) — text
- 마지막 Excel 조회 시각 (lastReadAt) — instant
Teams 이슈 Excel 행 참조 (DOC_F08__opsIssueRefs)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- Excel 행의 자산 연결 (assetId) — uuid — 외래 키 → 자산 마스터.고유번호 — 외부 FK: opsAssets.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 승인된 통합문서 프로필 (workbookProfile) — text — NOT NULL
- Teams 문서 식별자 (documentId) — text — NOT NULL
- 시트 이름 (sheetName) — text — NOT NULL
- 운영 연도 (operatingYear) — integer — NOT NULL
- Excel 이슈 번호 (issueNumber) — text — NOT NULL
- 현재 행 위치 (rowLocator) — integer — 조회 위치일 뿐 행 번호는 stable key가 아님
- 행 버전/hash (sourceRevision) — text
- 마지막 Excel 조회 시각 (lastReadAt) — instant
Teams 이슈 Excel 행 참조 (DOC_F02__opsIssueRefs)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- Excel 행의 자산 연결 (assetId) — uuid — 외래 키 → 자산 마스터.고유번호
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 승인된 통합문서 프로필 (workbookProfile) — text — NOT NULL
- Teams 문서 식별자 (documentId) — text — NOT NULL
- 시트 이름 (sheetName) — text — NOT NULL
- 운영 연도 (operatingYear) — integer — NOT NULL
- Excel 이슈 번호 (issueNumber) — text — NOT NULL
- 현재 행 위치 (rowLocator) — integer — 조회 위치일 뿐 행 번호는 stable key가 아님
- 행 버전/hash (sourceRevision) — text
- 마지막 Excel 조회 시각 (lastReadAt) — instant
개별 부품 실물 (opsPartUnits)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 부품 품목 (partId) — uuid — 외래 키 → 부품 품목.고유번호 — NOT NULL
- 장착/위치 자산 (locationAssetId) — uuid — 외래 키 → 자산 마스터.고유번호 — location.assetId 정규화. robot/charger/facility 공통 자산 참조
- 최초 수령 항목 (originalReceiptRef) — uuid — 외래 키 → 입고 품목 line.입고 품목 line ID
- 원래 주문 항목 (originalProcurementRef) — uuid — 외래 키 → 신청 품목 line.신청 품목 line ID
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 실물 관리번호 (unitLabel) — text — NOT NULL
- 실제 폐기 시각 (disposedAt) — instant
- 제조사 일련번호 (serialNo) — text
- 품질 상태 (condition) — text — NOT NULL — unknown / underTest / verifiedGood / suspectedFault / confirmedFault / scrapped
- 현재 위치 종류 (locationKind) — text — NOT NULL — asset / bench / storage / externalCustody / unknown. legacy robot 값은 migration/import에서 asset으로 매핑하고 참조 자산의 assetKind=r…
- 장착 슬롯 (locationSlot) — text
- 위치 설명 (locationLabel) — text
개별 부품 실물 (DOC_F04__opsPartUnits)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 부품 품목 (partId) — uuid — 외래 키 → 부품 품목.고유번호 — NOT NULL
- 장착/위치 자산 (locationAssetId) — uuid — 외래 키 — location.assetId 정규화. robot/charger/facility 공통 자산 참조
- 최초 수령 항목 (originalReceiptRef) — uuid — 외래 키 → 입고 품목 line.입고 품목 line ID — 외부 FK: opsReceiptLines.id (이 섹션에서 생략)
- 원래 주문 항목 (originalProcurementRef) — uuid — 외래 키 → 신청 품목 line.신청 품목 line ID — 외부 FK: opsProcurementLines.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 실물 관리번호 (unitLabel) — text — NOT NULL
- 실제 폐기 시각 (disposedAt) — instant
- 제조사 일련번호 (serialNo) — text
- 품질 상태 (condition) — text — NOT NULL — unknown / underTest / verifiedGood / suspectedFault / confirmedFault / scrapped
- 현재 위치 종류 (locationKind) — text — NOT NULL — asset / bench / storage / externalCustody / unknown. legacy robot 값은 migration/import에서 asset으로 매핑하고 참조 자산의 assetKind=r…
- 장착 슬롯 (locationSlot) — text
- 위치 설명 (locationLabel) — text
개별 부품 실물 (DOC_F05__opsPartUnits)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 부품 품목 (partId) — uuid — 외래 키 → 부품 품목.고유번호 — NOT NULL
- 장착/위치 자산 (locationAssetId) — uuid — 외래 키 → 자산 마스터.고유번호 — location.assetId 정규화. robot/charger/facility 공통 자산 참조
- 최초 수령 항목 (originalReceiptRef) — uuid — 외래 키 → 입고 품목 line.입고 품목 line ID
- 원래 주문 항목 (originalProcurementRef) — uuid — 외래 키 → 신청 품목 line.신청 품목 line ID
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 실물 관리번호 (unitLabel) — text — NOT NULL
- 실제 폐기 시각 (disposedAt) — instant
- 제조사 일련번호 (serialNo) — text
- 품질 상태 (condition) — text — NOT NULL — unknown / underTest / verifiedGood / suspectedFault / confirmedFault / scrapped
- 현재 위치 종류 (locationKind) — text — NOT NULL — asset / bench / storage / externalCustody / unknown. legacy robot 값은 migration/import에서 asset으로 매핑하고 참조 자산의 assetKind=r…
- 장착 슬롯 (locationSlot) — text
- 위치 설명 (locationLabel) — text
개별 부품 실물 (DOC_F03__opsPartUnits)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 부품 품목 (partId) — uuid — 외래 키 → 부품 품목.고유번호 — NOT NULL
- 장착/위치 자산 (locationAssetId) — uuid — 외래 키 → 자산 마스터.고유번호 — location.assetId 정규화. robot/charger/facility 공통 자산 참조
- 최초 수령 항목 (originalReceiptRef) — uuid — 외래 키 → 입고 품목 line.입고 품목 line ID — 외부 FK: opsReceiptLines.id (이 섹션에서 생략)
- 원래 주문 항목 (originalProcurementRef) — uuid — 외래 키 → 신청 품목 line.신청 품목 line ID — 외부 FK: opsProcurementLines.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 실물 관리번호 (unitLabel) — text — NOT NULL
- 실제 폐기 시각 (disposedAt) — instant
- 제조사 일련번호 (serialNo) — text
- 품질 상태 (condition) — text — NOT NULL — unknown / underTest / verifiedGood / suspectedFault / confirmedFault / scrapped
- 현재 위치 종류 (locationKind) — text — NOT NULL — asset / bench / storage / externalCustody / unknown. legacy robot 값은 migration/import에서 asset으로 매핑하고 참조 자산의 assetKind=r…
- 장착 슬롯 (locationSlot) — text
- 위치 설명 (locationLabel) — text
공유 변경 감사 (opsEvents)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 처리 명령 요청 ID (commandId) — uuid — 외래 키 → 멱등 처리 명령.클라이언트 요청 ID — NOT NULL — (workspaceId,commandId) 고유키 참조; opsCommands.id와 혼동 금지
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 외부 노출 이벤트 식별 (eventId) — uuid — NOT NULL
- 변경 대상 참조 (aggregateRef) — json — NOT NULL
- 변경 전 버전 (revisionBefore) — integer — NOT NULL
- 변경 후 버전 (revisionAfter) — integer — NOT NULL
- 행동 (action) — text — NOT NULL
- 변경 사유 (reason) — text
- 감사 시각 (at) — instant — NOT NULL
- 바뀐 필드 (changedFields) — json — NOT NULL
공유 작성 초안 (DOC_F07__opsSharedDrafts)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 배정된 공식 이슈번호 (numberAllocationId) — uuid — 외래 키 → 이슈번호 예약·확정 이력.고유번호 — 외부 FK: opsNumberAllocations.id (이 섹션에서 생략)
- 확정된 Teams 이슈 행 (issueRefId) — uuid — 외래 키 → Teams 이슈 Excel 행 참조.고유번호
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 외부 row/body 원문이 아니라 식별자·revision·확인시각만 기록
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 작업 항목 종류 (workItemKind) — text — NOT NULL — MVP는 issue만 허용. maintenance/part 등 generic 확장은 금지
- 안정 작업 항목 ID (workItemId) — uuid — NOT NULL — destination별 draft hash가 아니라 하나의 issue work item 식별자
- 작업 항목 참조 hash (workItemRefHash) — text — NOT NULL — RMS/Teams/command 등 식별자 묶음의 hash. 본문 원문 아님
- 초안 종류 (draftKind) — text — NOT NULL — issueWorkingDraft. Teams/Geek+/카톡/RMS 출력은 이 하나의 issue draft에서 계산
- 초안 제목 (title) — text
- 임시 작성 본문 (draftBody) — json — retention/purge 후 NULL. 장기 원본 아님
- 본문 hash (bodyHash) — text — NOT NULL
- 본문 형식 (bodyFormat) — text — NOT NULL — plainText|markdown|formFields|sheetRow
- 초안 상태 (state) — text — NOT NULL — active|submitted|stale|purged|abandoned
- 원본 버전 묶음 (sourceVersionVector) — json — NOT NULL
- 출력 양식 버전 (templateVersion) — text — NOT NULL
- 보존 등급 (retentionClass) — text — NOT NULL — shortDraft|submittedPayload|metadataOnly
- 자동 purge 예정 (expiresAt) — instant — NOT NULL
- 본문 purge 시각 (purgedAt) — instant
공유 작성 초안 (opsSharedDrafts)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 배정된 공식 이슈번호 (numberAllocationId) — uuid — 외래 키 → 이슈번호 예약·확정 이력.고유번호
- 확정된 Teams 이슈 행 (issueRefId) — uuid — 외래 키 → Teams 이슈 Excel 행 참조.고유번호
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 외부 row/body 원문이 아니라 식별자·revision·확인시각만 기록
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 작업 항목 종류 (workItemKind) — text — NOT NULL — MVP는 issue만 허용. maintenance/part 등 generic 확장은 금지
- 안정 작업 항목 ID (workItemId) — uuid — NOT NULL — destination별 draft hash가 아니라 하나의 issue work item 식별자
- 작업 항목 참조 hash (workItemRefHash) — text — NOT NULL — RMS/Teams/command 등 식별자 묶음의 hash. 본문 원문 아님
- 초안 종류 (draftKind) — text — NOT NULL — issueWorkingDraft. Teams/Geek+/카톡/RMS 출력은 이 하나의 issue draft에서 계산
- 초안 제목 (title) — text
- 임시 작성 본문 (draftBody) — json — retention/purge 후 NULL. 장기 원본 아님
- 본문 hash (bodyHash) — text — NOT NULL
- 본문 형식 (bodyFormat) — text — NOT NULL — plainText|markdown|formFields|sheetRow
- 초안 상태 (state) — text — NOT NULL — active|submitted|stale|purged|abandoned
- 원본 버전 묶음 (sourceVersionVector) — json — NOT NULL
- 출력 양식 버전 (templateVersion) — text — NOT NULL
- 보존 등급 (retentionClass) — text — NOT NULL — shortDraft|submittedPayload|metadataOnly
- 자동 purge 예정 (expiresAt) — instant — NOT NULL
- 본문 purge 시각 (purgedAt) — instant
공유 작성 초안 (DOC_F08__opsSharedDrafts)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 배정된 공식 이슈번호 (numberAllocationId) — uuid — 외래 키 → 이슈번호 예약·확정 이력.고유번호
- 확정된 Teams 이슈 행 (issueRefId) — uuid — 외래 키 → Teams 이슈 Excel 행 참조.고유번호
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 외부 row/body 원문이 아니라 식별자·revision·확인시각만 기록
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 작업 항목 종류 (workItemKind) — text — NOT NULL — MVP는 issue만 허용. maintenance/part 등 generic 확장은 금지
- 안정 작업 항목 ID (workItemId) — uuid — NOT NULL — destination별 draft hash가 아니라 하나의 issue work item 식별자
- 작업 항목 참조 hash (workItemRefHash) — text — NOT NULL — RMS/Teams/command 등 식별자 묶음의 hash. 본문 원문 아님
- 초안 종류 (draftKind) — text — NOT NULL — issueWorkingDraft. Teams/Geek+/카톡/RMS 출력은 이 하나의 issue draft에서 계산
- 초안 제목 (title) — text
- 임시 작성 본문 (draftBody) — json — retention/purge 후 NULL. 장기 원본 아님
- 본문 hash (bodyHash) — text — NOT NULL
- 본문 형식 (bodyFormat) — text — NOT NULL — plainText|markdown|formFields|sheetRow
- 초안 상태 (state) — text — NOT NULL — active|submitted|stale|purged|abandoned
- 원본 버전 묶음 (sourceVersionVector) — json — NOT NULL
- 출력 양식 버전 (templateVersion) — text — NOT NULL
- 보존 등급 (retentionClass) — text — NOT NULL — shortDraft|submittedPayload|metadataOnly
- 자동 purge 예정 (expiresAt) — instant — NOT NULL
- 본문 purge 시각 (purgedAt) — instant
공유 작업실 (opsWorkspaces)
- 작업실 ID (id) — uuid — 기본 키 — NOT NULL
- 작업실 이름 (name) — text — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
기타 논리 연결 (opsLinks)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 연결 종류 (kind) — text — NOT NULL — ticketMention|swapText|externalRowCandidate|duplicateCandidate|other. 정규 junction의 대체 원본으로 사용 금지
- 출발 엔티티 ID (fromId) — uuid — NOT NULL — 다형 참조. 종류별 허용 대상 검증 필요; 물리 FK 아님
- 도착 엔티티 ID (toId) — uuid — NOT NULL — 다형 참조. 물리 FK 아님
- 활성 연결 (active) — boolean — NOT NULL
- 연결 사유 (reason) — text — NOT NULL
- 연결 시각 (linkedAt) — instant — NOT NULL
- 해제 시각 (unlinkedAt) — instant
멱등 처리 명령 (opsCommands)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 클라이언트 요청 ID (commandId) — uuid — NOT NULL
- 요청 내용 해시 (payloadHash) — text — NOT NULL
- 처리 상태 (state) — text — NOT NULL
- 처리 결과 참조 (resultRef) — json
- 시작 시각 (startedAt) — instant — NOT NULL
- 종료 시각 (finishedAt) — instant
- 요청 종류 (requestKind) — text — NOT NULL — issueNumber.allocate|handoff.submit|draft.save 등
- 업무 중복 방지 키 (businessKey) — text — commandId 재시도와 독립된 실제 업무 중복 후보 키
멱등 처리 명령 (DOC_F07__opsCommands)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 클라이언트 요청 ID (commandId) — uuid — NOT NULL
- 요청 내용 해시 (payloadHash) — text — NOT NULL
- 처리 상태 (state) — text — NOT NULL
- 처리 결과 참조 (resultRef) — json
- 시작 시각 (startedAt) — instant — NOT NULL
- 종료 시각 (finishedAt) — instant
- 요청 종류 (requestKind) — text — NOT NULL — issueNumber.allocate|handoff.submit|draft.save 등
- 업무 중복 방지 키 (businessKey) — text — commandId 재시도와 독립된 실제 업무 중복 후보 키
멱등 처리 명령 (DOC_F08__opsCommands)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 클라이언트 요청 ID (commandId) — uuid — NOT NULL
- 요청 내용 해시 (payloadHash) — text — NOT NULL
- 처리 상태 (state) — text — NOT NULL
- 처리 결과 참조 (resultRef) — json
- 시작 시각 (startedAt) — instant — NOT NULL
- 종료 시각 (finishedAt) — instant
- 요청 종류 (requestKind) — text — NOT NULL — issueNumber.allocate|handoff.submit|draft.save 등
- 업무 중복 방지 키 (businessKey) — text — commandId 재시도와 독립된 실제 업무 중복 후보 키
부품 사건–로컬 파일 메타 연결 (opsPartEventFiles)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 부품 사건 (eventId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호 — NOT NULL
- 파일 메타데이터 (fileId) — uuid — 외래 키 — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
부품 사건–티켓 연결 (opsPartEventTickets)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 부품 사건 (eventId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호 — NOT NULL
- 티켓 참조 (ticketId) — uuid — 외래 키 → Geek+ 외부 티켓 참조.고유번호 — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 티켓 관계 종류 (relationKind) — text — NOT NULL — support|order|statusReference|handoff|other. 단순 문자열 언급은 이 junction에 넣지 않음
- 관계 확인 상태 (confirmationState) — text — NOT NULL — verified|manualConfirmed. canonical 관계는 명시 증거가 있어야 하며 상태 관찰만으로 생성하지 않음
- 관계 확인 시각 (confirmedAt) — instant
부품 수요 충족 이력 (opsNeedFulfillments)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 충족된 수요 (needId) — uuid — 외래 키 — NOT NULL
- 사용한 배정 (reservationId) — uuid — 외래 키
- 실제 장착/전달 사건 (partEventId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호 — NOT NULL
- 실제 사용 실물 (unitId) — uuid — 외래 키 → 개별 부품 실물.고유번호 — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 원본 시스템의 식별자·revision·확인시각만 기록. 이슈/티켓 본문을 복제하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 충족 수량 (qty) — integer — NOT NULL — serialized unit 기반 MVP에서는 항상 1
- 충족 상태 (state) — text — NOT NULL — active|reversed
- 충족 확정 시각 (fulfilledAt) — instant — NOT NULL
- 취소/정정 사유 (reversalReason) — text
- 취소/정정 시각 (reversedAt) — instant
부품 수요 충족 이력 (DOC_F04__opsNeedFulfillments)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 충족된 수요 (needId) — uuid — 외래 키 — NOT NULL
- 사용한 배정 (reservationId) — uuid — 외래 키
- 실제 장착/전달 사건 (partEventId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호 — NOT NULL
- 실제 사용 실물 (unitId) — uuid — 외래 키 → 개별 부품 실물.고유번호 — NOT NULL
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 원본 시스템의 식별자·revision·확인시각만 기록. 이슈/티켓 본문을 복제하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 충족 수량 (qty) — integer — NOT NULL — serialized unit 기반 MVP에서는 항상 1
- 충족 상태 (state) — text — NOT NULL — active|reversed
- 충족 확정 시각 (fulfilledAt) — instant — NOT NULL
- 취소/정정 사유 (reversalReason) — text
- 취소/정정 시각 (reversedAt) — instant
부품 신청 묶음 (DOC_F05__opsProcurements)
- 내부 신청 묶음 ID (id) — uuid — 기본 키 — NOT NULL — 공유 서비스 내부 opaque ID
- 작업공간 ID (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 모든 고유키와 FK 검증은 같은 workspace 안에서 수행
- 신청 근거 Geek+ 티켓 (sourceTicketId) — uuid — 외래 키 → Geek+ 외부 티켓 참조.고유번호 — NOT NULL — procurement.record 필수 payload. 주문을 어느 티켓으로 넣었는지 보존하며 실제 사용 자산과 다를 수 있음
- 기록 actor (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 인증 사용자. payload actorId 신뢰 금지
- 외부 신청 문서/포털 참조 (externalRequestRefs) — json — NOT NULL — Geek+ 부품 신청번호, portal line key, WeChat/Excel 근거 등 배열. 목록 길이를 수량으로 해석 금지 필수 입력. 배열은 확인된 빈 목록 []과 미확인 null을 구분하며 null 불가.
- 신청 확인 수준 (sourceConfirmation) — text — NOT NULL — 예: unverified/userConfirmed/portalObserved/imported. 신청 사실 확인과 공급 예약 가능은 분리
- 입력 명령의 확인 방식 (confirmationType) — text — NOT NULL — docs/05 procurement.record payload의 confirmationType 보존. sourceConfirmation과 같은 값일 수 있으나 의미를 합치지 않음 필수 확인자/확인 방법.
- 신청 출처 구분 (sourceKind) — text — manualTicketOrder/portalObserved/externalImport/unknown 등 제안 enum. 예약 sourceKind(donorRobot 등)와 혼동 금지
- 외부 원문 상태 (statusRaw) — text — 포털/시트 원문 그대로. delivered/completed만으로 receipt 확정 금지
- 외부 상태 확인 시각 (statusObservedAt) — instant — 상태를 본 시각. 실제 입고일(receivedAt)과 다름
- 원본 신청 식별자 묶음 (sourceIdentity) — json — provider, externalNo, requestNo, workbookProfile, sheetName, rowNumber, rawLineKeys 등. 원본 중복 검토용이며 PK 아님
- 신청 메모 (notes) — text — 원문/작업자 설명. 수량·상태 검증 우회 금지
- 행 revision (revision) — integer — NOT NULL — expectedRevision 충돌 검사용 양의 정수
- 생성 시각 (createdAt) — instant — NOT NULL — 서버 기록 시각
- 수정 시각 (updatedAt) — instant — NOT NULL — 서버 최신 수정 시각
- 근거 참조 배열 (sourceRefs) — json — NOT NULL — commandId, 티켓, Excel 행, 포털 스냅샷, 사용자 확인 근거
- 스키마 버전 (schemaVersion) — integer — NOT NULL — 이 계약의 payload 버전
부품 신청 묶음 (DOC_F06__opsProcurements)
- 내부 신청 묶음 ID (id) — uuid — 기본 키 — NOT NULL — 공유 서비스 내부 opaque ID
- 작업공간 ID (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 모든 고유키와 FK 검증은 같은 workspace 안에서 수행
- 신청 근거 Geek+ 티켓 (sourceTicketId) — uuid — 외래 키 → Geek+ 외부 티켓 참조.고유번호 — NOT NULL — procurement.record 필수 payload. 주문을 어느 티켓으로 넣었는지 보존하며 실제 사용 자산과 다를 수 있음
- 기록 actor (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 인증 사용자. payload actorId 신뢰 금지
- 외부 신청 문서/포털 참조 (externalRequestRefs) — json — NOT NULL — Geek+ 부품 신청번호, portal line key, WeChat/Excel 근거 등 배열. 목록 길이를 수량으로 해석 금지 필수 입력. 배열은 확인된 빈 목록 []과 미확인 null을 구분하며 null 불가.
- 신청 확인 수준 (sourceConfirmation) — text — NOT NULL — 예: unverified/userConfirmed/portalObserved/imported. 신청 사실 확인과 공급 예약 가능은 분리
- 입력 명령의 확인 방식 (confirmationType) — text — NOT NULL — docs/05 procurement.record payload의 confirmationType 보존. sourceConfirmation과 같은 값일 수 있으나 의미를 합치지 않음 필수 확인자/확인 방법.
- 신청 출처 구분 (sourceKind) — text — manualTicketOrder/portalObserved/externalImport/unknown 등 제안 enum. 예약 sourceKind(donorRobot 등)와 혼동 금지
- 외부 원문 상태 (statusRaw) — text — 포털/시트 원문 그대로. delivered/completed만으로 receipt 확정 금지
- 외부 상태 확인 시각 (statusObservedAt) — instant — 상태를 본 시각. 실제 입고일(receivedAt)과 다름
- 원본 신청 식별자 묶음 (sourceIdentity) — json — provider, externalNo, requestNo, workbookProfile, sheetName, rowNumber, rawLineKeys 등. 원본 중복 검토용이며 PK 아님
- 신청 메모 (notes) — text — 원문/작업자 설명. 수량·상태 검증 우회 금지
- 행 revision (revision) — integer — NOT NULL — expectedRevision 충돌 검사용 양의 정수
- 생성 시각 (createdAt) — instant — NOT NULL — 서버 기록 시각
- 수정 시각 (updatedAt) — instant — NOT NULL — 서버 최신 수정 시각
- 근거 참조 배열 (sourceRefs) — json — NOT NULL — commandId, 티켓, Excel 행, 포털 스냅샷, 사용자 확인 근거
- 스키마 버전 (schemaVersion) — integer — NOT NULL — 이 계약의 payload 버전
부품 신청 묶음 (opsProcurements)
- 내부 신청 묶음 ID (id) — uuid — 기본 키 — NOT NULL — 공유 서비스 내부 opaque ID
- 작업공간 ID (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 모든 고유키와 FK 검증은 같은 workspace 안에서 수행
- 신청 근거 Geek+ 티켓 (sourceTicketId) — uuid — 외래 키 → Geek+ 외부 티켓 참조.고유번호 — NOT NULL — procurement.record 필수 payload. 주문을 어느 티켓으로 넣었는지 보존하며 실제 사용 자산과 다를 수 있음
- 기록 actor (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 인증 사용자. payload actorId 신뢰 금지
- 외부 신청 문서/포털 참조 (externalRequestRefs) — json — NOT NULL — Geek+ 부품 신청번호, portal line key, WeChat/Excel 근거 등 배열. 목록 길이를 수량으로 해석 금지 필수 입력. 배열은 확인된 빈 목록 []과 미확인 null을 구분하며 null 불가.
- 신청 확인 수준 (sourceConfirmation) — text — NOT NULL — 예: unverified/userConfirmed/portalObserved/imported. 신청 사실 확인과 공급 예약 가능은 분리
- 입력 명령의 확인 방식 (confirmationType) — text — NOT NULL — docs/05 procurement.record payload의 confirmationType 보존. sourceConfirmation과 같은 값일 수 있으나 의미를 합치지 않음 필수 확인자/확인 방법.
- 신청 출처 구분 (sourceKind) — text — manualTicketOrder/portalObserved/externalImport/unknown 등 제안 enum. 예약 sourceKind(donorRobot 등)와 혼동 금지
- 외부 원문 상태 (statusRaw) — text — 포털/시트 원문 그대로. delivered/completed만으로 receipt 확정 금지
- 외부 상태 확인 시각 (statusObservedAt) — instant — 상태를 본 시각. 실제 입고일(receivedAt)과 다름
- 원본 신청 식별자 묶음 (sourceIdentity) — json — provider, externalNo, requestNo, workbookProfile, sheetName, rowNumber, rawLineKeys 등. 원본 중복 검토용이며 PK 아님
- 신청 메모 (notes) — text — 원문/작업자 설명. 수량·상태 검증 우회 금지
- 행 revision (revision) — integer — NOT NULL — expectedRevision 충돌 검사용 양의 정수
- 생성 시각 (createdAt) — instant — NOT NULL — 서버 기록 시각
- 수정 시각 (updatedAt) — instant — NOT NULL — 서버 최신 수정 시각
- 근거 참조 배열 (sourceRefs) — json — NOT NULL — commandId, 티켓, Excel 행, 포털 스냅샷, 사용자 확인 근거
- 스키마 버전 (schemaVersion) — integer — NOT NULL — 이 계약의 payload 버전
부품 이동·품질 이력 (DOC_F06__opsPartEvents)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 동일 작업 묶음 (operationId) — uuid — 외래 키 → 부품 작업 묶음.고유번호 — NOT NULL — 같은 workspace의 opsPartOperations.id 참조. API 명칭 operationId/sourceOperationId는 opsPartOperations.id alias
- 실물 (unitId) — uuid — 외래 키 → 개별 부품 실물.고유번호 — NOT NULL — 외부 FK: opsPartUnits.id (이 섹션에서 생략)
- 정정/반전 대상 (reversesId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호
- 정정 대상 (correctsEventId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 사건 종류 (type) — text — NOT NULL
- 출발 위치 스냅샷 (fromLocation) — json — NOT NULL — kind(asset|bench|storage|externalCustody|unknown), assetId?, slot?, label?. legacy kind=robot은 kind=asset + assetKind=r…
- 도착 위치 스냅샷 (toLocation) — json — NOT NULL — kind(asset|bench|storage|externalCustody|unknown), assetId?, slot?, label?. legacy kind=robot은 kind=asset + assetKind=r…
- 이전 품질 (conditionBefore) — text — NOT NULL
- 변경 품질 (conditionAfter) — text — NOT NULL
- 작업 목적 (purpose) — text — NOT NULL
- 공급 출처 유형 (sourceKind) — text — donorAsset / reservedSupplyForOtherAsset / unallocatedStock / externalLoan / unknown. legacy donorRobot/reservedSupplyF…
- 시험 결과 (testResult) — text
- 실제 발생 시각 (occurredAt) — instant — 발생 시각 불명이면 NULL. recordedAt으로 대체하지 않음
- 변경 의미 (changeMode) — text — NOT NULL — newFact / reassessment / correction
- 변경 사유 (reasonText) — text — NOT NULL
- 표준 사유 코드 (reasonCode) — text
- 서버 기록 시각 (recordedAt) — instant — NOT NULL
- 관찰 증상 (symptoms) — text
- 추정 원인 (suspectedCause) — text
- 확정 원인 (confirmedCause) — text
- 영향받은 기록 (affectedRefs) — json — NOT NULL
- 변경 전 값 (beforeValues) — json — NOT NULL
- 변경 후 값 (afterValues) — json — NOT NULL
- 폐기 사유 (disposalReason) — text
- 실제 수행자 (performedBy) — text
부품 이동·품질 이력 (DOC_F04__opsPartEvents)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 동일 작업 묶음 (operationId) — uuid — 외래 키 → 부품 작업 묶음.고유번호 — NOT NULL — 같은 workspace의 opsPartOperations.id 참조. API 명칭 operationId/sourceOperationId는 opsPartOperations.id alias
- 실물 (unitId) — uuid — 외래 키 → 개별 부품 실물.고유번호 — NOT NULL
- 정정/반전 대상 (reversesId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호
- 정정 대상 (correctsEventId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 사건 종류 (type) — text — NOT NULL
- 출발 위치 스냅샷 (fromLocation) — json — NOT NULL — kind(asset|bench|storage|externalCustody|unknown), assetId?, slot?, label?. legacy kind=robot은 kind=asset + assetKind=r…
- 도착 위치 스냅샷 (toLocation) — json — NOT NULL — kind(asset|bench|storage|externalCustody|unknown), assetId?, slot?, label?. legacy kind=robot은 kind=asset + assetKind=r…
- 이전 품질 (conditionBefore) — text — NOT NULL
- 변경 품질 (conditionAfter) — text — NOT NULL
- 작업 목적 (purpose) — text — NOT NULL
- 공급 출처 유형 (sourceKind) — text — donorAsset / reservedSupplyForOtherAsset / unallocatedStock / externalLoan / unknown. legacy donorRobot/reservedSupplyF…
- 시험 결과 (testResult) — text
- 실제 발생 시각 (occurredAt) — instant — 발생 시각 불명이면 NULL. recordedAt으로 대체하지 않음
- 변경 의미 (changeMode) — text — NOT NULL — newFact / reassessment / correction
- 변경 사유 (reasonText) — text — NOT NULL
- 표준 사유 코드 (reasonCode) — text
- 서버 기록 시각 (recordedAt) — instant — NOT NULL
- 관찰 증상 (symptoms) — text
- 추정 원인 (suspectedCause) — text
- 확정 원인 (confirmedCause) — text
- 영향받은 기록 (affectedRefs) — json — NOT NULL
- 변경 전 값 (beforeValues) — json — NOT NULL
- 변경 후 값 (afterValues) — json — NOT NULL
- 폐기 사유 (disposalReason) — text
- 실제 수행자 (performedBy) — text
부품 이동·품질 이력 (DOC_F03__opsPartEvents)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 동일 작업 묶음 (operationId) — uuid — 외래 키 → 부품 작업 묶음.고유번호 — NOT NULL — 같은 workspace의 opsPartOperations.id 참조. API 명칭 operationId/sourceOperationId는 opsPartOperations.id alias
- 실물 (unitId) — uuid — 외래 키 → 개별 부품 실물.고유번호 — NOT NULL
- 정정/반전 대상 (reversesId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호
- 정정 대상 (correctsEventId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 사건 종류 (type) — text — NOT NULL
- 출발 위치 스냅샷 (fromLocation) — json — NOT NULL — kind(asset|bench|storage|externalCustody|unknown), assetId?, slot?, label?. legacy kind=robot은 kind=asset + assetKind=r…
- 도착 위치 스냅샷 (toLocation) — json — NOT NULL — kind(asset|bench|storage|externalCustody|unknown), assetId?, slot?, label?. legacy kind=robot은 kind=asset + assetKind=r…
- 이전 품질 (conditionBefore) — text — NOT NULL
- 변경 품질 (conditionAfter) — text — NOT NULL
- 작업 목적 (purpose) — text — NOT NULL
- 공급 출처 유형 (sourceKind) — text — donorAsset / reservedSupplyForOtherAsset / unallocatedStock / externalLoan / unknown. legacy donorRobot/reservedSupplyF…
- 시험 결과 (testResult) — text
- 실제 발생 시각 (occurredAt) — instant — 발생 시각 불명이면 NULL. recordedAt으로 대체하지 않음
- 변경 의미 (changeMode) — text — NOT NULL — newFact / reassessment / correction
- 변경 사유 (reasonText) — text — NOT NULL
- 표준 사유 코드 (reasonCode) — text
- 서버 기록 시각 (recordedAt) — instant — NOT NULL
- 관찰 증상 (symptoms) — text
- 추정 원인 (suspectedCause) — text
- 확정 원인 (confirmedCause) — text
- 영향받은 기록 (affectedRefs) — json — NOT NULL
- 변경 전 값 (beforeValues) — json — NOT NULL
- 변경 후 값 (afterValues) — json — NOT NULL
- 폐기 사유 (disposalReason) — text
- 실제 수행자 (performedBy) — text
부품 이동·품질 이력 (opsPartEvents)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 동일 작업 묶음 (operationId) — uuid — 외래 키 → 부품 작업 묶음.고유번호 — NOT NULL — 같은 workspace의 opsPartOperations.id 참조. API 명칭 operationId/sourceOperationId는 opsPartOperations.id alias
- 실물 (unitId) — uuid — 외래 키 → 개별 부품 실물.고유번호 — NOT NULL
- 정정/반전 대상 (reversesId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호
- 정정 대상 (correctsEventId) — uuid — 외래 키 → 부품 이동·품질 이력.고유번호
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 사건 종류 (type) — text — NOT NULL
- 출발 위치 스냅샷 (fromLocation) — json — NOT NULL — kind(asset|bench|storage|externalCustody|unknown), assetId?, slot?, label?. legacy kind=robot은 kind=asset + assetKind=r…
- 도착 위치 스냅샷 (toLocation) — json — NOT NULL — kind(asset|bench|storage|externalCustody|unknown), assetId?, slot?, label?. legacy kind=robot은 kind=asset + assetKind=r…
- 이전 품질 (conditionBefore) — text — NOT NULL
- 변경 품질 (conditionAfter) — text — NOT NULL
- 작업 목적 (purpose) — text — NOT NULL
- 공급 출처 유형 (sourceKind) — text — donorAsset / reservedSupplyForOtherAsset / unallocatedStock / externalLoan / unknown. legacy donorRobot/reservedSupplyF…
- 시험 결과 (testResult) — text
- 실제 발생 시각 (occurredAt) — instant — 발생 시각 불명이면 NULL. recordedAt으로 대체하지 않음
- 변경 의미 (changeMode) — text — NOT NULL — newFact / reassessment / correction
- 변경 사유 (reasonText) — text — NOT NULL
- 표준 사유 코드 (reasonCode) — text
- 서버 기록 시각 (recordedAt) — instant — NOT NULL
- 관찰 증상 (symptoms) — text
- 추정 원인 (suspectedCause) — text
- 확정 원인 (confirmedCause) — text
- 영향받은 기록 (affectedRefs) — json — NOT NULL
- 변경 전 값 (beforeValues) — json — NOT NULL
- 변경 후 값 (afterValues) — json — NOT NULL
- 폐기 사유 (disposalReason) — text
- 실제 수행자 (performedBy) — text
부품 작업 묶음 (opsPartOperations)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL
- 작업 대상 자산 (assetId) — uuid — 외래 키 → 자산 마스터.고유번호 — NOT NULL
- 공여/출처 자산 (sourceAssetId) — uuid — 외래 키 → 자산 마스터.고유번호 — 확정된 실제 donor 자산. 원래 예약 대상 자산은 별도 reservation/procurement 역할이며 이 필드에 넣지 않음
- 수혜/장착 자산 (recipientAssetId) — uuid — 외래 키 → 자산 마스터.고유번호 — 확정된 실제 사용 자산. assetId와 다를 때 관계 의미를 명시
- 연결 정비 회차 (maintenanceId) — uuid — 외래 키
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 원본 시스템의 식별자·revision·확인시각만 기록. 이슈/티켓 본문을 복제하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 작업 종류 (operationType) — text — NOT NULL — diagnosis|swap|trial|install|remove|dispose|correction|other
- 작업 상태 (state) — text — NOT NULL — draft|active|trial|completed|reversed|cancelled
- 작업 시작 (startedAt) — instant
- 작업 종료 (finishedAt) — instant
- 작업 요약 (summary) — text — NOT NULL
부품 작업 묶음 (DOC_F03__opsPartOperations)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 작업 대상 자산 (assetId) — uuid — 외래 키 → 자산 마스터.고유번호 — NOT NULL
- 공여/출처 자산 (sourceAssetId) — uuid — 외래 키 → 자산 마스터.고유번호 — 확정된 실제 donor 자산. 원래 예약 대상 자산은 별도 reservation/procurement 역할이며 이 필드에 넣지 않음
- 수혜/장착 자산 (recipientAssetId) — uuid — 외래 키 → 자산 마스터.고유번호 — 확정된 실제 사용 자산. assetId와 다를 때 관계 의미를 명시
- 연결 정비 회차 (maintenanceId) — uuid — 외래 키
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 원본 시스템의 식별자·revision·확인시각만 기록. 이슈/티켓 본문을 복제하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 작업 종류 (operationType) — text — NOT NULL — diagnosis|swap|trial|install|remove|dispose|correction|other
- 작업 상태 (state) — text — NOT NULL — draft|active|trial|completed|reversed|cancelled
- 작업 시작 (startedAt) — instant
- 작업 종료 (finishedAt) — instant
- 작업 요약 (summary) — text — NOT NULL
부품 작업 묶음 (DOC_F04__opsPartOperations)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 작업 대상 자산 (assetId) — uuid — 외래 키 — NOT NULL
- 공여/출처 자산 (sourceAssetId) — uuid — 외래 키 — 확정된 실제 donor 자산. 원래 예약 대상 자산은 별도 reservation/procurement 역할이며 이 필드에 넣지 않음
- 수혜/장착 자산 (recipientAssetId) — uuid — 외래 키 — 확정된 실제 사용 자산. assetId와 다를 때 관계 의미를 명시
- 연결 정비 회차 (maintenanceId) — uuid — 외래 키 — 외부 FK: opsMaintenance.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — 원본 시스템의 식별자·revision·확인시각만 기록. 이슈/티켓 본문을 복제하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 작업 종류 (operationType) — text — NOT NULL — diagnosis|swap|trial|install|remove|dispose|correction|other
- 작업 상태 (state) — text — NOT NULL — draft|active|trial|completed|reversed|cancelled
- 작업 시작 (startedAt) — instant
- 작업 종료 (finishedAt) — instant
- 작업 요약 (summary) — text — NOT NULL
부품 품목 (DOC_F05__opsPartCatalog)
- 고유번호 (id) — uuid — 기본 키 — NOT NULL
- 공유 작업실 (workspaceId) — uuid — 외래 키 → 공유 작업실.작업실 ID — NOT NULL — 외부 FK: opsWorkspaces.id (이 섹션에서 생략)
- 등록/수정 사용자 (actorId) — uuid — 외래 키 → 업무 사용자.사용자 ID — NOT NULL — 외부 FK: opsUsers.id (이 섹션에서 생략)
- 변경 버전 (revision) — integer — NOT NULL
- 등록 시각 (createdAt) — instant — NOT NULL
- 수정 시각 (updatedAt) — instant — NOT NULL
- 출처 식별자 목록 (sourceRefs) — json — NOT NULL — sourceType, sourceId, sourceRevision?, observedAt, confidence; 원본 Excel 행 내용은 복사하지 않음
- 데이터 형식 버전 (schemaVersion) — integer — NOT NULL
- 제조사 품번 (manufacturerPartNo) — text
- 현장 명칭 (fieldName) — text — NOT NULL
- 호환 기종 (modelCompatibility) — json — NOT NULL
- 종류/규격 (variant) — text
- 좌우 구분 (side) — text
- 장착 슬롯 (slot) — text
- 품목 확인 여부 (confirmed) — boolean — NOT NULL
외 22개 테이블