@numericoach/gskills-admin-cli 0.1.30 → 0.1.32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +53 -4
- package/dist/gskills-admin.js +22904 -756
- package/package.json +25 -24
- package/skills/gskills-admin-cli/SKILL.md +226 -260
- package/skills/gskills-admin-cli/references/content-platform-tables.md +1647 -0
- package/skills/gskills-admin-cli/references/content-platform.md +146 -0
- package/skills/gskills-content-sync-cache-ops/SKILL.md +36 -89
- package/skills/gskills-customer-playbooks/SKILL.md +18 -19
- package/skills/gskills-ops-db-audit/SKILL.md +5 -5
- package/skills/gskills-page-content-blocks/SKILL.md +40 -47
- package/skills/gskills-source-id-repair/SKILL.md +11 -30
|
@@ -0,0 +1,1647 @@
|
|
|
1
|
+
# Content platform table reference
|
|
2
|
+
|
|
3
|
+
Generated from `src/cli/content-platform-resource-guides.ts`. Edit that source and run `bun run --cwd packages/gskills-admin-cli docs:content-platform` to refresh both copies. Each entry is also available through `<resource> help` and `content-platform explain <resource>`.
|
|
4
|
+
|
|
5
|
+
This reference covers all 71 models in the page platform, translation batch, content inheritance, migration control, workflow platform, quiz revision and stable child identity schemas.
|
|
6
|
+
|
|
7
|
+
All resources below are read-only in the CLI. Named writers are internal product operations or system workers, not CLI commands you can invoke by typing their names. Author pages with the guarded `page-authoring` family (editor, create, draft, readiness, publish, upload-image) and run every other admin write by name with `admin ops` / `admin run` (pages.restore-revision, pages.archive, pages.unpublish, quizzes.*, learning-paths.*, catalogue.* ...). See [the operating guide](content-platform.md) for the authority checks and supported workflows.
|
|
8
|
+
|
|
9
|
+
Examples are read-only queries. Replace angle-bracket placeholders with verified IDs. Unless overridden with `--fields`, lists return the resource's default fields, not necessarily its full JSON payloads. “No rows” means only that this query found no records; interpret missing rows using the inheritance and authority rules.
|
|
10
|
+
|
|
11
|
+
## Find a table
|
|
12
|
+
|
|
13
|
+
| CLI resource | Prisma model |
|
|
14
|
+
| --- | --- |
|
|
15
|
+
| [canonical-pages](#canonical-pages) | `Page` |
|
|
16
|
+
| [page-locales](#page-locales) | `PageLocale` |
|
|
17
|
+
| [page-revisions](#page-revisions) | `PageRevision` |
|
|
18
|
+
| [page-revision-categories](#page-revision-categories) | `PageRevisionCategory` |
|
|
19
|
+
| [page-revision-locales](#page-revision-locales) | `PageRevisionLocale` |
|
|
20
|
+
| [page-block-identities](#page-block-identities) | `PageBlockIdentity` |
|
|
21
|
+
| [page-revision-blocks](#page-revision-blocks) | `PageRevisionBlock` |
|
|
22
|
+
| [page-revision-block-scopes](#page-revision-block-scopes) | `PageRevisionBlockScope` |
|
|
23
|
+
| [page-revision-block-locales](#page-revision-block-locales) | `PageRevisionBlockLocale` |
|
|
24
|
+
| [page-locale-validation-checkpoints](#page-locale-validation-checkpoints) | `PageLocaleValidationCheckpoint` |
|
|
25
|
+
| [page-block-aliases](#page-block-aliases) | `PageBlockAlias` |
|
|
26
|
+
| [page-revision-events](#page-revision-events) | `PageRevisionEvent` |
|
|
27
|
+
| [page-route-claims](#page-route-claims) | `PageRouteClaim` |
|
|
28
|
+
| [page-route-aliases](#page-route-aliases) | `PageRouteAlias` |
|
|
29
|
+
| [page-translation-batches](#page-translation-batches) | `PageTranslationBatch` |
|
|
30
|
+
| [content-family-identities](#content-family-identities) | `ContentFamilyIdentity` |
|
|
31
|
+
| [content-family-locale-identities](#content-family-locale-identities) | `ContentFamilyLocaleIdentity` |
|
|
32
|
+
| [content-id-aliases](#content-id-aliases) | `ContentIdAlias` |
|
|
33
|
+
| [instance-knowledge-presentations](#instance-knowledge-presentations) | `InstanceKnowledgePresentation` |
|
|
34
|
+
| [instance-content-availability](#instance-content-availability) | `InstanceContentAvailability` |
|
|
35
|
+
| [instance-content-locale-availability](#instance-content-locale-availability) | `InstanceContentLocaleAvailability` |
|
|
36
|
+
| [instance-page-quiz-placements](#instance-page-quiz-placements) | `InstancePageQuizPlacement` |
|
|
37
|
+
| [instance-page-audience-policies](#instance-page-audience-policies) | `InstancePageAudiencePolicy` |
|
|
38
|
+
| [instance-page-audience-entities](#instance-page-audience-entities) | `InstancePageAudienceEntity` |
|
|
39
|
+
| [instance-page-audience-groups](#instance-page-audience-groups) | `InstancePageAudienceGroup` |
|
|
40
|
+
| [instance-page-presentation-overrides](#instance-page-presentation-overrides) | `InstancePagePresentationOverride` |
|
|
41
|
+
| [instance-learning-path-presentation-overrides](#instance-learning-path-presentation-overrides) | `InstanceLearningPathPresentationOverride` |
|
|
42
|
+
| [resource-presentation-snapshots](#resource-presentation-snapshots) | `InstanceResourcePresentationSnapshot` |
|
|
43
|
+
| [instance-category-presentation-snapshots](#instance-category-presentation-snapshots) | `InstanceCategoryPresentationSnapshot` |
|
|
44
|
+
| [instance-page-locale-audience-overrides](#instance-page-locale-audience-overrides) | `InstancePageLocaleAudienceOverride` |
|
|
45
|
+
| [instance-menu-configurations](#instance-menu-configurations) | `InstanceMenuConfiguration` |
|
|
46
|
+
| [instance-menu-node-exclusions](#instance-menu-node-exclusions) | `InstanceMenuNodeExclusion` |
|
|
47
|
+
| [instance-menu-placements](#instance-menu-placements) | `InstanceMenuPlacement` |
|
|
48
|
+
| [menu-section-category-links](#menu-section-category-links) | `MenuSectionCategoryLink` |
|
|
49
|
+
| [content-assets](#content-assets) | `ContentAsset` |
|
|
50
|
+
| [content-asset-references](#content-asset-references) | `ContentAssetReference` |
|
|
51
|
+
| [content-migration-states](#content-migration-states) | `ContentMigrationState` |
|
|
52
|
+
| [page-migration-states](#page-migration-states) | `PageMigrationState` |
|
|
53
|
+
| [content-scope-versions](#content-scope-versions) | `ContentScopeVersion` |
|
|
54
|
+
| [content-projection-outbox-events](#content-projection-outbox-events) | `ContentProjectionOutboxEvent` |
|
|
55
|
+
| [content-legacy-projection-states](#content-legacy-projection-states) | `ContentLegacyProjectionState` |
|
|
56
|
+
| [content-migration-runs](#content-migration-runs) | `ContentMigrationRun` |
|
|
57
|
+
| [content-migration-leases](#content-migration-leases) | `ContentMigrationLease` |
|
|
58
|
+
| [content-migration-checkpoints](#content-migration-checkpoints) | `ContentMigrationCheckpoint` |
|
|
59
|
+
| [content-migration-issues](#content-migration-issues) | `ContentMigrationIssue` |
|
|
60
|
+
| [content-reconciliation-ledgers](#content-reconciliation-ledgers) | `ContentReconciliationLedger` |
|
|
61
|
+
| [workflow-definitions](#workflow-definitions) | `WorkflowDefinition` |
|
|
62
|
+
| [workflow-revisions](#workflow-revisions) | `WorkflowRevision` |
|
|
63
|
+
| [workflow-action-identities](#workflow-action-identities) | `WorkflowActionIdentity` |
|
|
64
|
+
| [workflow-revision-actions](#workflow-revision-actions) | `WorkflowRevisionAction` |
|
|
65
|
+
| [instance-workflow-activations](#instance-workflow-activations) | `InstanceWorkflowActivation` |
|
|
66
|
+
| [instance-workflow-action-bindings](#instance-workflow-action-bindings) | `InstanceWorkflowActionBinding` |
|
|
67
|
+
| [legacy-workflow-aliases](#legacy-workflow-aliases) | `LegacyWorkflowAlias` |
|
|
68
|
+
| [legacy-workflow-action-aliases](#legacy-workflow-action-aliases) | `LegacyWorkflowActionAlias` |
|
|
69
|
+
| [workflow-rollout-events](#workflow-rollout-events) | `WorkflowRolloutEvent` |
|
|
70
|
+
| [workflow-engine-leases](#workflow-engine-leases) | `WorkflowEngineLease` |
|
|
71
|
+
| [workflow-execution-attempts](#workflow-execution-attempts) | `WorkflowExecutionAttempt` |
|
|
72
|
+
| [workflow-execution-dedupe-claims](#workflow-execution-dedupe-claims) | `WorkflowExecutionDedupeClaim` |
|
|
73
|
+
| [workflow-definition-events](#workflow-definition-events) | `WorkflowDefinitionEvent` |
|
|
74
|
+
| [quiz-family-states](#quiz-family-states) | `QuizFamilyState` |
|
|
75
|
+
| [quiz-locale-identities](#quiz-locale-identities) | `QuizLocaleIdentity` |
|
|
76
|
+
| [quiz-question-identities](#quiz-question-identities) | `QuizQuestionIdentity` |
|
|
77
|
+
| [quiz-option-identities](#quiz-option-identities) | `QuizOptionIdentity` |
|
|
78
|
+
| [quiz-revisions](#quiz-revisions) | `QuizRevision` |
|
|
79
|
+
| [quiz-revision-locales](#quiz-revision-locales) | `QuizRevisionLocale` |
|
|
80
|
+
| [quiz-revision-questions](#quiz-revision-questions) | `QuizRevisionQuestion` |
|
|
81
|
+
| [quiz-revision-options](#quiz-revision-options) | `QuizRevisionOption` |
|
|
82
|
+
| [quiz-answer-option-selections](#quiz-answer-option-selections) | `UserQuizAnswerOptionSelection` |
|
|
83
|
+
| [learning-path-group-identities](#learning-path-group-identities) | `LearningPathGroupIdentity` |
|
|
84
|
+
| [learning-path-item-identities](#learning-path-item-identities) | `LearningPathItemIdentity` |
|
|
85
|
+
| [chromebook-exercise-step-identities](#chromebook-exercise-step-identities) | `ChromebookExerciseStepIdentity` |
|
|
86
|
+
|
|
87
|
+
## canonical-pages
|
|
88
|
+
|
|
89
|
+
Prisma model `Page` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
90
|
+
|
|
91
|
+
**Purpose.** The durable identity of one page across every language and version. It holds the draft and published pointers, not the page body.
|
|
92
|
+
|
|
93
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
94
|
+
|
|
95
|
+
**Relationships.** id is also ContentFamilyIdentity.id. PageLocale and PageRevision point to this page.
|
|
96
|
+
|
|
97
|
+
**Inspect it when.** Find which revision learners should receive and whether a separate draft or archive state exists.
|
|
98
|
+
|
|
99
|
+
**Who writes it.** Canonical page editor operations create the page, manage its draft, publish, unpublish and archive; migration seeds the baseline.
|
|
100
|
+
|
|
101
|
+
**Avoid this mistake.** Do not confuse Page with legacy Pages or use a revision ID as a page ID.
|
|
102
|
+
|
|
103
|
+
**Scope.** --instance filters ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
gskills-admin canonical-pages list --where '{"id":"<pageId>"}' --output json
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
## page-locales
|
|
110
|
+
|
|
111
|
+
Prisma model `PageLocale` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
112
|
+
|
|
113
|
+
**Purpose.** The durable identity of one language of a page, reused across revisions.
|
|
114
|
+
|
|
115
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
116
|
+
|
|
117
|
+
**Relationships.** pageId points to Page; PageRevisionLocale provides this language's values for each revision.
|
|
118
|
+
|
|
119
|
+
**Inspect it when.** Check whether a language exists or has been retired.
|
|
120
|
+
|
|
121
|
+
**Who writes it.** AddPageLocale, ReactivatePageLocale and RetirePageLocale through the canonical editor, plus migration.
|
|
122
|
+
|
|
123
|
+
**Avoid this mistake.** An existing language identity does not mean the published revision has validated content in that language.
|
|
124
|
+
|
|
125
|
+
**Scope.** --instance filters page.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
gskills-admin page-locales list --where '{"pageId":"<pageId>"}' --output json
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
## page-revisions
|
|
132
|
+
|
|
133
|
+
Prisma model `PageRevision` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
134
|
+
|
|
135
|
+
**Purpose.** One working draft or immutable published version, including settings shared by all languages.
|
|
136
|
+
|
|
137
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
138
|
+
|
|
139
|
+
**Relationships.** pageId points to Page. Its locales, blocks and categories make up the complete version.
|
|
140
|
+
|
|
141
|
+
**Inspect it when.** Compare the live published pointer with draft changes, lockVersion, publication metadata and restoration ancestry.
|
|
142
|
+
|
|
143
|
+
**Who writes it.** EnsurePageDraft, SavePageDraft, PublishPageDraft and RestorePageRevision through the canonical editor.
|
|
144
|
+
|
|
145
|
+
**Avoid this mistake.** Saving is not publishing; restoring creates draft content and never rewrites a historical published version.
|
|
146
|
+
|
|
147
|
+
**Scope.** --instance filters page.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
148
|
+
|
|
149
|
+
```bash
|
|
150
|
+
gskills-admin page-revisions list --where '{"pageId":"<pageId>"}' --output json
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
## page-revision-categories
|
|
154
|
+
|
|
155
|
+
Prisma model `PageRevisionCategory` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
156
|
+
|
|
157
|
+
**Purpose.** The ordered category memberships saved as part of a specific page revision.
|
|
158
|
+
|
|
159
|
+
**Key.** `revisionId` + `categoryFamilyId`. Use list --where with revisionId, categoryFamilyId. There is no scalar id for get <id>.
|
|
160
|
+
|
|
161
|
+
**Relationships.** revisionId points to PageRevision; categoryFamilyId identifies a canonical category family.
|
|
162
|
+
|
|
163
|
+
**Inspect it when.** Explain why the draft and published page belong to different categories.
|
|
164
|
+
|
|
165
|
+
**Who writes it.** Canonical page draft save, publication and migration copy the revision-owned category set.
|
|
166
|
+
|
|
167
|
+
**Avoid this mistake.** This is a revision relation, not a customer menu placement or audience restriction.
|
|
168
|
+
|
|
169
|
+
**Scope.** --instance filters revision.page.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
170
|
+
|
|
171
|
+
```bash
|
|
172
|
+
gskills-admin page-revision-categories list --where '{"revisionId":"<revisionId>"}' --output json
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
## page-revision-locales
|
|
176
|
+
|
|
177
|
+
Prisma model `PageRevisionLocale` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
178
|
+
|
|
179
|
+
**Purpose.** The title, slug, description and validation state of one language in one page revision.
|
|
180
|
+
|
|
181
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
182
|
+
|
|
183
|
+
**Relationships.** revisionId identifies PageRevision; pageLocaleId identifies PageLocale; validation pointers refer to PageLocaleValidationCheckpoint.
|
|
184
|
+
|
|
185
|
+
**Inspect it when.** Diagnose a missing title, stale translation or publication blocker for a specific draft language.
|
|
186
|
+
|
|
187
|
+
**Who writes it.** Canonical locale editing, translation and validation operations; migration supplies initial values.
|
|
188
|
+
|
|
189
|
+
**Avoid this mistake.** Language text lives here, while stable language identity lives in PageLocale. A MISSING row is not a usable translation.
|
|
190
|
+
|
|
191
|
+
**Scope.** --instance filters revision.page.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
192
|
+
|
|
193
|
+
```bash
|
|
194
|
+
gskills-admin page-revision-locales list --where '{"revisionId":"<revisionId>"}' --output json
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
## page-block-identities
|
|
198
|
+
|
|
199
|
+
Prisma model `PageBlockIdentity` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
200
|
+
|
|
201
|
+
**Purpose.** A durable block identity that survives page revisions and translations.
|
|
202
|
+
|
|
203
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
204
|
+
|
|
205
|
+
**Relationships.** pageId points to Page; PageRevisionBlock stores each revision's version of this block; PageBlockAlias maps old IDs.
|
|
206
|
+
|
|
207
|
+
**Inspect it when.** Trace the same activity or block across edits without confusing it with its revision row.
|
|
208
|
+
|
|
209
|
+
**Who writes it.** Canonical page draft block normalization and migration create or retire identities.
|
|
210
|
+
|
|
211
|
+
**Avoid this mistake.** Changing an identity to match visual order can break durable activity references. Order belongs to the revision block.
|
|
212
|
+
|
|
213
|
+
**Scope.** --instance filters page.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
214
|
+
|
|
215
|
+
```bash
|
|
216
|
+
gskills-admin page-block-identities list --where '{"pageId":"<pageId>"}' --output json
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
## page-revision-blocks
|
|
220
|
+
|
|
221
|
+
Prisma model `PageRevisionBlock` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
222
|
+
|
|
223
|
+
**Purpose.** The structure and shared data of one block in one page revision, including order, nesting and block type.
|
|
224
|
+
|
|
225
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
226
|
+
|
|
227
|
+
**Relationships.** revisionId points to PageRevision and blockIdentityId to PageBlockIdentity. Localized payloads and selected language scopes are separate rows.
|
|
228
|
+
|
|
229
|
+
**Inspect it when.** Inspect a wrong block order, nested location, non-text setting or canonical reference in a draft or published version.
|
|
230
|
+
|
|
231
|
+
**Who writes it.** Canonical draft saves and revision cloning/publication, plus migration.
|
|
232
|
+
|
|
233
|
+
**Avoid this mistake.** sharedPayload is not the full localized block body; combine it with the matching locale payload and scope.
|
|
234
|
+
|
|
235
|
+
**Scope.** --instance filters revision.page.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
236
|
+
|
|
237
|
+
```bash
|
|
238
|
+
gskills-admin page-revision-blocks list --where '{"revisionId":"<revisionId>"}' --output json
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
## page-revision-block-scopes
|
|
242
|
+
|
|
243
|
+
Prisma model `PageRevisionBlockScope` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
244
|
+
|
|
245
|
+
**Purpose.** The explicit language selection for a revision block whose visibility is limited to selected languages.
|
|
246
|
+
|
|
247
|
+
**Key.** `revisionBlockId` + `pageLocaleId`. Use list --where with revisionBlockId, pageLocaleId. There is no scalar id for get <id>.
|
|
248
|
+
|
|
249
|
+
**Relationships.** The key combines PageRevisionBlock.id and PageLocale.id.
|
|
250
|
+
|
|
251
|
+
**Inspect it when.** Explain why a block appears in one language but not another.
|
|
252
|
+
|
|
253
|
+
**Who writes it.** Canonical draft block scope operations and migration.
|
|
254
|
+
|
|
255
|
+
**Avoid this mistake.** Interpret these rows with PageRevisionBlock.localeScope. No selected rows does not by itself mean an ALL block is hidden.
|
|
256
|
+
|
|
257
|
+
**Scope.** --instance filters revisionBlock.revision.page.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
258
|
+
|
|
259
|
+
```bash
|
|
260
|
+
gskills-admin page-revision-block-scopes list --where '{"revisionBlockId":"<revisionBlockId>"}' --output json
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
## page-revision-block-locales
|
|
264
|
+
|
|
265
|
+
Prisma model `PageRevisionBlockLocale` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
266
|
+
|
|
267
|
+
**Purpose.** The translated payload and field-presence information for one revision block in one language.
|
|
268
|
+
|
|
269
|
+
**Key.** `revisionBlockId` + `pageLocaleId`. Use list --where with revisionBlockId, pageLocaleId. There is no scalar id for get <id>.
|
|
270
|
+
|
|
271
|
+
**Relationships.** The key combines PageRevisionBlock.id and PageLocale.id; the shared structure stays on PageRevisionBlock.
|
|
272
|
+
|
|
273
|
+
**Inspect it when.** Inspect the exact translated text/media or missing-versus-empty field behavior of a block.
|
|
274
|
+
|
|
275
|
+
**Who writes it.** Canonical locale editing and translation services, plus draft cloning and migration.
|
|
276
|
+
|
|
277
|
+
**Avoid this mistake.** Do not overwrite shared structure in localizedPayload or assume an absent field means an intentional empty value.
|
|
278
|
+
|
|
279
|
+
**Scope.** --instance filters revisionBlock.revision.page.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
280
|
+
|
|
281
|
+
```bash
|
|
282
|
+
gskills-admin page-revision-block-locales list --where '{"revisionBlockId":"<revisionBlockId>"}' --output json
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
## page-locale-validation-checkpoints
|
|
286
|
+
|
|
287
|
+
Prisma model `PageLocaleValidationCheckpoint` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
288
|
+
|
|
289
|
+
**Purpose.** An immutable snapshot of the exact locale content and source snapshot that a validation accepted.
|
|
290
|
+
|
|
291
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
292
|
+
|
|
293
|
+
**Relationships.** revisionLocaleId points to PageRevisionLocale. sourceCheckpointId can link a translation to the source validation it used.
|
|
294
|
+
|
|
295
|
+
**Inspect it when.** Explain which content was reviewed and whether later changes invalidated that review.
|
|
296
|
+
|
|
297
|
+
**Who writes it.** Canonical locale validation operations and migration baseline creation.
|
|
298
|
+
|
|
299
|
+
**Avoid this mistake.** validatedAt alone is insufficient. Compare digests, draftLockVersion and sourceCheckpointId; migration validation is not a new human review.
|
|
300
|
+
|
|
301
|
+
**Scope.** --instance filters revisionLocale.revision.page.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
302
|
+
|
|
303
|
+
```bash
|
|
304
|
+
gskills-admin page-locale-validation-checkpoints list --where '{"revisionLocaleId":"<revisionLocaleId>"}' --output json
|
|
305
|
+
```
|
|
306
|
+
|
|
307
|
+
## page-block-aliases
|
|
308
|
+
|
|
309
|
+
Prisma model `PageBlockAlias` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
310
|
+
|
|
311
|
+
**Purpose.** The durable mapping from an old page/block pair to the canonical block identity.
|
|
312
|
+
|
|
313
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
314
|
+
|
|
315
|
+
**Relationships.** legacyPageId plus legacyBlockId resolves to PageBlockIdentity.id.
|
|
316
|
+
|
|
317
|
+
**Inspect it when.** Resolve an activity reference that still contains old page and block IDs.
|
|
318
|
+
|
|
319
|
+
**Who writes it.** Migration and compatibility identity mapping.
|
|
320
|
+
|
|
321
|
+
**Avoid this mistake.** Aliases must survive removal of legacy page rows; never guess a replacement from block position or label.
|
|
322
|
+
|
|
323
|
+
**Scope.** --instance filters blockIdentity.page.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
324
|
+
|
|
325
|
+
```bash
|
|
326
|
+
gskills-admin page-block-aliases list --where '{"legacyPageId":"<legacyPageId>"}' --output json
|
|
327
|
+
```
|
|
328
|
+
|
|
329
|
+
## page-revision-events
|
|
330
|
+
|
|
331
|
+
Prisma model `PageRevisionEvent` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
332
|
+
|
|
333
|
+
**Purpose.** The audit trail of page lifecycle and revision operations.
|
|
334
|
+
|
|
335
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
336
|
+
|
|
337
|
+
**Relationships.** pageId points to Page; revisionId optionally identifies the affected PageRevision.
|
|
338
|
+
|
|
339
|
+
**Inspect it when.** Find who performed a publication, restoration, archive or other recorded page action and when.
|
|
340
|
+
|
|
341
|
+
**Who writes it.** Guarded canonical page commands record events with their transactions.
|
|
342
|
+
|
|
343
|
+
**Avoid this mistake.** An event is evidence, not the current published pointer and not an instruction to replay the action.
|
|
344
|
+
|
|
345
|
+
**Scope.** --instance filters page.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
346
|
+
|
|
347
|
+
```bash
|
|
348
|
+
gskills-admin page-revision-events list --where '{"pageId":"<pageId>"}' --output json
|
|
349
|
+
```
|
|
350
|
+
|
|
351
|
+
## page-route-claims
|
|
352
|
+
|
|
353
|
+
Prisma model `PageRouteClaim` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
354
|
+
|
|
355
|
+
**Purpose.** The reservation of a locale/slug in a routing scope, including canonical and replacement claims.
|
|
356
|
+
|
|
357
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
358
|
+
|
|
359
|
+
**Relationships.** pageId and pageLocaleId identify the destination; scopeKey, locale and slug form the unique claim.
|
|
360
|
+
|
|
361
|
+
**Inspect it when.** Diagnose a publication slug collision or an explicit customer replacement of a shared route.
|
|
362
|
+
|
|
363
|
+
**Who writes it.** Canonical route/publication operations and migration.
|
|
364
|
+
|
|
365
|
+
**Avoid this mistake.** A route claim is not the same as an old-slug alias. Do not infer the owning page from its slug alone.
|
|
366
|
+
|
|
367
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
368
|
+
|
|
369
|
+
```bash
|
|
370
|
+
gskills-admin page-route-claims list --where '{"instanceId":"<instanceId>","pageId":"<pageId>"}' --output json
|
|
371
|
+
```
|
|
372
|
+
|
|
373
|
+
## page-route-aliases
|
|
374
|
+
|
|
375
|
+
Prisma model `PageRouteAlias` in `prisma/schema/Content/PagePlatform.prisma`.
|
|
376
|
+
|
|
377
|
+
**Purpose.** A historical slug that continues to resolve to a stable page language.
|
|
378
|
+
|
|
379
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
380
|
+
|
|
381
|
+
**Relationships.** pageLocaleId points to PageLocale; scopeKey, locale and oldSlug identify the old route.
|
|
382
|
+
|
|
383
|
+
**Inspect it when.** Explain an old bookmarked URL or redirect after a slug change or migration.
|
|
384
|
+
|
|
385
|
+
**Who writes it.** Canonical route history and migration.
|
|
386
|
+
|
|
387
|
+
**Avoid this mistake.** Keep aliases after legacy deletion; resolution must preserve locale and routing scope rather than matching any same-named page.
|
|
388
|
+
|
|
389
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
390
|
+
|
|
391
|
+
```bash
|
|
392
|
+
gskills-admin page-route-aliases list --where '{"instanceId":"<instanceId>","pageLocaleId":"<pageLocaleId>"}' --output json
|
|
393
|
+
```
|
|
394
|
+
|
|
395
|
+
## page-translation-batches
|
|
396
|
+
|
|
397
|
+
Prisma model `PageTranslationBatch` in `prisma/schema/Content/PageTranslationBatch.prisma`.
|
|
398
|
+
|
|
399
|
+
**Purpose.** A durable background job translating several locales of one page draft.
|
|
400
|
+
|
|
401
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
402
|
+
|
|
403
|
+
**Relationships.** pageId and revisionId identify the canonical page and draft; instanceId, authorityEpoch and lockVersion bind the job to its authorized context.
|
|
404
|
+
|
|
405
|
+
**Inspect it when.** Investigate queued/stalled translations, completed and failed counts, or the worker run and error.
|
|
406
|
+
|
|
407
|
+
**Who writes it.** QueuePageDraftTranslations with PageTranslationBatch/Dispatch services and the translation worker.
|
|
408
|
+
|
|
409
|
+
**Avoid this mistake.** A COMPLETED job means its translation work finished, not that the draft was validated or published. Never reset its dispatch lease manually.
|
|
410
|
+
|
|
411
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
412
|
+
|
|
413
|
+
```bash
|
|
414
|
+
gskills-admin page-translation-batches list --where '{"instanceId":"<instanceId>","pageId":"<pageId>"}' --output json
|
|
415
|
+
```
|
|
416
|
+
|
|
417
|
+
## content-family-identities
|
|
418
|
+
|
|
419
|
+
Prisma model `ContentFamilyIdentity` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
420
|
+
|
|
421
|
+
**Purpose.** The cross-language identity and owner of one logical content family, such as a page, quiz or learning path.
|
|
422
|
+
|
|
423
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
424
|
+
|
|
425
|
+
**Relationships.** ContentFamilyLocaleIdentity, ContentIdAlias, availability rows and type-specific records refer to this family. Page and QuizFamilyState reuse its ID.
|
|
426
|
+
|
|
427
|
+
**Inspect it when.** Determine content type, true ownership and the stable family ID before following older IDs.
|
|
428
|
+
|
|
429
|
+
**Who writes it.** Canonical family creation and migration/owner reconciliation.
|
|
430
|
+
|
|
431
|
+
**Avoid this mistake.** ownerInstanceId=null is shared. ownerInstanceId=global is dedicated to global. canonicalLegacyRootId is compatibility lineage, not permission to edit an old copy.
|
|
432
|
+
|
|
433
|
+
**Scope.** --instance filters ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
434
|
+
|
|
435
|
+
```bash
|
|
436
|
+
gskills-admin content-family-identities list --where '{"id":"<familyId>"}' --output json
|
|
437
|
+
```
|
|
438
|
+
|
|
439
|
+
## content-family-locale-identities
|
|
440
|
+
|
|
441
|
+
Prisma model `ContentFamilyLocaleIdentity` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
442
|
+
|
|
443
|
+
**Purpose.** The stable language identity for a generic content family.
|
|
444
|
+
|
|
445
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
446
|
+
|
|
447
|
+
**Relationships.** contentFamilyId points to ContentFamilyIdentity; canonicalLegacyLocaleId records the compatibility language row.
|
|
448
|
+
|
|
449
|
+
**Inspect it when.** Resolve the correct language of a non-page family or inspect retirement.
|
|
450
|
+
|
|
451
|
+
**Who writes it.** Canonical family locale identity operations and migration.
|
|
452
|
+
|
|
453
|
+
**Avoid this mistake.** It stores identity, not translated content or publication validation. Page-specific locale text and readiness are in PageRevisionLocale.
|
|
454
|
+
|
|
455
|
+
**Scope.** --instance filters contentFamily.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
456
|
+
|
|
457
|
+
```bash
|
|
458
|
+
gskills-admin content-family-locale-identities list --where '{"contentFamilyId":"<familyId>"}' --output json
|
|
459
|
+
```
|
|
460
|
+
|
|
461
|
+
## content-id-aliases
|
|
462
|
+
|
|
463
|
+
Prisma model `ContentIdAlias` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
464
|
+
|
|
465
|
+
**Purpose.** The verified mapping from a legacy content ID to its canonical item and family, with consumer and locale context.
|
|
466
|
+
|
|
467
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
468
|
+
|
|
469
|
+
**Relationships.** canonicalFamilyId points to ContentFamilyIdentity; canonicalId identifies the type-specific canonical item.
|
|
470
|
+
|
|
471
|
+
**Inspect it when.** Resolve old page, quiz or other content references and inspect whether a compatibility projection has been retired.
|
|
472
|
+
|
|
473
|
+
**Who writes it.** Migration, canonical identity bridges and retirement marking.
|
|
474
|
+
|
|
475
|
+
**Avoid this mistake.** Filter by contentType as well when interpreting IDs. projectionRetiredAt is a tombstone, not a reason to delete the alias or recreate the projection.
|
|
476
|
+
|
|
477
|
+
**Scope.** --instance filters consumerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
478
|
+
|
|
479
|
+
```bash
|
|
480
|
+
gskills-admin content-id-aliases list --where '{"consumerInstanceId":"<instanceId>","legacyId":"<legacyId>"}' --output json
|
|
481
|
+
```
|
|
482
|
+
|
|
483
|
+
## instance-knowledge-presentations
|
|
484
|
+
|
|
485
|
+
Prisma model `InstanceKnowledgePresentation` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
486
|
+
|
|
487
|
+
**Purpose.** Consumer presentation and settings for a shared knowledge family.
|
|
488
|
+
|
|
489
|
+
**Key.** `instanceId` + `contentFamilyId`. Use list --where with instanceId, contentFamilyId. There is no scalar id for get <id>.
|
|
490
|
+
|
|
491
|
+
**Relationships.** contentFamilyId references ContentFamilyIdentity.
|
|
492
|
+
|
|
493
|
+
**Inspect it when.** Inspect categories, audience, AI permission and display dates.
|
|
494
|
+
|
|
495
|
+
**Who writes it.** Knowledge administration and guarded consolidation.
|
|
496
|
+
|
|
497
|
+
**Avoid this mistake.** Locale presentation does not create an independent language permission.
|
|
498
|
+
|
|
499
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
500
|
+
|
|
501
|
+
```bash
|
|
502
|
+
gskills-admin instance-knowledge-presentations list --where '{"instanceId":"<instanceId>"}' --output json
|
|
503
|
+
```
|
|
504
|
+
|
|
505
|
+
## instance-content-availability
|
|
506
|
+
|
|
507
|
+
Prisma model `InstanceContentAvailability` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
508
|
+
|
|
509
|
+
**Purpose.** A sparse consumer-level decision enabling or disabling an entire content family.
|
|
510
|
+
|
|
511
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
512
|
+
|
|
513
|
+
**Relationships.** instanceId is the consumer; contentFamilyId points to ContentFamilyIdentity; contentType identifies its family type.
|
|
514
|
+
|
|
515
|
+
**Inspect it when.** Explain why a family is hidden or restored for one customer.
|
|
516
|
+
|
|
517
|
+
**Who writes it.** Guarded effective-catalogue hide/restore operations and migration.
|
|
518
|
+
|
|
519
|
+
**Avoid this mistake.** Missing rows inherit the product's default rules; do not treat every absence as disabled or copy shared content into the customer.
|
|
520
|
+
|
|
521
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
522
|
+
|
|
523
|
+
```bash
|
|
524
|
+
gskills-admin instance-content-availability list --where '{"instanceId":"<instanceId>","contentFamilyId":"<familyId>"}' --output json
|
|
525
|
+
```
|
|
526
|
+
|
|
527
|
+
## instance-content-locale-availability
|
|
528
|
+
|
|
529
|
+
Prisma model `InstanceContentLocaleAvailability` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
530
|
+
|
|
531
|
+
**Purpose.** A consumer-level availability decision for one language of a content family.
|
|
532
|
+
|
|
533
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
534
|
+
|
|
535
|
+
**Relationships.** instanceId plus contentFamilyId plus locale identifies the decision; family-level availability still applies.
|
|
536
|
+
|
|
537
|
+
**Inspect it when.** Explain why a customer can use a family but not one language.
|
|
538
|
+
|
|
539
|
+
**Who writes it.** Guarded availability operations and migration.
|
|
540
|
+
|
|
541
|
+
**Avoid this mistake.** Locale enablement does not override family ownership, publication readiness or audience rules.
|
|
542
|
+
|
|
543
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
544
|
+
|
|
545
|
+
```bash
|
|
546
|
+
gskills-admin instance-content-locale-availability list --where '{"instanceId":"<instanceId>","contentFamilyId":"<familyId>"}' --output json
|
|
547
|
+
```
|
|
548
|
+
|
|
549
|
+
## instance-page-quiz-placements
|
|
550
|
+
|
|
551
|
+
Prisma model `InstancePageQuizPlacement` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
552
|
+
|
|
553
|
+
**Purpose.** The assignment of a canonical quiz family to a canonical page family for one consumer.
|
|
554
|
+
|
|
555
|
+
**Key.** `instanceId` + `pageFamilyId` + `quizFamilyId`. Use list --where with instanceId, pageFamilyId, quizFamilyId. There is no scalar id for get <id>.
|
|
556
|
+
|
|
557
|
+
**Relationships.** The composite key is instanceId, pageFamilyId and quizFamilyId; both families are ContentFamilyIdentity records.
|
|
558
|
+
|
|
559
|
+
**Inspect it when.** Find which quiz a customer should see attached to a page.
|
|
560
|
+
|
|
561
|
+
**Who writes it.** Guarded tenant-scoped quiz placement replacement and migration.
|
|
562
|
+
|
|
563
|
+
**Avoid this mistake.** This links definitions; it does not contain quiz questions or learner attempts and must not expose another customer's owned quiz.
|
|
564
|
+
|
|
565
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
566
|
+
|
|
567
|
+
```bash
|
|
568
|
+
gskills-admin instance-page-quiz-placements list --where '{"instanceId":"<instanceId>","pageFamilyId":"<pageFamilyId>"}' --output json
|
|
569
|
+
```
|
|
570
|
+
|
|
571
|
+
## instance-page-audience-policies
|
|
572
|
+
|
|
573
|
+
Prisma model `InstancePageAudiencePolicy` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
574
|
+
|
|
575
|
+
**Purpose.** The customer-specific audience policy for a page, including inheritance mode, plans and alpha programs.
|
|
576
|
+
|
|
577
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
578
|
+
|
|
579
|
+
**Relationships.** instanceId and pageId identify the policy; entity and group allowlists are child rows.
|
|
580
|
+
|
|
581
|
+
**Inspect it when.** Diagnose access differences between customers or plans for the same published page.
|
|
582
|
+
|
|
583
|
+
**Who writes it.** SavePageAudience and its guarded PageAudience repository operations, plus migration.
|
|
584
|
+
|
|
585
|
+
**Avoid this mistake.** Availability, audience and menu placement are separate checks. A menu entry does not grant access.
|
|
586
|
+
|
|
587
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
588
|
+
|
|
589
|
+
```bash
|
|
590
|
+
gskills-admin instance-page-audience-policies list --where '{"instanceId":"<instanceId>","pageId":"<pageId>"}' --output json
|
|
591
|
+
```
|
|
592
|
+
|
|
593
|
+
## instance-page-audience-entities
|
|
594
|
+
|
|
595
|
+
Prisma model `InstancePageAudienceEntity` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
596
|
+
|
|
597
|
+
**Purpose.** One entity included in a page audience policy's entity selection.
|
|
598
|
+
|
|
599
|
+
**Key.** `policyId` + `entityId`. Use list --where with policyId, entityId. There is no scalar id for get <id>.
|
|
600
|
+
|
|
601
|
+
**Relationships.** policyId points to InstancePageAudiencePolicy; entityId is the selected entity identifier.
|
|
602
|
+
|
|
603
|
+
**Inspect it when.** Trace an entity-based access decision back to its customer policy.
|
|
604
|
+
|
|
605
|
+
**Who writes it.** Guarded page audience saves replace the selected entity set; migration backfills it.
|
|
606
|
+
|
|
607
|
+
**Avoid this mistake.** Read the parent policy's mode and tenant scope. A child row alone does not explain the complete access rule.
|
|
608
|
+
|
|
609
|
+
**Scope.** --instance filters policy.instanceId. This raw filter does not compute inherited availability or effective access.
|
|
610
|
+
|
|
611
|
+
```bash
|
|
612
|
+
gskills-admin instance-page-audience-entities list --where '{"policyId":"<policyId>"}' --output json
|
|
613
|
+
```
|
|
614
|
+
|
|
615
|
+
## instance-page-audience-groups
|
|
616
|
+
|
|
617
|
+
Prisma model `InstancePageAudienceGroup` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
618
|
+
|
|
619
|
+
**Purpose.** One group included in a page audience policy's group selection.
|
|
620
|
+
|
|
621
|
+
**Key.** `policyId` + `groupId`. Use list --where with policyId, groupId. There is no scalar id for get <id>.
|
|
622
|
+
|
|
623
|
+
**Relationships.** policyId points to InstancePageAudiencePolicy; groupId identifies the selected group.
|
|
624
|
+
|
|
625
|
+
**Inspect it when.** Trace group-based access differences for a page.
|
|
626
|
+
|
|
627
|
+
**Who writes it.** Guarded page audience saves replace the selected group set; migration backfills it.
|
|
628
|
+
|
|
629
|
+
**Avoid this mistake.** This is an audience membership, not a learning-path group or menu group. Always inspect the parent policy.
|
|
630
|
+
|
|
631
|
+
**Scope.** --instance filters policy.instanceId. This raw filter does not compute inherited availability or effective access.
|
|
632
|
+
|
|
633
|
+
```bash
|
|
634
|
+
gskills-admin instance-page-audience-groups list --where '{"policyId":"<policyId>"}' --output json
|
|
635
|
+
```
|
|
636
|
+
|
|
637
|
+
## instance-page-presentation-overrides
|
|
638
|
+
|
|
639
|
+
Prisma model `InstancePagePresentationOverride` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
640
|
+
|
|
641
|
+
**Purpose.** Sparse customer-specific icon, reading-time and header-color overrides for one page language, plus compatibility identity.
|
|
642
|
+
|
|
643
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
644
|
+
|
|
645
|
+
**Relationships.** instanceId is the consumer; pageLocaleId points to PageLocale. There is no pageId column on this table.
|
|
646
|
+
|
|
647
|
+
**Inspect it when.** Explain a customer's presentation difference from the published shared page.
|
|
648
|
+
|
|
649
|
+
**Who writes it.** Guarded consumer presentation operations and migration/compatibility preservation.
|
|
650
|
+
|
|
651
|
+
**Avoid this mistake.** The has...Override flags determine inheritance. A null value alone does not tell you whether the source is inherited or deliberately cleared.
|
|
652
|
+
|
|
653
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
654
|
+
|
|
655
|
+
```bash
|
|
656
|
+
gskills-admin instance-page-presentation-overrides list --where '{"instanceId":"<instanceId>","pageLocaleId":"<pageLocaleId>"}' --output json
|
|
657
|
+
```
|
|
658
|
+
|
|
659
|
+
## instance-learning-path-presentation-overrides
|
|
660
|
+
|
|
661
|
+
Prisma model `InstanceLearningPathPresentationOverride` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
662
|
+
|
|
663
|
+
**Purpose.** Customer-specific learning-path locale presentation and optional version-bound structure retained across migration.
|
|
664
|
+
|
|
665
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
666
|
+
|
|
667
|
+
**Relationships.** canonicalFamilyId points to ContentFamilyIdentity; canonicalContentId and locale identify the canonical path language for instanceId.
|
|
668
|
+
|
|
669
|
+
**Inspect it when.** Explain a customer path name, visibility, description, badge or preserved topology that differs from its shared source.
|
|
670
|
+
|
|
671
|
+
**Who writes it.** Guarded learning-path consumer operations and migration/retirement preservation.
|
|
672
|
+
|
|
673
|
+
**Avoid this mistake.** Interpret override flags separately from values. A structureSnapshot is tied to structureSourceVersion and is not an unrestricted second source of truth.
|
|
674
|
+
|
|
675
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
676
|
+
|
|
677
|
+
```bash
|
|
678
|
+
gskills-admin instance-learning-path-presentation-overrides list --where '{"instanceId":"<instanceId>","canonicalFamilyId":"<familyId>"}' --output json
|
|
679
|
+
```
|
|
680
|
+
|
|
681
|
+
## resource-presentation-snapshots
|
|
682
|
+
|
|
683
|
+
Prisma model `InstanceResourcePresentationSnapshot` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
684
|
+
|
|
685
|
+
**Purpose.** Version-bound customer resource presentation retained when its legacy resource projection is removed.
|
|
686
|
+
|
|
687
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
688
|
+
|
|
689
|
+
**Relationships.** instanceId, canonicalFamilyId, canonicalContentId and locale identify the consumer presentation; sourceVersion binds it to the source.
|
|
690
|
+
|
|
691
|
+
**Inspect it when.** Investigate presentation or old resource identity after physical legacy retirement.
|
|
692
|
+
|
|
693
|
+
**Who writes it.** Migration and retirement presentation preservation.
|
|
694
|
+
|
|
695
|
+
**Avoid this mistake.** This is a compatibility snapshot, not the editable canonical resource definition. Its JSON must be interpreted with sourceVersion.
|
|
696
|
+
|
|
697
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
698
|
+
|
|
699
|
+
```bash
|
|
700
|
+
gskills-admin resource-presentation-snapshots list --where '{"instanceId":"<instanceId>","canonicalFamilyId":"<familyId>"}' --output json
|
|
701
|
+
```
|
|
702
|
+
|
|
703
|
+
## instance-category-presentation-snapshots
|
|
704
|
+
|
|
705
|
+
Prisma model `InstanceCategoryPresentationSnapshot` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
706
|
+
|
|
707
|
+
**Purpose.** Version-bound customer category presentation retained when its legacy category projection is removed.
|
|
708
|
+
|
|
709
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
710
|
+
|
|
711
|
+
**Relationships.** instanceId, canonicalFamilyId, canonicalContentId and locale identify the retained presentation.
|
|
712
|
+
|
|
713
|
+
**Inspect it when.** Explain a customer's category display after retirement of copied category rows.
|
|
714
|
+
|
|
715
|
+
**Who writes it.** Migration and retirement presentation preservation.
|
|
716
|
+
|
|
717
|
+
**Avoid this mistake.** A retained snapshot is not a new independently owned category and must not be edited to override future canonical versions blindly.
|
|
718
|
+
|
|
719
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
720
|
+
|
|
721
|
+
```bash
|
|
722
|
+
gskills-admin instance-category-presentation-snapshots list --where '{"instanceId":"<instanceId>","canonicalFamilyId":"<familyId>"}' --output json
|
|
723
|
+
```
|
|
724
|
+
|
|
725
|
+
## instance-page-locale-audience-overrides
|
|
726
|
+
|
|
727
|
+
Prisma model `InstancePageLocaleAudienceOverride` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
728
|
+
|
|
729
|
+
**Purpose.** The migration-preserved audience for one customer page language, including historically different plans, programs, entities and groups.
|
|
730
|
+
|
|
731
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
732
|
+
|
|
733
|
+
**Relationships.** instanceId and pageLocaleId identify the locale override; compare it with the page-wide InstancePageAudiencePolicy.
|
|
734
|
+
|
|
735
|
+
**Inspect it when.** Explain a historical language-specific audience difference after migration.
|
|
736
|
+
|
|
737
|
+
**Who writes it.** Migration audience preservation and guarded audience reconciliation.
|
|
738
|
+
|
|
739
|
+
**Avoid this mistake.** These rows preserve legacy language differences; do not collapse them into the family policy without checking whether access would widen or narrow.
|
|
740
|
+
|
|
741
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
742
|
+
|
|
743
|
+
```bash
|
|
744
|
+
gskills-admin instance-page-locale-audience-overrides list --where '{"instanceId":"<instanceId>","pageLocaleId":"<pageLocaleId>"}' --output json
|
|
745
|
+
```
|
|
746
|
+
|
|
747
|
+
## instance-menu-configurations
|
|
748
|
+
|
|
749
|
+
Prisma model `InstanceMenuConfiguration` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
750
|
+
|
|
751
|
+
**Purpose.** The selected menu mode and edit lock version for one customer.
|
|
752
|
+
|
|
753
|
+
**Key.** `instanceId`. Use list --where with instanceId. There is no scalar id for get <id>.
|
|
754
|
+
|
|
755
|
+
**Relationships.** instanceId is its primary key. Exclusions and placements supply the customer's menu overlay.
|
|
756
|
+
|
|
757
|
+
**Inspect it when.** Explain whether the customer uses inherited or custom menu behavior before examining individual nodes.
|
|
758
|
+
|
|
759
|
+
**Who writes it.** Guarded menu mode/editor operations and migration.
|
|
760
|
+
|
|
761
|
+
**Avoid this mistake.** This does not contain menu nodes. Changing mode must use the editor transition rules rather than a raw mode update.
|
|
762
|
+
|
|
763
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
764
|
+
|
|
765
|
+
```bash
|
|
766
|
+
gskills-admin instance-menu-configurations list --where '{"instanceId":"<instanceId>"}' --output json
|
|
767
|
+
```
|
|
768
|
+
|
|
769
|
+
## instance-menu-node-exclusions
|
|
770
|
+
|
|
771
|
+
Prisma model `InstanceMenuNodeExclusion` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
772
|
+
|
|
773
|
+
**Purpose.** One shared menu node intentionally hidden for a customer.
|
|
774
|
+
|
|
775
|
+
**Key.** `instanceId` + `nodeType` + `globalNodeId`. Use list --where with instanceId, nodeType, globalNodeId. There is no scalar id for get <id>.
|
|
776
|
+
|
|
777
|
+
**Relationships.** The key combines instanceId, nodeType and globalNodeId; the shared node itself remains intact.
|
|
778
|
+
|
|
779
|
+
**Inspect it when.** Explain why a shared section or item is absent from a customer's effective menu.
|
|
780
|
+
|
|
781
|
+
**Who writes it.** Guarded menu overlay operations and migration.
|
|
782
|
+
|
|
783
|
+
**Avoid this mistake.** Excluding a menu node neither deletes shared content nor necessarily revokes direct access to its page.
|
|
784
|
+
|
|
785
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
786
|
+
|
|
787
|
+
```bash
|
|
788
|
+
gskills-admin instance-menu-node-exclusions list --where '{"instanceId":"<instanceId>","globalNodeId":"<globalNodeId>"}' --output json
|
|
789
|
+
```
|
|
790
|
+
|
|
791
|
+
## instance-menu-placements
|
|
792
|
+
|
|
793
|
+
Prisma model `InstanceMenuPlacement` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
794
|
+
|
|
795
|
+
**Purpose.** The position of a customer-local menu node relative to parent/before/after anchors in a menu mode.
|
|
796
|
+
|
|
797
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
798
|
+
|
|
799
|
+
**Relationships.** localNodeType/localNodeId identify the local node; anchor IDs and modeContext describe where it belongs for instanceId.
|
|
800
|
+
|
|
801
|
+
**Inspect it when.** Diagnose misplaced custom entries, missing anchors or warningCode values.
|
|
802
|
+
|
|
803
|
+
**Who writes it.** Guarded menu placement/editor operations and migration.
|
|
804
|
+
|
|
805
|
+
**Avoid this mistake.** Anchors and modeContext matter together. An orphaned anchor cannot be repaired by assuming a matching display label is the same node.
|
|
806
|
+
|
|
807
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
808
|
+
|
|
809
|
+
```bash
|
|
810
|
+
gskills-admin instance-menu-placements list --where '{"instanceId":"<instanceId>","localNodeId":"<localNodeId>"}' --output json
|
|
811
|
+
```
|
|
812
|
+
|
|
813
|
+
## menu-section-category-links
|
|
814
|
+
|
|
815
|
+
Prisma model `MenuSectionCategoryLink` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
816
|
+
|
|
817
|
+
**Purpose.** The explicit canonical category target of a menu section.
|
|
818
|
+
|
|
819
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
820
|
+
|
|
821
|
+
**Relationships.** menuSectionId identifies the section; categoryFamilyId identifies ContentFamilyIdentity for the category.
|
|
822
|
+
|
|
823
|
+
**Inspect it when.** Explain which category supplies a section's content when labels are similar or renamed.
|
|
824
|
+
|
|
825
|
+
**Who writes it.** Guarded menu definition/category-link operations and migration.
|
|
826
|
+
|
|
827
|
+
**Avoid this mistake.** Canonical readers use this identity link, not a label comparison. Renaming a section should not retarget its category.
|
|
828
|
+
|
|
829
|
+
**Scope.** This resource has no --instance filter. Use the documented key/relationship fields in --where to locate the intended scope.
|
|
830
|
+
|
|
831
|
+
```bash
|
|
832
|
+
gskills-admin menu-section-category-links list --where '{"menuSectionId":"<menuSectionId>"}' --output json
|
|
833
|
+
```
|
|
834
|
+
|
|
835
|
+
## content-assets
|
|
836
|
+
|
|
837
|
+
Prisma model `ContentAsset` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
838
|
+
|
|
839
|
+
**Purpose.** The owned storage asset behind content media, independent of disposable legacy rows.
|
|
840
|
+
|
|
841
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
842
|
+
|
|
843
|
+
**Relationships.** contentFamilyId points to ContentFamilyIdentity; ContentAssetReference tracks uses; storageKey identifies the stored object.
|
|
844
|
+
|
|
845
|
+
**Inspect it when.** Investigate media ownership, retained shared files or pending/deleted storage state.
|
|
846
|
+
|
|
847
|
+
**Who writes it.** Content asset lifecycle operations and migration asset inventory, with reference-aware deletion handling.
|
|
848
|
+
|
|
849
|
+
**Avoid this mistake.** Removing a customer's availability or legacy row must not delete media still used by shared content or another reference.
|
|
850
|
+
|
|
851
|
+
**Scope.** --instance filters ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
852
|
+
|
|
853
|
+
```bash
|
|
854
|
+
gskills-admin content-assets list --where '{"contentFamilyId":"<familyId>"}' --output json
|
|
855
|
+
```
|
|
856
|
+
|
|
857
|
+
## content-asset-references
|
|
858
|
+
|
|
859
|
+
Prisma model `ContentAssetReference` in `prisma/schema/Content/ContentInheritance.prisma`.
|
|
860
|
+
|
|
861
|
+
**Purpose.** One recorded use of a storage asset by a typed content reference.
|
|
862
|
+
|
|
863
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
864
|
+
|
|
865
|
+
**Relationships.** assetId points to ContentAsset; referenceType and referenceId identify the consumer of that asset.
|
|
866
|
+
|
|
867
|
+
**Inspect it when.** Find why an asset must be retained or trace an unexpected media dependency.
|
|
868
|
+
|
|
869
|
+
**Who writes it.** Asset reference tracking during content/migration operations.
|
|
870
|
+
|
|
871
|
+
**Avoid this mistake.** referenceId is polymorphic; interpret referenceType before looking it up. Deleting a reference is not an authorized file deletion.
|
|
872
|
+
|
|
873
|
+
**Scope.** --instance filters asset.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
874
|
+
|
|
875
|
+
```bash
|
|
876
|
+
gskills-admin content-asset-references list --where '{"assetId":"<assetId>"}' --output json
|
|
877
|
+
```
|
|
878
|
+
|
|
879
|
+
## content-migration-states
|
|
880
|
+
|
|
881
|
+
Prisma model `ContentMigrationState` in `prisma/schema/Operations/ContentPlatformMigration.prisma`.
|
|
882
|
+
|
|
883
|
+
**Purpose.** The authority and retirement fence for one consumer and content family type.
|
|
884
|
+
|
|
885
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
886
|
+
|
|
887
|
+
**Relationships.** instanceId plus contentType identify the scope; page-specific authority is tracked separately in PageMigrationState.
|
|
888
|
+
|
|
889
|
+
**Inspect it when.** Decide whether legacy or canonical reads/writes are permitted and whether retirement or draining is active.
|
|
890
|
+
|
|
891
|
+
**Who writes it.** The fenced migration, cutover, recovery and retirement orchestrators.
|
|
892
|
+
|
|
893
|
+
**Avoid this mistake.** Table presence or a completed backfill does not grant canonical authority. PRESENT does not imply LEGACY_PRIMARY; never manually flip these fields.
|
|
894
|
+
|
|
895
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
896
|
+
|
|
897
|
+
```bash
|
|
898
|
+
gskills-admin content-migration-states list --where '{"instanceId":"<instanceId>"}' --output json
|
|
899
|
+
```
|
|
900
|
+
|
|
901
|
+
## page-migration-states
|
|
902
|
+
|
|
903
|
+
Prisma model `PageMigrationState` in `prisma/schema/Operations/ContentPlatformMigration.prisma`.
|
|
904
|
+
|
|
905
|
+
**Purpose.** The authority and retirement fence for one canonical page where authoring changes independently of the customer catalogue.
|
|
906
|
+
|
|
907
|
+
**Key.** `pageId`. Use list --where with pageId. There is no scalar id for get <id>.
|
|
908
|
+
|
|
909
|
+
**Relationships.** pageId is the primary key and identifies Page; compare with the relevant ContentMigrationState consumer/type scope.
|
|
910
|
+
|
|
911
|
+
**Inspect it when.** Explain why a particular page rejects a legacy write or is still in a transition.
|
|
912
|
+
|
|
913
|
+
**Who writes it.** Fenced page migration/cutover and retirement operations.
|
|
914
|
+
|
|
915
|
+
**Avoid this mistake.** This is a page-wide fence with no instanceId field. Use list --where by pageId, not get or a guessed customer filter.
|
|
916
|
+
|
|
917
|
+
**Scope.** This resource has no --instance filter. Use the documented key/relationship fields in --where to locate the intended scope.
|
|
918
|
+
|
|
919
|
+
```bash
|
|
920
|
+
gskills-admin page-migration-states list --where '{"pageId":"<pageId>"}' --output json
|
|
921
|
+
```
|
|
922
|
+
|
|
923
|
+
## content-scope-versions
|
|
924
|
+
|
|
925
|
+
Prisma model `ContentScopeVersion` in `prisma/schema/Operations/ContentPlatformMigration.prisma`.
|
|
926
|
+
|
|
927
|
+
**Purpose.** A version counter used to form canonical cache keys for a shared source or customer overlay.
|
|
928
|
+
|
|
929
|
+
**Key.** `scopeKey` + `contentType` + `cacheScope`. Use list --where with scopeKey, contentType, cacheScope. There is no scalar id for get <id>.
|
|
930
|
+
|
|
931
|
+
**Relationships.** scopeKey, contentType and cacheScope form its key; instanceId distinguishes an instance scope when present.
|
|
932
|
+
|
|
933
|
+
**Inspect it when.** Investigate stale effective catalogue/cache behavior after publication or a customer override.
|
|
934
|
+
|
|
935
|
+
**Who writes it.** Guarded publication and overlay transactions increment their affected scope versions.
|
|
936
|
+
|
|
937
|
+
**Avoid this mistake.** Incrementing a counter by hand does not publish content or fix missing outbox processing; inspect the originating operation.
|
|
938
|
+
|
|
939
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
940
|
+
|
|
941
|
+
```bash
|
|
942
|
+
gskills-admin content-scope-versions list --where '{"instanceId":"<instanceId>","scopeKey":"<scopeKey>"}' --output json
|
|
943
|
+
```
|
|
944
|
+
|
|
945
|
+
## content-projection-outbox-events
|
|
946
|
+
|
|
947
|
+
Prisma model `ContentProjectionOutboxEvent` in `prisma/schema/Operations/ContentPlatformMigration.prisma`.
|
|
948
|
+
|
|
949
|
+
**Purpose.** A durable job describing a versioned public-state change that compatibility processing must apply.
|
|
950
|
+
|
|
951
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
952
|
+
|
|
953
|
+
**Relationships.** canonicalFamilyId identifies the family; consumerInstanceId can narrow the target; publicStateVersion and authorityEpoch fence execution.
|
|
954
|
+
|
|
955
|
+
**Inspect it when.** Investigate pending/failed mirror work, retries and lastError after a canonical public-state change.
|
|
956
|
+
|
|
957
|
+
**Who writes it.** Canonical public-state transactions enqueue events; projection workers claim and complete them.
|
|
958
|
+
|
|
959
|
+
**Avoid this mistake.** A draft save is not a public-state event. Replaying an old version or changing status manually can break ordering and retirement fences.
|
|
960
|
+
|
|
961
|
+
**Scope.** --instance filters consumerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
962
|
+
|
|
963
|
+
```bash
|
|
964
|
+
gskills-admin content-projection-outbox-events list --where '{"consumerInstanceId":"<instanceId>","canonicalFamilyId":"<familyId>"}' --output json
|
|
965
|
+
```
|
|
966
|
+
|
|
967
|
+
## content-legacy-projection-states
|
|
968
|
+
|
|
969
|
+
Prisma model `ContentLegacyProjectionState` in `prisma/schema/Operations/ContentPlatformMigration.prisma`.
|
|
970
|
+
|
|
971
|
+
**Purpose.** The last verified complete compatibility projection for a family, consumer and locale.
|
|
972
|
+
|
|
973
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
974
|
+
|
|
975
|
+
**Relationships.** Its scope uses contentType, canonicalFamilyId, consumerInstanceId and localeKey; it records the applied version and epoch.
|
|
976
|
+
|
|
977
|
+
**Inspect it when.** Check whether a legacy mirror is complete enough for coexistence or rollback.
|
|
978
|
+
|
|
979
|
+
**Who writes it.** Compatibility projection workers and parity verification.
|
|
980
|
+
|
|
981
|
+
**Avoid this mistake.** This describes the mirror, not canonical publication. complete must be interpreted with versions, verification time and the retirement state.
|
|
982
|
+
|
|
983
|
+
**Scope.** --instance filters consumerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
984
|
+
|
|
985
|
+
```bash
|
|
986
|
+
gskills-admin content-legacy-projection-states list --where '{"consumerInstanceId":"<instanceId>","canonicalFamilyId":"<familyId>"}' --output json
|
|
987
|
+
```
|
|
988
|
+
|
|
989
|
+
## content-migration-runs
|
|
990
|
+
|
|
991
|
+
Prisma model `ContentMigrationRun` in `prisma/schema/Operations/ContentPlatformMigration.prisma`.
|
|
992
|
+
|
|
993
|
+
**Purpose.** One durable invocation of a migration phase, with dry-run/apply mode, status, summaries and invariants.
|
|
994
|
+
|
|
995
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
996
|
+
|
|
997
|
+
**Relationships.** Its id is referenced by ContentMigrationCheckpoint and ContentMigrationLease and by issue/ledger run fields.
|
|
998
|
+
|
|
999
|
+
**Inspect it when.** Find what a run attempted, whether it only previewed changes, and why it failed or completed partially.
|
|
1000
|
+
|
|
1001
|
+
**Who writes it.** The reviewed idempotent migration orchestrator.
|
|
1002
|
+
|
|
1003
|
+
**Avoid this mistake.** COMPLETED for one run/phase is not proof the whole platform is migrated. Read mode, phase, scope, invariants and follow-up verification.
|
|
1004
|
+
|
|
1005
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
1006
|
+
|
|
1007
|
+
```bash
|
|
1008
|
+
gskills-admin content-migration-runs list --where '{"instanceId":"<instanceId>","id":"<runId>"}' --output json
|
|
1009
|
+
```
|
|
1010
|
+
|
|
1011
|
+
## content-migration-leases
|
|
1012
|
+
|
|
1013
|
+
Prisma model `ContentMigrationLease` in `prisma/schema/Operations/ContentPlatformMigration.prisma`.
|
|
1014
|
+
|
|
1015
|
+
**Purpose.** The scope-wide lock preventing competing migration apply runs, including runs with different IDs.
|
|
1016
|
+
|
|
1017
|
+
**Key.** `scopeKey`. Use list --where with scopeKey. There is no scalar id for get <id>.
|
|
1018
|
+
|
|
1019
|
+
**Relationships.** scopeKey is the primary key; runId links to ContentMigrationRun; lease token and expiry fence its holder.
|
|
1020
|
+
|
|
1021
|
+
**Inspect it when.** Explain a migration-busy response or investigate whether a run is still holding its lease.
|
|
1022
|
+
|
|
1023
|
+
**Who writes it.** Migration lease acquisition, heartbeat, fenced recovery and release.
|
|
1024
|
+
|
|
1025
|
+
**Avoid this mistake.** Never delete a lease merely because a process looks idle. Expiry and fenced recovery must be checked together.
|
|
1026
|
+
|
|
1027
|
+
**Scope.** This resource has no --instance filter. Use the documented key/relationship fields in --where to locate the intended scope.
|
|
1028
|
+
|
|
1029
|
+
```bash
|
|
1030
|
+
gskills-admin content-migration-leases list --where '{"scopeKey":"<scopeKey>"}' --output json
|
|
1031
|
+
```
|
|
1032
|
+
|
|
1033
|
+
## content-migration-checkpoints
|
|
1034
|
+
|
|
1035
|
+
Prisma model `ContentMigrationCheckpoint` in `prisma/schema/Operations/ContentPlatformMigration.prisma`.
|
|
1036
|
+
|
|
1037
|
+
**Purpose.** The resumable cursor and counters for one scope inside a migration run.
|
|
1038
|
+
|
|
1039
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1040
|
+
|
|
1041
|
+
**Relationships.** runId points to ContentMigrationRun; runId plus scopeKey identify the checkpoint.
|
|
1042
|
+
|
|
1043
|
+
**Inspect it when.** Locate stalled progress, scanned/written/skipped counts, issues and the last completed cursor.
|
|
1044
|
+
|
|
1045
|
+
**Who writes it.** The migration runner saves checkpoints as bounded batches complete.
|
|
1046
|
+
|
|
1047
|
+
**Avoid this mistake.** Counters are operational progress, not proof of semantic correctness. Reconciliation and invariant checks supply that proof.
|
|
1048
|
+
|
|
1049
|
+
**Scope.** --instance filters run.instanceId. This raw filter does not compute inherited availability or effective access.
|
|
1050
|
+
|
|
1051
|
+
```bash
|
|
1052
|
+
gskills-admin content-migration-checkpoints list --where '{"runId":"<runId>"}' --output json
|
|
1053
|
+
```
|
|
1054
|
+
|
|
1055
|
+
## content-migration-issues
|
|
1056
|
+
|
|
1057
|
+
Prisma model `ContentMigrationIssue` in `prisma/schema/Operations/ContentPlatformMigration.prisma`.
|
|
1058
|
+
|
|
1059
|
+
**Purpose.** A persistent ambiguity or error discovered by migration, with first/last seen runs and resolution status.
|
|
1060
|
+
|
|
1061
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1062
|
+
|
|
1063
|
+
**Relationships.** issueKey deduplicates the finding; instanceId, contentType and legacyId identify the affected scope and record.
|
|
1064
|
+
|
|
1065
|
+
**Inspect it when.** Read unresolved blockers and their details before retrying cutover or retirement.
|
|
1066
|
+
|
|
1067
|
+
**Who writes it.** Migration diagnostics and the reviewed issue-resolution/reconciliation flow.
|
|
1068
|
+
|
|
1069
|
+
**Avoid this mistake.** Setting status to RESOLVED would not repair the underlying data. Fix the cause and rerun the relevant verification.
|
|
1070
|
+
|
|
1071
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
1072
|
+
|
|
1073
|
+
```bash
|
|
1074
|
+
gskills-admin content-migration-issues list --where '{"instanceId":"<instanceId>","lastRunId":"<runId>"}' --output json
|
|
1075
|
+
```
|
|
1076
|
+
|
|
1077
|
+
## content-reconciliation-ledgers
|
|
1078
|
+
|
|
1079
|
+
Prisma model `ContentReconciliationLedger` in `prisma/schema/Operations/ContentPlatformMigration.prisma`.
|
|
1080
|
+
|
|
1081
|
+
**Purpose.** The per-record evidence of how legacy data mapped, merged, was skipped or quarantined, including preserved invariants.
|
|
1082
|
+
|
|
1083
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1084
|
+
|
|
1085
|
+
**Relationships.** recordType and legacyRecordId identify the input; canonicalRecordId, canonicalFamilyId and survivorLegacyId explain its outcome.
|
|
1086
|
+
|
|
1087
|
+
**Inspect it when.** Prove that progress, attempts, rewards or other durable records survived a many-to-one migration.
|
|
1088
|
+
|
|
1089
|
+
**Who writes it.** Migration mapping/reconciliation batches and verification.
|
|
1090
|
+
|
|
1091
|
+
**Avoid this mistake.** Unequal row counts may be valid for approved merges. Judge the recorded disposition, digests and invariants, not counts alone.
|
|
1092
|
+
|
|
1093
|
+
**Scope.** --instance filters consumerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1094
|
+
|
|
1095
|
+
```bash
|
|
1096
|
+
gskills-admin content-reconciliation-ledgers list --where '{"consumerInstanceId":"<instanceId>","lastRunId":"<runId>"}' --output json
|
|
1097
|
+
```
|
|
1098
|
+
|
|
1099
|
+
## workflow-definitions
|
|
1100
|
+
|
|
1101
|
+
Prisma model `WorkflowDefinition` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1102
|
+
|
|
1103
|
+
**Purpose.** The stable identity and owner of an automation, with draft and published revision pointers.
|
|
1104
|
+
|
|
1105
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1106
|
+
|
|
1107
|
+
**Relationships.** WorkflowRevision belongs to this definition; InstanceWorkflowActivation selects what each customer actually runs.
|
|
1108
|
+
|
|
1109
|
+
**Inspect it when.** Find the definition's latest published version separately from customer activation pins.
|
|
1110
|
+
|
|
1111
|
+
**Who writes it.** Guarded workflow definition creation, draft/publication/archive/restore operations and migration.
|
|
1112
|
+
|
|
1113
|
+
**Avoid this mistake.** Publishing a shared definition does not activate it for customers or move their pinned versions.
|
|
1114
|
+
|
|
1115
|
+
**Scope.** --instance filters ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1116
|
+
|
|
1117
|
+
```bash
|
|
1118
|
+
gskills-admin workflow-definitions list --where '{"id":"<definitionId>"}' --output json
|
|
1119
|
+
```
|
|
1120
|
+
|
|
1121
|
+
## workflow-revisions
|
|
1122
|
+
|
|
1123
|
+
Prisma model `WorkflowRevision` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1124
|
+
|
|
1125
|
+
**Purpose.** One draft or published automation version containing portable trigger settings and revision actions.
|
|
1126
|
+
|
|
1127
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1128
|
+
|
|
1129
|
+
**Relationships.** definitionId points to WorkflowDefinition; WorkflowRevisionAction contains its actions; activations may pin this revision.
|
|
1130
|
+
|
|
1131
|
+
**Inspect it when.** Compare a draft or newly published version with the version a customer currently runs.
|
|
1132
|
+
|
|
1133
|
+
**Who writes it.** Guarded workflow draft save/publication/restore operations and migration.
|
|
1134
|
+
|
|
1135
|
+
**Avoid this mistake.** portableTriggerConfig is not the customer's resolved trigger binding. Inspect the activation for tenant-specific configuration.
|
|
1136
|
+
|
|
1137
|
+
**Scope.** --instance filters definition.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1138
|
+
|
|
1139
|
+
```bash
|
|
1140
|
+
gskills-admin workflow-revisions list --where '{"definitionId":"<definitionId>"}' --output json
|
|
1141
|
+
```
|
|
1142
|
+
|
|
1143
|
+
## workflow-action-identities
|
|
1144
|
+
|
|
1145
|
+
Prisma model `WorkflowActionIdentity` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1146
|
+
|
|
1147
|
+
**Purpose.** The durable identity of an action across automation revisions.
|
|
1148
|
+
|
|
1149
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1150
|
+
|
|
1151
|
+
**Relationships.** definitionId points to WorkflowDefinition; WorkflowRevisionAction provides versioned content and InstanceWorkflowActionBinding provides customer values.
|
|
1152
|
+
|
|
1153
|
+
**Inspect it when.** Track one action's history or understand how bindings survive a new definition version.
|
|
1154
|
+
|
|
1155
|
+
**Who writes it.** Guarded workflow action editing/revision cloning and migration.
|
|
1156
|
+
|
|
1157
|
+
**Avoid this mistake.** An action's order is not its identity. Reordering must not create a different identity or move another action's bindings.
|
|
1158
|
+
|
|
1159
|
+
**Scope.** --instance filters definition.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1160
|
+
|
|
1161
|
+
```bash
|
|
1162
|
+
gskills-admin workflow-action-identities list --where '{"definitionId":"<definitionId>"}' --output json
|
|
1163
|
+
```
|
|
1164
|
+
|
|
1165
|
+
## workflow-revision-actions
|
|
1166
|
+
|
|
1167
|
+
Prisma model `WorkflowRevisionAction` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1168
|
+
|
|
1169
|
+
**Purpose.** The ordered portable action definition stored in one workflow revision.
|
|
1170
|
+
|
|
1171
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1172
|
+
|
|
1173
|
+
**Relationships.** revisionId points to WorkflowRevision; actionIdentityId points to WorkflowActionIdentity.
|
|
1174
|
+
|
|
1175
|
+
**Inspect it when.** Inspect exactly which action type/configuration a pinned revision contains.
|
|
1176
|
+
|
|
1177
|
+
**Who writes it.** Guarded workflow revision editing and publication, plus migration.
|
|
1178
|
+
|
|
1179
|
+
**Avoid this mistake.** portableConfig must be combined with validated customer bindings; do not infer executable tenant configuration from this row alone.
|
|
1180
|
+
|
|
1181
|
+
**Scope.** --instance filters revision.definition.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1182
|
+
|
|
1183
|
+
```bash
|
|
1184
|
+
gskills-admin workflow-revision-actions list --where '{"revisionId":"<revisionId>"}' --output json
|
|
1185
|
+
```
|
|
1186
|
+
|
|
1187
|
+
## instance-workflow-activations
|
|
1188
|
+
|
|
1189
|
+
Prisma model `InstanceWorkflowActivation` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1190
|
+
|
|
1191
|
+
**Purpose.** The customer decision to enable an automation and pin a particular published revision, with trigger bindings and readiness.
|
|
1192
|
+
|
|
1193
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1194
|
+
|
|
1195
|
+
**Relationships.** instanceId plus definitionId identify the activation; pinnedRevisionId points to WorkflowRevision.
|
|
1196
|
+
|
|
1197
|
+
**Inspect it when.** Explain why a customer runs an older version, cannot activate a workflow, or has an incomplete binding.
|
|
1198
|
+
|
|
1199
|
+
**Who writes it.** Guarded activation/binding operations and explicit ApplyWorkflowRollout; migration seeds existing activations.
|
|
1200
|
+
|
|
1201
|
+
**Avoid this mistake.** The definition's newest published revision is not automatically the active revision. Check enabled, pin, bindingStatus and deletion state.
|
|
1202
|
+
|
|
1203
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
1204
|
+
|
|
1205
|
+
```bash
|
|
1206
|
+
gskills-admin instance-workflow-activations list --where '{"instanceId":"<instanceId>","definitionId":"<definitionId>"}' --output json
|
|
1207
|
+
```
|
|
1208
|
+
|
|
1209
|
+
## instance-workflow-action-bindings
|
|
1210
|
+
|
|
1211
|
+
Prisma model `InstanceWorkflowActionBinding` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1212
|
+
|
|
1213
|
+
**Purpose.** The customer's concrete configuration for one durable workflow action.
|
|
1214
|
+
|
|
1215
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1216
|
+
|
|
1217
|
+
**Relationships.** activationId points to InstanceWorkflowActivation; actionIdentityId points to WorkflowActionIdentity.
|
|
1218
|
+
|
|
1219
|
+
**Inspect it when.** Diagnose an invalid recipient, missing customer reference or binding validation failure.
|
|
1220
|
+
|
|
1221
|
+
**Who writes it.** Guarded workflow customer binding validation/save operations and migration.
|
|
1222
|
+
|
|
1223
|
+
**Avoid this mistake.** Do not put tenant-specific values into the shared revision action. Read status and validationReason before expecting execution.
|
|
1224
|
+
|
|
1225
|
+
**Scope.** --instance filters activation.instanceId. This raw filter does not compute inherited availability or effective access.
|
|
1226
|
+
|
|
1227
|
+
```bash
|
|
1228
|
+
gskills-admin instance-workflow-action-bindings list --where '{"activationId":"<activationId>"}' --output json
|
|
1229
|
+
```
|
|
1230
|
+
|
|
1231
|
+
## legacy-workflow-aliases
|
|
1232
|
+
|
|
1233
|
+
Prisma model `LegacyWorkflowAlias` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1234
|
+
|
|
1235
|
+
**Purpose.** The durable mapping from a legacy workflow row to a definition and optional customer activation.
|
|
1236
|
+
|
|
1237
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1238
|
+
|
|
1239
|
+
**Relationships.** legacyWorkflowId resolves to definitionId and activationId for instanceId.
|
|
1240
|
+
|
|
1241
|
+
**Inspect it when.** Follow an old workflow ID after migration or retirement of compatibility rows.
|
|
1242
|
+
|
|
1243
|
+
**Who writes it.** Workflow migration/compatibility mapping and retirement tombstone updates.
|
|
1244
|
+
|
|
1245
|
+
**Avoid this mistake.** projectionRetiredAt does not invalidate the alias. Do not recreate a deleted Workflow row to make an old ID resolvable.
|
|
1246
|
+
|
|
1247
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
1248
|
+
|
|
1249
|
+
```bash
|
|
1250
|
+
gskills-admin legacy-workflow-aliases list --where '{"instanceId":"<instanceId>","legacyWorkflowId":"<legacyWorkflowId>"}' --output json
|
|
1251
|
+
```
|
|
1252
|
+
|
|
1253
|
+
## legacy-workflow-action-aliases
|
|
1254
|
+
|
|
1255
|
+
Prisma model `LegacyWorkflowActionAlias` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1256
|
+
|
|
1257
|
+
**Purpose.** The durable mapping from an old workflow action to its canonical action identity for a customer.
|
|
1258
|
+
|
|
1259
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1260
|
+
|
|
1261
|
+
**Relationships.** legacyActionId resolves to WorkflowActionIdentity.id via actionIdentityId and instanceId.
|
|
1262
|
+
|
|
1263
|
+
**Inspect it when.** Trace old action references or execution history after action-row retirement.
|
|
1264
|
+
|
|
1265
|
+
**Who writes it.** Workflow migration/compatibility mapping and retirement tombstone updates.
|
|
1266
|
+
|
|
1267
|
+
**Avoid this mistake.** An old action ID maps to stable identity, not directly to a particular revision's action payload.
|
|
1268
|
+
|
|
1269
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
1270
|
+
|
|
1271
|
+
```bash
|
|
1272
|
+
gskills-admin legacy-workflow-action-aliases list --where '{"instanceId":"<instanceId>","legacyActionId":"<legacyActionId>"}' --output json
|
|
1273
|
+
```
|
|
1274
|
+
|
|
1275
|
+
## workflow-rollout-events
|
|
1276
|
+
|
|
1277
|
+
Prisma model `WorkflowRolloutEvent` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1278
|
+
|
|
1279
|
+
**Purpose.** The per-customer record of an explicit attempt to move an activation from one revision to another.
|
|
1280
|
+
|
|
1281
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1282
|
+
|
|
1283
|
+
**Relationships.** definitionId, activationId and instanceId identify the target; previousRevisionId and targetRevisionId record the move.
|
|
1284
|
+
|
|
1285
|
+
**Inspect it when.** Audit rollout success/failure, validationDetails and retries for one customer.
|
|
1286
|
+
|
|
1287
|
+
**Who writes it.** Explicit guarded workflow rollout preview/apply operations create/update rollout outcomes.
|
|
1288
|
+
|
|
1289
|
+
**Avoid this mistake.** A published revision is merely available; only a successful authorized rollout/activation change moves a customer's pin.
|
|
1290
|
+
|
|
1291
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
1292
|
+
|
|
1293
|
+
```bash
|
|
1294
|
+
gskills-admin workflow-rollout-events list --where '{"instanceId":"<instanceId>","definitionId":"<definitionId>"}' --output json
|
|
1295
|
+
```
|
|
1296
|
+
|
|
1297
|
+
## workflow-engine-leases
|
|
1298
|
+
|
|
1299
|
+
Prisma model `WorkflowEngineLease` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1300
|
+
|
|
1301
|
+
**Purpose.** The per-customer fence deciding which workflow engine generation may execute actions.
|
|
1302
|
+
|
|
1303
|
+
**Key.** `instanceId`. Use list --where with instanceId. There is no scalar id for get <id>.
|
|
1304
|
+
|
|
1305
|
+
**Relationships.** instanceId is the primary key; engineKind, generation, state and activeClaims describe execution authority.
|
|
1306
|
+
|
|
1307
|
+
**Inspect it when.** Diagnose draining during engine cutover or why an older queued job is skipped.
|
|
1308
|
+
|
|
1309
|
+
**Who writes it.** The workflow runtime claim/drain/engine-transition protocol.
|
|
1310
|
+
|
|
1311
|
+
**Avoid this mistake.** This is not ContentMigrationLease. It controls workflow execution, and manually resetting generation could allow duplicate side effects.
|
|
1312
|
+
|
|
1313
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
1314
|
+
|
|
1315
|
+
```bash
|
|
1316
|
+
gskills-admin workflow-engine-leases list --where '{"instanceId":"<instanceId>"}' --output json
|
|
1317
|
+
```
|
|
1318
|
+
|
|
1319
|
+
## workflow-execution-attempts
|
|
1320
|
+
|
|
1321
|
+
Prisma model `WorkflowExecutionAttempt` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1322
|
+
|
|
1323
|
+
**Purpose.** One runtime attempt to carry out an existing workflow execution, including retries and errors.
|
|
1324
|
+
|
|
1325
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1326
|
+
|
|
1327
|
+
**Relationships.** executionId points to WorkflowExecution; executionId plus attempt identify the try.
|
|
1328
|
+
|
|
1329
|
+
**Inspect it when.** Explain why an execution retried, failed or is still pending and inspect its result/error.
|
|
1330
|
+
|
|
1331
|
+
**Who writes it.** The workflow execution runner and retry/claim protocol.
|
|
1332
|
+
|
|
1333
|
+
**Avoid this mistake.** Several attempts can belong to one execution. A failed attempt does not automatically mean the final execution failed.
|
|
1334
|
+
|
|
1335
|
+
**Scope.** --instance filters execution.consumerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1336
|
+
|
|
1337
|
+
```bash
|
|
1338
|
+
gskills-admin workflow-execution-attempts list --where '{"executionId":"<executionId>"}' --output json
|
|
1339
|
+
```
|
|
1340
|
+
|
|
1341
|
+
## workflow-execution-dedupe-claims
|
|
1342
|
+
|
|
1343
|
+
Prisma model `WorkflowExecutionDedupeClaim` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1344
|
+
|
|
1345
|
+
**Purpose.** The atomic reservation ensuring one customer event dedupe key is assigned to one workflow execution.
|
|
1346
|
+
|
|
1347
|
+
**Key.** `consumerInstanceId` + `canonicalDedupeKey`. Use list --where with consumerInstanceId, canonicalDedupeKey. There is no scalar id for get <id>.
|
|
1348
|
+
|
|
1349
|
+
**Relationships.** The key combines consumerInstanceId and canonicalDedupeKey; executionId points to WorkflowExecution.
|
|
1350
|
+
|
|
1351
|
+
**Inspect it when.** Explain why a repeated event was not executed twice, including during engine migration.
|
|
1352
|
+
|
|
1353
|
+
**Who writes it.** The workflow runtime's tenant-scoped atomic execution claim.
|
|
1354
|
+
|
|
1355
|
+
**Avoid this mistake.** Never delete a claim to retry an action; that can repeat external side effects. Diagnose the linked execution and its attempts.
|
|
1356
|
+
|
|
1357
|
+
**Scope.** --instance filters consumerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1358
|
+
|
|
1359
|
+
```bash
|
|
1360
|
+
gskills-admin workflow-execution-dedupe-claims list --where '{"consumerInstanceId":"<instanceId>","canonicalDedupeKey":"<canonicalDedupeKey>"}' --output json
|
|
1361
|
+
```
|
|
1362
|
+
|
|
1363
|
+
## workflow-definition-events
|
|
1364
|
+
|
|
1365
|
+
Prisma model `WorkflowDefinitionEvent` in `prisma/schema/Automation/WorkflowPlatform.prisma`.
|
|
1366
|
+
|
|
1367
|
+
**Purpose.** The audit trail of definition/revision lifecycle operations, optionally scoped to an instance.
|
|
1368
|
+
|
|
1369
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1370
|
+
|
|
1371
|
+
**Relationships.** definitionId points to WorkflowDefinition; revisionId optionally points to WorkflowRevision.
|
|
1372
|
+
|
|
1373
|
+
**Inspect it when.** Find the actor and recorded lifecycle event behind a changed automation definition.
|
|
1374
|
+
|
|
1375
|
+
**Who writes it.** Guarded workflow definition operations record events with their transactions.
|
|
1376
|
+
|
|
1377
|
+
**Avoid this mistake.** This is different from a runtime execution attempt and from the per-customer rollout result.
|
|
1378
|
+
|
|
1379
|
+
**Scope.** --instance filters instanceId. This raw filter does not compute inherited availability or effective access.
|
|
1380
|
+
|
|
1381
|
+
```bash
|
|
1382
|
+
gskills-admin workflow-definition-events list --where '{"instanceId":"<instanceId>","definitionId":"<definitionId>"}' --output json
|
|
1383
|
+
```
|
|
1384
|
+
|
|
1385
|
+
## quiz-family-states
|
|
1386
|
+
|
|
1387
|
+
Prisma model `QuizFamilyState` in `prisma/schema/Learning/QuizRevision.prisma`.
|
|
1388
|
+
|
|
1389
|
+
**Purpose.** The stable quiz family state and current immutable published quiz revision pointer.
|
|
1390
|
+
|
|
1391
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1392
|
+
|
|
1393
|
+
**Relationships.** id is ContentFamilyIdentity.id; locales, question identities and QuizRevision records belong to this family.
|
|
1394
|
+
|
|
1395
|
+
**Inspect it when.** Find the quiz version learners should receive and whether the family is archived.
|
|
1396
|
+
|
|
1397
|
+
**Who writes it.** Guarded quiz revision publication/archive operations and migration.
|
|
1398
|
+
|
|
1399
|
+
**Avoid this mistake.** Unlike PageRevision, QuizRevision is a published snapshot model; do not invent a quiz draft pointer on this table.
|
|
1400
|
+
|
|
1401
|
+
**Scope.** --instance filters family.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1402
|
+
|
|
1403
|
+
```bash
|
|
1404
|
+
gskills-admin quiz-family-states list --where '{"id":"<quizFamilyId>"}' --output json
|
|
1405
|
+
```
|
|
1406
|
+
|
|
1407
|
+
## quiz-locale-identities
|
|
1408
|
+
|
|
1409
|
+
Prisma model `QuizLocaleIdentity` in `prisma/schema/Learning/QuizRevision.prisma`.
|
|
1410
|
+
|
|
1411
|
+
**Purpose.** The durable identity of one quiz language across published quiz versions.
|
|
1412
|
+
|
|
1413
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1414
|
+
|
|
1415
|
+
**Relationships.** quizFamilyId points to QuizFamilyState; QuizRevisionLocale stores each version's localized values.
|
|
1416
|
+
|
|
1417
|
+
**Inspect it when.** Follow a quiz language across migration and inspect whether its identity is retired.
|
|
1418
|
+
|
|
1419
|
+
**Who writes it.** Quiz identity/revision creation and migration.
|
|
1420
|
+
|
|
1421
|
+
**Avoid this mistake.** legacyQuizId is a compatibility link, not the current immutable localized revision or its text.
|
|
1422
|
+
|
|
1423
|
+
**Scope.** --instance filters quizFamily.family.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1424
|
+
|
|
1425
|
+
```bash
|
|
1426
|
+
gskills-admin quiz-locale-identities list --where '{"quizFamilyId":"<quizFamilyId>"}' --output json
|
|
1427
|
+
```
|
|
1428
|
+
|
|
1429
|
+
## quiz-question-identities
|
|
1430
|
+
|
|
1431
|
+
Prisma model `QuizQuestionIdentity` in `prisma/schema/Learning/QuizRevision.prisma`.
|
|
1432
|
+
|
|
1433
|
+
**Purpose.** The durable identity of one logical quiz question across versions.
|
|
1434
|
+
|
|
1435
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1436
|
+
|
|
1437
|
+
**Relationships.** quizFamilyId points to QuizFamilyState; QuizRevisionQuestion holds versioned text and UserQuizAnswer can retain this identity.
|
|
1438
|
+
|
|
1439
|
+
**Inspect it when.** Match a learner answer or question history across quiz edits.
|
|
1440
|
+
|
|
1441
|
+
**Who writes it.** Quiz revision identity handling and migration.
|
|
1442
|
+
|
|
1443
|
+
**Avoid this mistake.** Question order and translated text can change. Do not use either as a durable identity or delete identities still used by answers.
|
|
1444
|
+
|
|
1445
|
+
**Scope.** --instance filters quizFamily.family.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1446
|
+
|
|
1447
|
+
```bash
|
|
1448
|
+
gskills-admin quiz-question-identities list --where '{"quizFamilyId":"<quizFamilyId>"}' --output json
|
|
1449
|
+
```
|
|
1450
|
+
|
|
1451
|
+
## quiz-option-identities
|
|
1452
|
+
|
|
1453
|
+
Prisma model `QuizOptionIdentity` in `prisma/schema/Learning/QuizRevision.prisma`.
|
|
1454
|
+
|
|
1455
|
+
**Purpose.** The durable identity of one answer option under a stable quiz question.
|
|
1456
|
+
|
|
1457
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1458
|
+
|
|
1459
|
+
**Relationships.** questionIdentityId points to QuizQuestionIdentity; QuizRevisionOption contains versioned values and selections retain the identity.
|
|
1460
|
+
|
|
1461
|
+
**Inspect it when.** Trace the same option across versions without rewriting recorded answers.
|
|
1462
|
+
|
|
1463
|
+
**Who writes it.** Quiz revision identity handling and migration.
|
|
1464
|
+
|
|
1465
|
+
**Avoid this mistake.** Correctness belongs to the versioned option/snapshot. The identity itself does not say the option was correct at attempt time.
|
|
1466
|
+
|
|
1467
|
+
**Scope.** --instance filters questionIdentity.quizFamily.family.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1468
|
+
|
|
1469
|
+
```bash
|
|
1470
|
+
gskills-admin quiz-option-identities list --where '{"questionIdentityId":"<questionIdentityId>"}' --output json
|
|
1471
|
+
```
|
|
1472
|
+
|
|
1473
|
+
## quiz-revisions
|
|
1474
|
+
|
|
1475
|
+
Prisma model `QuizRevision` in `prisma/schema/Learning/QuizRevision.prisma`.
|
|
1476
|
+
|
|
1477
|
+
**Purpose.** An immutable published snapshot of a quiz family with a version number and content digest.
|
|
1478
|
+
|
|
1479
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1480
|
+
|
|
1481
|
+
**Relationships.** quizFamilyId points to QuizFamilyState; localized revisions and learner attempts refer to this version.
|
|
1482
|
+
|
|
1483
|
+
**Inspect it when.** Determine which quiz definition an attempt used or compare published versions.
|
|
1484
|
+
|
|
1485
|
+
**Who writes it.** PublishCurrentQuizRevision and guarded quiz revision creation; migration creates historical/baseline snapshots.
|
|
1486
|
+
|
|
1487
|
+
**Avoid this mistake.** Never rescore an old attempt using the newest revision. Read the revision linked to that attempt.
|
|
1488
|
+
|
|
1489
|
+
**Scope.** --instance filters quizFamily.family.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1490
|
+
|
|
1491
|
+
```bash
|
|
1492
|
+
gskills-admin quiz-revisions list --where '{"quizFamilyId":"<quizFamilyId>"}' --output json
|
|
1493
|
+
```
|
|
1494
|
+
|
|
1495
|
+
## quiz-revision-locales
|
|
1496
|
+
|
|
1497
|
+
Prisma model `QuizRevisionLocale` in `prisma/schema/Learning/QuizRevision.prisma`.
|
|
1498
|
+
|
|
1499
|
+
**Purpose.** The immutable localized quiz heading and behavior settings for one published revision.
|
|
1500
|
+
|
|
1501
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1502
|
+
|
|
1503
|
+
**Relationships.** revisionId points to QuizRevision; localeIdentityId to QuizLocaleIdentity; questions belong to this localized revision.
|
|
1504
|
+
|
|
1505
|
+
**Inspect it when.** Explain a quiz's title, mandatory behavior or scoring settings in the language/version used by a learner.
|
|
1506
|
+
|
|
1507
|
+
**Who writes it.** Quiz publication snapshot creation and migration.
|
|
1508
|
+
|
|
1509
|
+
**Avoid this mistake.** This is not just a language identity. Its behaviorSnapshot and questions must be read in the same revision context.
|
|
1510
|
+
|
|
1511
|
+
**Scope.** --instance filters revision.quizFamily.family.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1512
|
+
|
|
1513
|
+
```bash
|
|
1514
|
+
gskills-admin quiz-revision-locales list --where '{"revisionId":"<revisionId>"}' --output json
|
|
1515
|
+
```
|
|
1516
|
+
|
|
1517
|
+
## quiz-revision-questions
|
|
1518
|
+
|
|
1519
|
+
Prisma model `QuizRevisionQuestion` in `prisma/schema/Learning/QuizRevision.prisma`.
|
|
1520
|
+
|
|
1521
|
+
**Purpose.** The immutable text, type, order and points of a question in a localized quiz revision.
|
|
1522
|
+
|
|
1523
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1524
|
+
|
|
1525
|
+
**Relationships.** revisionLocaleId points to QuizRevisionLocale; questionIdentityId points to QuizQuestionIdentity.
|
|
1526
|
+
|
|
1527
|
+
**Inspect it when.** Inspect the exact question and scoring weight a learner saw.
|
|
1528
|
+
|
|
1529
|
+
**Who writes it.** Quiz publication snapshot creation and migration.
|
|
1530
|
+
|
|
1531
|
+
**Avoid this mistake.** Editing current quiz text cannot legitimately change this historical question or its existing answers.
|
|
1532
|
+
|
|
1533
|
+
**Scope.** --instance filters revisionLocale.revision.quizFamily.family.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1534
|
+
|
|
1535
|
+
```bash
|
|
1536
|
+
gskills-admin quiz-revision-questions list --where '{"revisionLocaleId":"<revisionLocaleId>"}' --output json
|
|
1537
|
+
```
|
|
1538
|
+
|
|
1539
|
+
## quiz-revision-options
|
|
1540
|
+
|
|
1541
|
+
Prisma model `QuizRevisionOption` in `prisma/schema/Learning/QuizRevision.prisma`.
|
|
1542
|
+
|
|
1543
|
+
**Purpose.** The immutable option text, correctness, explanation and order for one versioned quiz question.
|
|
1544
|
+
|
|
1545
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1546
|
+
|
|
1547
|
+
**Relationships.** revisionQuestionId points to QuizRevisionQuestion; optionIdentityId points to QuizOptionIdentity.
|
|
1548
|
+
|
|
1549
|
+
**Inspect it when.** Explain correctness or the feedback shown for the version a learner answered.
|
|
1550
|
+
|
|
1551
|
+
**Who writes it.** Quiz publication snapshot creation and migration.
|
|
1552
|
+
|
|
1553
|
+
**Avoid this mistake.** Use this version's correctness, not a mutable legacy QuizOption row or a newer published version.
|
|
1554
|
+
|
|
1555
|
+
**Scope.** --instance filters revisionQuestion.revisionLocale.revision.quizFamily.family.ownerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1556
|
+
|
|
1557
|
+
```bash
|
|
1558
|
+
gskills-admin quiz-revision-options list --where '{"revisionQuestionId":"<revisionQuestionId>"}' --output json
|
|
1559
|
+
```
|
|
1560
|
+
|
|
1561
|
+
## quiz-answer-option-selections
|
|
1562
|
+
|
|
1563
|
+
Prisma model `UserQuizAnswerOptionSelection` in `prisma/schema/Learning/QuizRevision.prisma`.
|
|
1564
|
+
|
|
1565
|
+
**Purpose.** One option selected in a learner answer, retaining the chosen version and text/correctness snapshots.
|
|
1566
|
+
|
|
1567
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1568
|
+
|
|
1569
|
+
**Relationships.** answerId points to UserQuizAnswer; optionIdentityId and revisionOptionId identify the stable and versioned option.
|
|
1570
|
+
|
|
1571
|
+
**Inspect it when.** Audit multi-select answers and prove what was selected before later quiz edits.
|
|
1572
|
+
|
|
1573
|
+
**Who writes it.** Learner quiz answer submission and historical-answer migration.
|
|
1574
|
+
|
|
1575
|
+
**Avoid this mistake.** This is learner evidence, not authoring data. Do not patch snapshots to match the latest quiz definition.
|
|
1576
|
+
|
|
1577
|
+
**Scope.** --instance filters answer.userQuizAttempt.consumerInstanceId. This raw filter does not compute inherited availability or effective access.
|
|
1578
|
+
|
|
1579
|
+
```bash
|
|
1580
|
+
gskills-admin quiz-answer-option-selections list --where '{"answerId":"<answerId>"}' --output json
|
|
1581
|
+
```
|
|
1582
|
+
|
|
1583
|
+
## learning-path-group-identities
|
|
1584
|
+
|
|
1585
|
+
Prisma model `LearningPathGroupIdentity` in `prisma/schema/Learning/StableChildIdentity.prisma`.
|
|
1586
|
+
|
|
1587
|
+
**Purpose.** The durable identity of a group inside a learning-path family.
|
|
1588
|
+
|
|
1589
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1590
|
+
|
|
1591
|
+
**Relationships.** learningPathFamilyId points to ContentFamilyIdentity; LearningPathItemIdentity can refer to the group and legacy groups retain the mapping.
|
|
1592
|
+
|
|
1593
|
+
**Inspect it when.** Trace a path section across customer copies, translations and structure edits.
|
|
1594
|
+
|
|
1595
|
+
**Who writes it.** Guarded canonical learning-path structure operations and migration.
|
|
1596
|
+
|
|
1597
|
+
**Avoid this mistake.** The identity does not store the group's presentation or current order. Retirement preserves identity needed by durable references.
|
|
1598
|
+
|
|
1599
|
+
**Scope.** This resource has no --instance filter. Use the documented key/relationship fields in --where to locate the intended scope.
|
|
1600
|
+
|
|
1601
|
+
```bash
|
|
1602
|
+
gskills-admin learning-path-group-identities list --where '{"learningPathFamilyId":"<learningPathFamilyId>"}' --output json
|
|
1603
|
+
```
|
|
1604
|
+
|
|
1605
|
+
## learning-path-item-identities
|
|
1606
|
+
|
|
1607
|
+
Prisma model `LearningPathItemIdentity` in `prisma/schema/Learning/StableChildIdentity.prisma`.
|
|
1608
|
+
|
|
1609
|
+
**Purpose.** The durable identity of an item in a learning-path family, optionally attached to a stable group.
|
|
1610
|
+
|
|
1611
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1612
|
+
|
|
1613
|
+
**Relationships.** learningPathFamilyId points to ContentFamilyIdentity; groupIdentityId points to LearningPathGroupIdentity.
|
|
1614
|
+
|
|
1615
|
+
**Inspect it when.** Reconcile learner completion with the same logical path item after copies or structural edits.
|
|
1616
|
+
|
|
1617
|
+
**Who writes it.** Guarded canonical learning-path structure operations and migration.
|
|
1618
|
+
|
|
1619
|
+
**Avoid this mistake.** Do not match completed items purely by display order or label. Keep stable identity when the logical item is unchanged.
|
|
1620
|
+
|
|
1621
|
+
**Scope.** This resource has no --instance filter. Use the documented key/relationship fields in --where to locate the intended scope.
|
|
1622
|
+
|
|
1623
|
+
```bash
|
|
1624
|
+
gskills-admin learning-path-item-identities list --where '{"learningPathFamilyId":"<learningPathFamilyId>"}' --output json
|
|
1625
|
+
```
|
|
1626
|
+
|
|
1627
|
+
## chromebook-exercise-step-identities
|
|
1628
|
+
|
|
1629
|
+
Prisma model `ChromebookExerciseStepIdentity` in `prisma/schema/Learning/StableChildIdentity.prisma`.
|
|
1630
|
+
|
|
1631
|
+
**Purpose.** The durable identity of a step within a Chromebook exercise family.
|
|
1632
|
+
|
|
1633
|
+
**Key.** `id`. Use get <id> for the primary key or list --where to find related rows.
|
|
1634
|
+
|
|
1635
|
+
**Relationships.** exerciseFamilyId points to ContentFamilyIdentity; legacy step rows retain the mapping.
|
|
1636
|
+
|
|
1637
|
+
**Inspect it when.** Trace exercise progress across translated/copied or retired step rows.
|
|
1638
|
+
|
|
1639
|
+
**Who writes it.** Guarded Chromebook structure identity operations and migration.
|
|
1640
|
+
|
|
1641
|
+
**Avoid this mistake.** A step's current text or ordinal is not its permanent identity; preserve the mapping used by learner progress.
|
|
1642
|
+
|
|
1643
|
+
**Scope.** This resource has no --instance filter. Use the documented key/relationship fields in --where to locate the intended scope.
|
|
1644
|
+
|
|
1645
|
+
```bash
|
|
1646
|
+
gskills-admin chromebook-exercise-step-identities list --where '{"exerciseFamilyId":"<exerciseFamilyId>"}' --output json
|
|
1647
|
+
```
|