forked from sagnik/Project_Velocity
#24 WebOS Completion Co-authored-by: Sayan Datta <sayan@Sayans-MacBook-Air.local> Reviewed-on: sagnik/Project_Velocity#25
2.4 KiB
2.4 KiB
Contracts and JSON Schemas_ Templates Inventory Edge Capture
Date: 2026-04-16
Status: Contract baseline
Owner: Sayan
Purpose: Define the minimum JSON and contract entities for this workstream.
1. Template Catalog Contracts
TemplateChapter
chapterIdnamedescriptionsortOrder
TemplateSubchapter
subchapterIdchapterIdnamedescriptionsortOrder
OracleComponentTemplate
templateIdchapterIdsubchapterIdnamecomponentTypeacceptedShapesjsonTemplateoriginstatusversion
OracleTemplateSeedExample
exampleIdtemplateIdtitleexampleJsonqualityNotes
2. Kimi Synthetic Data Contracts
SyntheticExpansionJob
jobIdtemplateIdchapterIdsubchapterIdmodelstatusrequestedCountacceptedCount
3. Inventory Contracts
InventoryProperty
propertyIdsourceIdprojectNamedeveloperNamelocationpropertyTypepriceBandsunitMixamenitiesmediaRefsstatus
InventoryImportBatch
batchIdsourceTypesubmittedBystatusstartedAtcompletedAt
4. Edge Capture Contracts
CommunicationEvent
eventIdleadIdchanneldirectionprovidercaptureModetimestampsummaryrawReferencerecordingRef
CommunicationMemoryFact
factIdleadIdeventIdfactTypefactTexteffectiveDateconfidenceextractedFrom
TranscriptSegment
segmentIdeventIdspeakerLabelstartMsendMstextconfidence
CalendarEvent
calendarEventIdownerUserIdleadIdsourceEventIdtitledescriptionstartAtendAtstatuscreatedBy
InsightRecommendation
recommendationIdleadIdsourceEventIdrecommendationTypesummarysuggestedActiontargetSystemstatus
TranscriptionJob
transcriptionJobIdeventIdmediaTypestatustranscriptRefconsentState
5. Admin Contracts
AdminActionRequest
actionIdactionTypetargetTypetargetIdrequestedBypayload
AdminActionResult
actionIdstatusmessageartifacts
6. Contract Rules
- all contracts must be backend-owned
- mobile and web surfaces consume, not redefine
- communication capture contracts must include consent and provider provenance