cocina-models 0.4.1 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a6abdc4aaa916e9d19c4e86939b1dd46957cb688ff2ab15d70101ba975bbb9aa
4
- data.tar.gz: a806b4371060ade68b0bd5a4e3664b29aa5accf6a763da7754fbabf0248e2d1f
3
+ metadata.gz: 8b34aca3b7691b95a9cdd86bf7e40e8db0d57a1f6baadff61a1017b0eb93ba43
4
+ data.tar.gz: b8510bc730ec149672f8f9d5697b903ed8f36d240947d1766085a77d7180aca6
5
5
  SHA512:
6
- metadata.gz: d72e8ca5521d065f8275d608cae680b432fe7631734f59bbfcbb6c6387107bd3dfa1224e1a72fca2efa75d5f56f0c9fd45be26a3357476766d32dff1b77b36a2
7
- data.tar.gz: 7938a63de467a7d72560f605a8c179bc99f08fe38e8f78b610f0f32972c4b7ab8c336ef506a9ca3c755616551410f881500fcef617b66d40a39c4bfb7e987133
6
+ metadata.gz: d74b5c6aa8e10e0d478fd128589f1bf32228f668b93040ac863ad71dc6a48e91e1631d031b12b3be0016b40b31da5ce5fed4a1ff58d592aa31c38013320f438a
7
+ data.tar.gz: 5ed3710a39e6c4cc748dbc7ce180c7caccde3da5e7d7bc16f86db12909b83ad632e0d489a65f779bbfbc8c861583d0452021768796ead4a9838ae6186ae9d19f
data/README.md CHANGED
@@ -1,8 +1,7 @@
1
- # Cocina::Models
2
1
  [![Gem Version](https://badge.fury.io/rb/cocina-models.svg)](https://badge.fury.io/rb/cocina-models)
3
2
 
4
- This is the models for transporting digital repository objects using the Cocina application profile.
3
+ # Cocina::Models
5
4
 
6
- This is a work in progress and will eventually implement the full Cocina data model. See https://github.com/sul-dlss/taco-truck/blob/master/COCINA.md#cocina-data-models--shapes
5
+ This is a Ruby implementation of the SDR data model (named "COCINA"). The data being modeled includes digital repository objects.
7
6
 
8
- See also https://github.com/sul-dlss-labs/taco/tree/master/maps
7
+ This is a work in progress that will ultimately implement the full [COCINA data model](http://sul-dlss.github.io/cocina-models/). See also [architecture documentation](https://sul-dlss.github.io/taco-truck/COCINA.html#cocina-data-models--shapes).
@@ -0,0 +1,7 @@
1
+ # COCINA Models
2
+
3
+ Documentation for Stanford Digital Repository data models (named "COCINA" to distinguish them from models used in the past)
4
+
5
+ Included:
6
+ * [COCINA metadata application profiles (MAPs)](./maps)
7
+ * [Sample ETD data mapped into the MAPs](./sampleETD)
@@ -0,0 +1 @@
1
+ theme: jekyll-theme-minimal
@@ -0,0 +1,17 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-06/schema#",
3
+ "title": "Agent",
4
+ "description": "An Agent - Person, Group, Organization, or other Acting body.",
5
+ "type": "object",
6
+ "required": ["name"],
7
+ "properties": {
8
+ "name": {
9
+ "description": "Primary label or name for an Agent.",
10
+ "type": "string"
11
+ },
12
+ "sunetID": {
13
+ "description": "Stanford University NetID for the Agent.",
14
+ "type": "string"
15
+ }
16
+ }
17
+ }
@@ -0,0 +1,235 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-06/schema#",
3
+ "title": "Digital Repository Collection",
4
+ "description": "A group of Digital Repository Objects that indicate some type of conceptual grouping within the domain that is worth reusing across the system.",
5
+ "type": "object",
6
+ "required": ["@context", "@type", "externalIdentifier", "label", "internalIdentifier", "version", "administrative", "access", "identification", "structural"],
7
+ "properties": {
8
+ "@context": {
9
+ "description": "URI for the JSON-LD context definitions.",
10
+ "type": "string"
11
+ },
12
+ "@type": {
13
+ "description": "The content type of the Collection. Selected from an established set of values.",
14
+ "type": "string",
15
+ "enum": [
16
+ "http://cocina.sul.stanford.edu/models/collection.jsonld",
17
+ "http://cocina.sul.stanford.edu/models/curated-collection.jsonld",
18
+ "http://cocina.sul.stanford.edu/models/user-collection.jsonld",
19
+ "http://cocina.sul.stanford.edu/models/exhibit.jsonld",
20
+ "http://cocina.sul.stanford.edu/models/series.jsonld"
21
+ ]
22
+ },
23
+ "citation": {
24
+ "description": "Citation for the resource, including identifier, label, version, and a persistent URL to the object with SDR at the very least.",
25
+ "type": "string"
26
+ },
27
+ "dedupeIdentifier": {
28
+ "description": "Identifier retrieved from identification.sourceId that stands for analog or source identifier that this resource is a digital representation of.",
29
+ "type": "string"
30
+ },
31
+ "depositor": {
32
+ "description": "The Agent (User, Group, Application, Department, other) that deposited the Collection into SDR.",
33
+ "$ref": "Agent.json"
34
+ },
35
+ "externalIdentifier": {
36
+ "description": "Identifier for the resource within the SDR architecture but outside of the repository. DRUID or UUID depending on resource type. Constant across resource versions. What clients will use calling the repository. Same as `identification.identifier`",
37
+ "type": "string"
38
+ },
39
+ "label": {
40
+ "description": "Primary processing label (can be same as title) for a Collection.",
41
+ "type": "string"
42
+ },
43
+ "internalIdentifier": {
44
+ "description": "Identifier for the resource within the repository. UUID, unique for each new version of a repository resource.",
45
+ "type": "string"
46
+ },
47
+ "version": {
48
+ "description": "Version for the Collection within SDR.",
49
+ "type": "integer"
50
+ },
51
+ "precedingVersion": {
52
+ "description": "Preceding version for the Collection within SDR.",
53
+ "type": "string"
54
+ },
55
+ "followingVersion": {
56
+ "description": "Following version for the Collection within SDR.",
57
+ "type": "string"
58
+ },
59
+ "access": {
60
+ "description": "Access Metadata for the Collection.",
61
+ "type": "object",
62
+ "required": ["access", "download"],
63
+ "properties": {
64
+ "access": {
65
+ "description": "Access level for the Collection.",
66
+ "type": "string",
67
+ "enum": ["world", "stanford", "location-based", "citation-only", "dark"]
68
+ },
69
+ "copyright": {
70
+ "description": "The human readable copyright statement that applies to the Collection.",
71
+ "type": "string"
72
+ },
73
+ "download": {
74
+ "description": "Download level for the Collection metadata.",
75
+ "type": "string",
76
+ "enum": ["world", "stanford", "location-based", "citation-only", "dark"]
77
+ },
78
+ "embargoReleaseDate": {
79
+ "description": "Date when the Collection is released from an embargo, if an embargo exists.",
80
+ "type": "string",
81
+ "format": "date-time"
82
+ },
83
+ "license": {
84
+ "description": "The license governing reuse of the Collection. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).",
85
+ "type": "string"
86
+ },
87
+ "reuseAndReproductionStatement": {
88
+ "description": "The human readable reuse and reproduction statement that applies to the Collection.",
89
+ "type": "string"
90
+ },
91
+ "termsOfUse": {
92
+ "description": "License or terms of use governing reuse of the Collection. Should be a text statement.",
93
+ "type": "string"
94
+ }
95
+ }
96
+ },
97
+ "administrative": {
98
+ "type": "object",
99
+ "description": "Administrative metadata for the SDR resource.",
100
+ "required": ["created", "isDescribedBy", "sdrPreserve"],
101
+ "properties": {
102
+ "created": {
103
+ "description": "When the resource in SDR was created.",
104
+ "type": "string",
105
+ "format": "date-time"
106
+ },
107
+ "deleted": {
108
+ "description": "If the resource has been deleted (but not purged).",
109
+ "type": "boolean"
110
+ },
111
+ "gravestoneMessage": {
112
+ "description": "Message describing why the object was deleted.",
113
+ "type": "string"
114
+ },
115
+ "isDescribedBy": {
116
+ "description": "PURL/XML file that is a traditional representation of the metadata for the Collection.",
117
+ "type": "string"
118
+ },
119
+ "lastUpdated": {
120
+ "description": "When the resource in SDR was last updated.",
121
+ "type": "string",
122
+ "format": "date-time"
123
+ },
124
+ "partOfProject": {
125
+ "description": "Administrative or Internal project this resource is a part of.",
126
+ "type": "string"
127
+ },
128
+ "sdrPreserve": {
129
+ "description": "If this resource should be sent to Preservation.",
130
+ "type": "boolean"
131
+ },
132
+ "remediatedBy": {
133
+ "description": "The Agent (User, Group, Application, Department, other) that remediated a Collection in SDR.",
134
+ "type": "array",
135
+ "items": {
136
+ "$ref": "Agent.json"
137
+ }
138
+ }
139
+ }
140
+ },
141
+ "identification": {
142
+ "description": "Identifying information for the Collection.",
143
+ "type": "object",
144
+ "required": ["identifier"],
145
+ "properties": {
146
+ "catalogLinks": {
147
+ "description": "Links to catalog records for the resource that the Collection represents in whole or part.",
148
+ "type": "array",
149
+ "items": {
150
+ "type": "object",
151
+ "required": ["catalog", "catalogRecordId"],
152
+ "properties": {
153
+ "catalog": {
154
+ "description": "Catalog that is the source of the linked record.",
155
+ "type": "string"
156
+ },
157
+ "catalogRecordId": {
158
+ "description": "Record identifier that is unique within the context of the linked record's catalog.",
159
+ "type": "string"
160
+ },
161
+ "recordSchema": {
162
+ "description": "Metadata schema of the linked record.",
163
+ "type": "string"
164
+ },
165
+ "deriveMetadata": {
166
+ "description": "If the Collection descriptive metadata should be automatically updated when the linked record changes.",
167
+ "type": "boolean"
168
+ },
169
+ "deliverMetadata": {
170
+ "description": "If the linked record should be automatically updated when the Collection descriptive metadata changes.",
171
+ "type": "boolean"
172
+ },
173
+ "recordScope": {
174
+ "description": "Whether the linked record describes a resource that is broader than, equivalent to, or narrower than the resource the Collection represents.",
175
+ "type": "string",
176
+ "enum": ["broader", "equivalent", "narrower"]
177
+ }
178
+ }
179
+ }
180
+ },
181
+ "DOI": {
182
+ "description": "Digital Object Identifier (DOI) for the Collection within this repository.",
183
+ "type": "string"
184
+ },
185
+ "identifier": {
186
+ "description": "Identifier for the Collection within the Stanford Digital Repository system",
187
+ "type": "string"
188
+ },
189
+ "sameAs": {
190
+ "description": "Another object, either external or internal to the system (if duplication occurs) that is the same digital resource as this Collection.",
191
+ "type": "string"
192
+ },
193
+ "sourceId": {
194
+ "description": "A source resource or object (perhaps but not necessarily analog or physical) that the Collection is a digital representation of.",
195
+ "type": "string"
196
+ },
197
+ "sdrUUID": {
198
+ "type": "string",
199
+ "description": "UUID previously minted for the resource within SDR2 / Fedora 3."
200
+ }
201
+ }
202
+ },
203
+ "structural": {
204
+ "description": "Structural metadata for the Collection.",
205
+ "type": "object",
206
+ "required": ["hasAgreement"],
207
+ "properties": {
208
+ "hasAgreement": {
209
+ "description": "Agreement that covers the deposit of the Collection into SDR.",
210
+ "type": "string"
211
+ },
212
+ "hasMember": {
213
+ "description": "Component digital repository objects or collections that are a part of this collection.",
214
+ "type": "array",
215
+ "items": [{
216
+ "type": "string"
217
+ }]
218
+ },
219
+ "isTargetOf": {
220
+ "description": "An Annotation instance that applies to the Collection.",
221
+ "type": ["string", "null"]
222
+ },
223
+ "hasMemberOrders": {
224
+ "description": "Provided sequences or orderings of members of the Collection, including some metadata about each sequence (i.e. sequence label, sequence type, if the sequence is primary, etc.).",
225
+ "type": "array",
226
+ "items": [
227
+ {
228
+ "$ref": "Sequence.json"
229
+ }
230
+ ]
231
+ }
232
+ }
233
+ }
234
+ }
235
+ }
@@ -0,0 +1,271 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-06/schema#",
3
+ "title": "Digital Repository Object",
4
+ "description": "Domain-defined abstraction of a 'work'. Digital Repository Objects' abstraction is describable for our domain’s purposes, i.e. for management needs within our system.",
5
+ "type": "object",
6
+ "required": ["@context", "@type", "externalIdentifier", "label", "internalIdentifier", "version", "administrative", "access", "identification", "structural"],
7
+ "properties": {
8
+ "@context": {
9
+ "description": "URI for the JSON-LD context definitions.",
10
+ "type": "string"
11
+ },
12
+ "@type": {
13
+ "description": "The content type of the DRO. Selected from an established set of values.",
14
+ "type": "string",
15
+ "enum": [
16
+ "http://cocina.sul.stanford.edu/models/object.jsonld",
17
+ "http://cocina.sul.stanford.edu/models/3d.jsonld",
18
+ "http://cocina.sul.stanford.edu/models/agreement.jsonld",
19
+ "http://cocina.sul.stanford.edu/models/book.jsonld",
20
+ "http://cocina.sul.stanford.edu/models/document.jsonld",
21
+ "http://cocina.sul.stanford.edu/models/geo.jsonld",
22
+ "http://cocina.sul.stanford.edu/models/image.jsonld",
23
+ "http://cocina.sul.stanford.edu/models/page.jsonld",
24
+ "http://cocina.sul.stanford.edu/models/photograph.jsonld",
25
+ "http://cocina.sul.stanford.edu/models/manuscript.jsonld",
26
+ "http://cocina.sul.stanford.edu/models/map.jsonld",
27
+ "http://cocina.sul.stanford.edu/models/media.jsonld",
28
+ "http://cocina.sul.stanford.edu/models/track.jsonld",
29
+ "http://cocina.sul.stanford.edu/models/webarchive-binary.jsonld",
30
+ "http://cocina.sul.stanford.edu/models/webarchive-seed.jsonld"
31
+ ]
32
+ },
33
+ "citation": {
34
+ "description": "Citation for the resource, including identifier, label, version, and a persistent URL to the object with SDR at the very least.",
35
+ "type": "string"
36
+ },
37
+ "dedupeIdentifier": {
38
+ "description": "Identifier retrieved from identification.sourceId that stands for analog or source identifier that this resource is a digital representation of.",
39
+ "type": "string"
40
+ },
41
+ "depositor": {
42
+ "description": "The Agent (User, Group, Application, Department, other) that deposited the DRO into SDR.",
43
+ "$ref": "Agent.json"
44
+ },
45
+ "externalIdentifier": {
46
+ "description": "Identifier for the resource within the SDR architecture but outside of the repository. DRUID or UUID depending on resource type. Constant across resource versions. What clients will use calling the repository. Same as `identification.identifier`",
47
+ "type": "string"
48
+ },
49
+ "label": {
50
+ "description": "Primary processing label (can be same as title) for a DRO.",
51
+ "type": "string"
52
+ },
53
+ "internalIdentifier": {
54
+ "description": "Identifier for the resource within the repository. UUID, unique for each new version of a repository resource.",
55
+ "type": "string"
56
+ },
57
+ "version": {
58
+ "description": "Version for the DRO within SDR.",
59
+ "type": "integer"
60
+ },
61
+ "precedingVersion": {
62
+ "description": "Preceding version for the Object within SDR.",
63
+ "type": "string"
64
+ },
65
+ "followingVersion": {
66
+ "description": "Following version for the Object within SDR.",
67
+ "type": "string"
68
+ },
69
+ "access": {
70
+ "description": "Access Metadata for the DRO.",
71
+ "type": "object",
72
+ "required": ["access", "download"],
73
+ "properties": {
74
+ "access": {
75
+ "description": "Access level for the DRO.",
76
+ "type": "string",
77
+ "enum": ["world", "stanford", "location-based", "citation-only", "dark"]
78
+ },
79
+ "copyright": {
80
+ "description": "The human readable copyright statement that applies to the DRO.",
81
+ "type": "string"
82
+ },
83
+ "download": {
84
+ "description": "Download level for the DRO metadata.",
85
+ "type": "string",
86
+ "enum": ["world", "stanford", "location-based", "citation-only", "dark"]
87
+ },
88
+ "embargoReleaseDate": {
89
+ "description": "Date when the DRO is released from an embargo, if an embargo exists.",
90
+ "type": "string",
91
+ "format": "date-time"
92
+ },
93
+ "license": {
94
+ "description": "The license governing reuse of the DRO. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).",
95
+ "type": "string"
96
+ },
97
+ "reuseAndReproductionStatement": {
98
+ "description": "The human readable reuse and reproduction statement that applies to the DRO.",
99
+ "type": "string"
100
+ },
101
+ "termsOfUse": {
102
+ "description": "License or terms of use governing reuse of the DRO. Should be a text statement.",
103
+ "type": "string"
104
+ },
105
+ "visibility": {
106
+ "description": "Percentage of the DRO that is visibility during an embargo period",
107
+ "type": "integer"
108
+ }
109
+ }
110
+ },
111
+ "administrative": {
112
+ "type": "object",
113
+ "description": "Administrative metadata for the SDR resource.",
114
+ "required": ["created", "isDescribedBy", "sdrPreserve"],
115
+ "properties": {
116
+ "created": {
117
+ "description": "When the resource in SDR was created.",
118
+ "type": "string",
119
+ "format": "date-time"
120
+ },
121
+ "deleted": {
122
+ "description": "If the resource has been deleted (but not purged).",
123
+ "type": "boolean"
124
+ },
125
+ "gravestoneMessage": {
126
+ "description": "Message describing why the object was deleted.",
127
+ "type": "string"
128
+ },
129
+ "isDescribedBy": {
130
+ "description": "Pointer to the PURL/XML file that is a traditional representation of the metadata for the DRO.",
131
+ "type": "string"
132
+ },
133
+ "lastUpdated": {
134
+ "description": "When the resource in SDR was last updated.",
135
+ "type": "string",
136
+ "format": "date-time"
137
+ },
138
+ "partOfProject": {
139
+ "description": "Administrative or Internal project this resource is a part of.",
140
+ "type": "string"
141
+ },
142
+ "sdrPreserve": {
143
+ "description": "If this resource should be sent to Preservation.",
144
+ "type": "boolean"
145
+ },
146
+ "remediatedBy": {
147
+ "description": "The Agent (User, Group, Application, Department, other) that remediated a DRO in SDR.",
148
+ "type": "array",
149
+ "items": {
150
+ "$ref": "Agent.json"
151
+ }
152
+ }
153
+ }
154
+ },
155
+ "identification": {
156
+ "description": "Identifying information for the DRO.",
157
+ "type": "object",
158
+ "required": ["identifier"],
159
+ "properties": {
160
+ "catalogLinks": {
161
+ "description": "Links to catalog records for the resource that the DRO represents in whole or part.",
162
+ "type": "array",
163
+ "items": {
164
+ "type": "object",
165
+ "required": ["catalog", "catalogRecordId"],
166
+ "properties": {
167
+ "catalog": {
168
+ "description": "Catalog that is the source of the linked record.",
169
+ "type": "string"
170
+ },
171
+ "catalogRecordId": {
172
+ "description": "Record identifier that is unique within the context of the linked record's catalog.",
173
+ "type": "string"
174
+ },
175
+ "recordSchema": {
176
+ "description": "Metadata schema of the linked record.",
177
+ "type": "string"
178
+ },
179
+ "deriveMetadata": {
180
+ "description": "If the DRO descriptive metadata should be automatically updated when the linked record changes.",
181
+ "type": "boolean"
182
+ },
183
+ "deliverMetadata": {
184
+ "description": "If the linked record should be automatically updated when the DRO descriptive metadata changes.",
185
+ "type": "boolean"
186
+ },
187
+ "recordScope": {
188
+ "description": "Whether the linked record describes a resource that is broader than, equivalent to, or narrower than the resource the DRO represents.",
189
+ "type": "string",
190
+ "enum": ["broader", "equivalent", "narrower"]
191
+ }
192
+ }
193
+ }
194
+ },
195
+ "doi": {
196
+ "description": "Digital Object Identifier (DOI) for the DRO within this repository.",
197
+ "type": "string"
198
+ },
199
+ "identifier": {
200
+ "description": "Identifier for the Digital Repository Object within the Stanford Digital Repository system",
201
+ "type": "string"
202
+ },
203
+ "sameAs": {
204
+ "description": "Another object, either external or internal to the system (if duplication occurs) that is the same digital resource as this DRO.",
205
+ "type": "string"
206
+ },
207
+ "sourceId": {
208
+ "description": "A source resource or object (perhaps but not necessarily analog or physical) that the DRO is a digital representation of.",
209
+ "type": "string"
210
+ },
211
+ "sdrUUID": {
212
+ "type": "string",
213
+ "description": "UUID previously minted for the resource within SDR2 / Fedora 3."
214
+ }
215
+ }
216
+ },
217
+ "permissions": {
218
+ "description": "Permissions Metadata for the DRO.",
219
+ "type": "object",
220
+ "properties": {
221
+ "approvalRequired": {
222
+ "description": "Indicates if approval is required to deposit or manage the resource in SDR.",
223
+ "type": "boolean"
224
+ },
225
+ "approvers": {
226
+ "description": "Agents who are required to approve deposit or management of this resource in SDR.",
227
+ "type": "array",
228
+ "items": {
229
+ "$ref": "Agent.json"
230
+ }
231
+ }
232
+ }
233
+ },
234
+ "structural": {
235
+ "description": "Structural metadata for the DRO.",
236
+ "type": "object",
237
+ "required": ["hasAgreement"],
238
+ "properties": {
239
+ "contains": {
240
+ "description": "Filesets that contain the digital representations (Files) of the DRO.",
241
+ "type": "array",
242
+ "items": {
243
+ "type": "string"
244
+ }
245
+ },
246
+ "hasAgreement": {
247
+ "description": "Agreement that covers the deposit of the DRO into SDR.",
248
+ "type": "string"
249
+ },
250
+ "hasMember": {
251
+ "description": "Component or 'children' digital repository objects that are a part or portion of this 'parent' or aggregate DRO.",
252
+ "type": "array",
253
+ "items": [{
254
+ "type": "string"
255
+ }]
256
+ },
257
+ "isTargetOf": {
258
+ "description": "An Annotation instance that applies to the DRO.",
259
+ "type": ["string", "null"]
260
+ },
261
+ "hasMemberOrders": {
262
+ "description": "Provided sequences or orderings of members of the Object, including some metadata about each sequence (i.e. sequence label, sequence type, if the sequence is primary, etc.).",
263
+ "type": "array",
264
+ "items": [{
265
+ "$ref": "Sequence.json"
266
+ }]
267
+ }
268
+ }
269
+ }
270
+ }
271
+ }