Cadmus Re.Novella

Submodels

Cross-parts submodels:

CitedPerson:
- ids (DecoratedId[]):
  - id
  - rank
  - tag
  - sources (DocReference[]):
    - type
    - tag
    - citation
    - note
- sources (DocReference[])
- name (ProperName):
  - language
  - tag
  - pieces (ProperNamePiece[]):
    - type
    - value
- rank
HistoricalDate: referenced from Cadmus.Parts.

Items

TaleCollection Item

TaleInfoPart* (it.vedph.renovella.tale-info)
TaleStoryPart* (it.vedph.renovella.tale-story)
AvailableWitnessesPart (it.vedph.renovella.available-witnesses)
BibliographyPart* (it.vedph.bibliography)
PoeticTextsPart (it.vedph.renovella.poetic-texts)
CategoriesPart (it.vedph.categories)
IndexKeywordsPart (it.vedph.index-keywords)
ExternalIdsPart (it.vedph.external-ids)
NotePart (it.vedph.note")

Tale Item

TaleInfoPart* (it.vedph.renovella.tale-info)
TaleStoryPart* (it.vedph.renovella.tale-story)
AvailableWitnessesPart (it.vedph.renovella.available-witnesses)
BibliographyPart* (it.vedph.bibliography)
PoeticTextsPart (it.vedph.renovella.poetic-texts)
CategoriesPart (it.vedph.categories)
IndexKeywordsPart (it.vedph.index-keywords)
ExternalIdsPart (it.vedph.external-ids)
NotePart (it.vedph.note")
DocReferencesPart* for mss, just quoting the signature (it.vedph.doc-references)

Parts

AvailableWitnessesPart

ID: it.vedph.renovella.available-witnesses

Information about witnesses (essentially manuscripts) available for the specified item (tale or tales collection).

witnesses (AvailableWitness):
- id* (string)
- isPartial (boolean)
- note (string)
- externalIds (string[])

TaleInfoPart

ID: it.vedph.renovella.tale-info

Essential information about a tale or a tales collection.

collectionId: the human-readable ID of the collection. Empty if this is not a collection.
containerId: the ID of the collection this tale belongs to.
ordinal (number): the ordinal number of the tale in its container.
title* (string)
author (CitedPerson):
- name (ProperName):
  - language (string)
  - tag (string)
  - pieces (ProperNamePiece[]):
    - type (string)
    - value (string)
- rank (short)
- ids (DecoratedId[]):
  - id (string)
  - rank (int)
  - tag (string)
  - sources (DocReference[])
- sources (DocReference[]):
  - type (string)
  - tag (string)
  - citation (string)
  - note (string)
dedicatee (CitedPerson)
place* (string)
date* (HistoricalDate)
language (string: thesaurus tale-languages)
genres* (string[]: thesaurus tale-genres)
structure (string)
rubric (string)
incipit (string)
explicit (string)
narrator (string)

TaleStoryPart

ID: it.vedph.renovella.tale-story

Data about the tale's story.

summary* (string)
prologue (string)
epilogue (string)
characters* (StoryCharacter[])
- name (string)
- sex (string; M or F or - when not applicable)
- role* (string: thesaurus story-roles)
- isGroup (boolean): true if this is a collective designation for a group (e.g. "facchini")
age (string)
date* (HistoricalDate)
places* (StoryPlace):
- type* (string, thesaurus story-place-types: e.g. city, country, etc)
- place (string)
- location (string): location inside place (e.g. "Chiesa di S.Anna")

PoeticTextsPart

ID: it.vedph.renovella.poetic-texts.

texts (PoeticText[]):
- incipit* (string)
- metre* (string) T:poetic-text-metres
- note (string)

History

6.0.3

2024-07-19: updated packages.

6.0.2

2024-06-10: updated packages.

6.0.1

2024-05-24: updated packages.
2024-04-16: updated test packages.

6.0.0

2024-04-08: upgraded to .NET 8.

5.0.2

2023-09-29: updated packages.
2023-08-30: updated test packages.

5.0.1

2023-07-26:
- updated packages.
- removed structure pin from TaleInfoPart as it contains a summary rather than a short definition.

5.0.0

2023-06-23: updated packages.

4.0.1

2023-05-19: updated packages.

4.0.0

2023-03-15: migrated to new backend configuration.

3.0.1

2022-12-23: updated packages.

3.0.0

2022-11-10: upgraded to NET 7.

2.1.0

2022-10-11: updated packages (IRepositoryProvider).

2.0.1

2022-02-18: completed PoeticTextsPart.
2022-02-08: upgraded packages.
2021-11-11: upgraded to NET 6.
2021-10-25: updated packages.
2021-10-16: refactored dependencies so that DocReference and ProperName (formerly PersonName) are from bricks; also, the sub-model cited person is no more from Itinera, but defined inside this project. This implies these changes in the database parts of type TaleInfoPart:
- rename: author and dedicatee have: name.pieces instead of name.parts.
  - remodel: ids.sources have new DocReference instead of tag, author, work, location. We can merge the last 3 fields into citation following some convention. The new model has type, tag, citation, note.
  - remodel: sources as above.

Upgrade instructions:

(1) TaleInfoPart for author:

// get records before update
db.parts.find({
    "typeId" : "it.vedph.renovella.tale-info",
    "content.author.name.parts" : {
        $exists : true
    }
});

// update renaming 'parts' into 'pieces'
db.parts.updateMany(
{
"typeId" : "it.vedph.renovella.tale-info",
"content.author.name.parts" : { $exists : true }
},
{
$rename: {
"content.author.name.parts": "content.author.name.pieces"
}
}, false, true);

(2) TaleInfoPart for dedicatee:

// get records before update
db.parts.find({
    "typeId" : "it.vedph.renovella.tale-info",
    "content.dedicatee.name.parts" : {
        $exists : true
    }
});

// update renaming 'parts' into 'pieces'
db.parts.updateMany(
{
"typeId" : "it.vedph.renovella.tale-info",
"content.dedicatee.name.parts" : { $exists : true }
},
{
$rename: {
"content.dedicatee.name.parts": "content.dedicatee.name.pieces"
}
}, false, true);

(3) TaleInfoPart for references:

// get all the author's sources
db.parts.find({
    "typeId" : "it.vedph.renovella.tale-info",
    "content.author.sources" : {
        $exists : true, $ne: []
    }
});

As we just have 1 case and it's not clear how the team prefers to handle this, we have better leave this to manual editing.

(4) TaleInfoPart for ID references:

// get all the author's IDs sources
db.parts.find({
    "typeId" : "it.vedph.renovella.tale-info",
    "content.author.ids.sources" : {
        $exists : true, $ne: []
    }
});

As we just have 6 cases and it's not clear how the team prefers to handle this, we have better leave this to manual editing.

History

2.0.1

2022-05-12: added AvailableWitnessesPart.

2.0.0

2022-05-01: upgraded to NET6.0.

1.2.8

2022-04-21: updated packages.

vedph / cadmus-renovella Goto Github PK