refactor: remodel entities for library search and results

2026-01-06 21:42:49 +00:00 · 2021-08-12 12:41:03 +00:00
parent 4ab8770fbc
commit 2dfb64bafd
26 changed files with 791 additions and 105 deletions
--- a/src/meta.ts
+++ b/src/meta.ts
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2019 StApps
+ * Copyright (C) 2019-2021 StApps
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the Free
 * Software Foundation, version 3.
@@ -27,8 +27,14 @@ import {SCFavorite, SCFavoriteMeta, SCFavoriteWithoutReferences} from './things/
 import {SCFloor, SCFloorMeta, SCFloorWithoutReferences} from './things/floor';
 import {SCMessage, SCMessageMeta, SCMessageWithoutReferences} from './things/message';
 import {SCOrganization, SCOrganizationMeta, SCOrganizationWithoutReferences} from './things/organization';
+import {SCPeriodical, SCPeriodicalMeta, SCPeriodicalWithoutReferences} from './things/periodical';
 import {SCPerson, SCPersonMeta, SCPersonWithoutReferences} from './things/person';
 import {SCPointOfInterest, SCPointOfInterestMeta, SCPointOfInterestWithoutReferences} from './things/point-of-interest';
+import {
+  SCPublicationEvent,
+  SCPublicationEventMeta,
+  SCPublicationEventWithoutReferences,
+} from './things/publication-event';
 import {SCRoom, SCRoomMeta, SCRoomWithoutReferences} from './things/room';
 import {SCSemester, SCSemesterMeta, SCSemesterWithoutReferences} from './things/semester';
 import {SCSetting, SCSettingMeta, SCSettingWithoutReferences} from './things/setting';
@@ -59,8 +65,10 @@ export const SCClasses: { [K in SCThingType]: object } = {
  'floor': SCFloorMeta,
  'message': SCMessageMeta,
  'organization': SCOrganizationMeta,
+  'periodical': SCPeriodicalMeta,
  'person': SCPersonMeta,
  'point of interest': SCPointOfInterestMeta,
+  'publication event': SCPublicationEventMeta,
  'room': SCRoomMeta,
  'semester': SCSemesterMeta,
  'setting': SCSettingMeta,
@@ -85,8 +93,10 @@ export type SCIndexableThings =
  | SCFloor
  | SCMessage
  | SCOrganization
+  | SCPeriodical
  | SCPerson
  | SCPointOfInterest
+  | SCPublicationEvent
  | SCRoom
  | SCSemester
  | SCSportCourse
@@ -126,18 +136,20 @@ export type SCAssociatedThingWithoutReferences<THING extends SCThings> =
                        THING extends SCFloor ? SCFloorWithoutReferences :
                          THING extends SCMessage ? SCMessageWithoutReferences :
                            THING extends SCOrganization ? SCOrganizationWithoutReferences :
-                              THING extends SCPerson ? SCPersonWithoutReferences :
-                                THING extends SCPointOfInterest ? SCPointOfInterestWithoutReferences :
-                                  THING extends SCRoom ? SCRoomWithoutReferences :
-                                    THING extends SCSemester ? SCSemesterWithoutReferences :
-                                      THING extends SCSetting ? SCSettingWithoutReferences :
-                                        THING extends SCSportCourse ? SCSportCourseWithoutReferences :
-                                          THING extends SCStudyModule ? SCStudyModuleWithoutReferences :
-                                            THING extends SCTicket ? SCTicketWithoutReferences :
-                                              THING extends SCToDo ? SCToDoWithoutReferences :
-                                                THING extends SCTour ? SCTourWithoutReferences :
-                                                  THING extends SCVideo ? SCVideoWithoutReferences :
-                                                    never;
+                              THING extends SCPeriodical ? SCPeriodicalWithoutReferences :
+                                THING extends SCPerson ? SCPersonWithoutReferences :
+                                  THING extends SCPointOfInterest ? SCPointOfInterestWithoutReferences :
+                                    THING extends SCPublicationEvent ? SCPublicationEventWithoutReferences :
+                                      THING extends SCRoom ? SCRoomWithoutReferences :
+                                        THING extends SCSemester ? SCSemesterWithoutReferences :
+                                          THING extends SCSetting ? SCSettingWithoutReferences :
+                                            THING extends SCSportCourse ? SCSportCourseWithoutReferences :
+                                              THING extends SCStudyModule ? SCStudyModuleWithoutReferences :
+                                                THING extends SCTicket ? SCTicketWithoutReferences :
+                                                  THING extends SCToDo ? SCToDoWithoutReferences :
+                                                    THING extends SCTour ? SCTourWithoutReferences :
+                                                      THING extends SCVideo ? SCVideoWithoutReferences :
+                                                        never;

 /**
 * Thing for a thing without references
@@ -157,15 +169,17 @@ export type SCAssociatedThing<THING extends SCThings> =
                        THING extends SCFloorWithoutReferences ? SCFloor :
                          THING extends SCMessageWithoutReferences ? SCMessage :
                            THING extends SCOrganizationWithoutReferences ? SCOrganization :
-                              THING extends SCPersonWithoutReferences ? SCPerson :
-                                THING extends SCPointOfInterestWithoutReferences ? SCPointOfInterest :
-                                  THING extends SCRoomWithoutReferences ? SCRoom :
-                                    THING extends SCSemesterWithoutReferences ? SCSemester :
-                                      THING extends SCSettingWithoutReferences ? SCSetting :
-                                        THING extends SCSportCourseWithoutReferences ? SCSportCourse :
-                                          THING extends SCStudyModuleWithoutReferences ? SCStudyModule :
-                                            THING extends SCTicketWithoutReferences ? SCTicket :
-                                              THING extends SCToDoWithoutReferences ? SCToDo :
-                                                THING extends SCTourWithoutReferences ? SCTour :
-                                                  THING extends SCVideoWithoutReferences ? SCVideo :
-                                                    never;
+                              THING extends SCPeriodicalWithoutReferences ? SCPeriodical :
+                                THING extends SCPersonWithoutReferences ? SCPerson :
+                                  THING extends SCPointOfInterestWithoutReferences ? SCPointOfInterest :
+                                    THING extends SCPublicationEventWithoutReferences ? SCPublicationEvent :
+                                      THING extends SCRoomWithoutReferences ? SCRoom :
+                                        THING extends SCSemesterWithoutReferences ? SCSemester :
+                                          THING extends SCSettingWithoutReferences ? SCSetting :
+                                            THING extends SCSportCourseWithoutReferences ? SCSportCourse :
+                                              THING extends SCStudyModuleWithoutReferences ? SCStudyModule :
+                                                THING extends SCTicketWithoutReferences ? SCTicket :
+                                                  THING extends SCToDoWithoutReferences ? SCToDo :
+                                                    THING extends SCTourWithoutReferences ? SCTour :
+                                                      THING extends SCVideoWithoutReferences ? SCVideo :
+                                                        never;
--- a/src/things/abstract/creative-work.ts
+++ b/src/things/abstract/creative-work.ts
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2019 StApps
+ * Copyright (C) 2019-2021 StApps
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the Free
 * Software Foundation, version 3.
@@ -16,11 +16,11 @@ import {SCLanguageCode, SCMetaTranslations, SCTranslations} from '../../general/
 import {SCISO8601Date} from '../../general/time';
 import {SCOrganizationWithoutReferences} from '../organization';
 import {SCPersonWithoutReferences} from '../person';
+import {SCPublicationEventWithoutReferences} from '../publication-event';
 import {SCThingMeta, SCThingTranslatableProperties, SCThingWithoutReferences} from './thing';
 import {
  SCAcademicPriceGroup,
-  SCThingThatCanBeOffered,
-  SCThingThatCanBeOfferedMeta,
+  SCThingThatCanBeOffered, SCThingThatCanBeOfferedMeta,
  SCThingThatCanBeOfferedTranslatableProperties,
  SCThingThatCanBeOfferedWithoutReferences,
 } from './thing-that-can-be-offered';
@@ -38,11 +38,23 @@ export interface SCCreativeWorkWithoutReferences

  /**
   * Date the creative work was published
-   *
-   * @filterable
   */
  datePublished?: SCISO8601Date;

+  /**
+   * Edition of a creative work (e.g. the book edition or edition of an article)
+   *
+   * @keyword
+   */
+  edition?: string;
+
+  /**
+   * Date (in text form) the creative work was published for the first time
+   *
+   * @keyword
+   */
+  firstPublished?: string;
+
  /**
   * Languages this creative work is written/recorded/... in
   *
@@ -75,11 +87,26 @@ export interface SCCreativeWork
   */
  authors?: SCPersonWithoutReferences[];

+  /**
+   * A creative work to which the creative work belongs
+   */
+  isPartOf?: SCCreativeWorkWithoutReferences;
+
+  /**
+   * List of events at which the creative work was published
+   */
+  publications?: SCPublicationEventWithoutReferences[];
+
  /**
   * List of publishers of the creative work
   */
  publishers?: Array<SCPersonWithoutReferences | SCOrganizationWithoutReferences>;

+  /**
+   * A text representing on organization on whose behalf the creator was working
+   */
+  sourceOrganization?: string;
+
  /**
   * Translated fields of the creative work
   */
@@ -111,22 +138,36 @@ export class SCCreativeWorkMeta
    de: {
      ...SCThingMeta.getInstance<SCThingMeta>().fieldTranslations.de,
      ...SCThingThatCanBeOfferedMeta.getInstance().fieldTranslations.de,
-      authors: 'Autoren',
+      name: 'Titel',
+      authors: 'beteiligte Personen',
      availableLanguages: 'verfügbare Übersetzungen',
      datePublished: 'Veröffentlichungsdatum',
+      edition: 'Ausgabe',
+      firstPublished: 'erste Veröffentlichung',
      inLanguage: 'Inhaltssprache',
+      isPartOf: 'erschienen in',
      keywords: 'Schlagwörter',
+      lastPublished: 'aktuellste Veröffentlichung',
      publishers: 'Verleger',
+      publications: 'Veröffentlichungen',
+      sourceOrganization: 'Körperschaft',
    },
    en: {
      ...SCThingMeta.getInstance<SCThingMeta>().fieldTranslations.en,
      ...SCThingThatCanBeOfferedMeta.getInstance().fieldTranslations.en,
-      authors: 'authors',
+      name: 'title',
+      authors: 'involved persons',
      availableLanguages: 'available languages',
      datePublished: 'release date',
+      edition: 'edition',
+      firstPublished: 'first published',
      inLanguage: 'content language',
+      isPartOf: 'published in',
      keywords: 'keywords',
+      lastPublished: 'last published',
      publishers: 'publishers',
+      publications: 'publications',
+      sourceOrganization: 'corporation',
    },
  };

@@ -136,7 +177,7 @@ export class SCCreativeWorkMeta
  fieldValueTranslations = {
    de: {
      ...SCThingMeta.getInstance<SCThingMeta>().fieldValueTranslations.de,
-      ...SCThingThatCanBeOfferedMeta.getInstance().fieldValueTranslations.en,
+      ...SCThingThatCanBeOfferedMeta.getInstance().fieldValueTranslations.de,
    },
    en: {
      ...SCThingMeta.getInstance<SCThingMeta>().fieldValueTranslations.en,
--- a/src/things/abstract/thing.ts
+++ b/src/things/abstract/thing.ts
@@ -13,6 +13,7 @@
 * this program. If not, see <https://www.gnu.org/licenses/>.
 */
 import {SCMetaTranslations, SCTranslations} from '../../general/i18n';
+import {SCMap} from '../../general/map';
 import {SCISO8601Date} from '../../general/time';
 import {SCUuid} from '../../general/uuid';
 import {SCOrganizationWithoutReferences} from '../organization';
@@ -25,6 +26,7 @@ export enum SCThingType {
  AcademicEvent = 'academic event',
  Article = 'article',
  Book = 'book',
+  Periodical = 'periodical',
  Building = 'building',
  Catalog = 'catalog',
  ContactPoint = 'contact point',
@@ -38,6 +40,7 @@ export enum SCThingType {
  Organization = 'organization',
  Person = 'person',
  PointOfInterest = 'point of interest',
+  PublicationEvent = 'publication event',
  Room = 'room',
  Semester = 'semester',
  Setting = 'setting',
@@ -60,6 +63,7 @@ export interface SCThingWithoutReferences {
   * @keyword
   */
  alternateNames?: string[];
+
  /**
   * Description of the thing
   *
@@ -67,12 +71,21 @@ export interface SCThingWithoutReferences {
   * @text
   */
  description?: string;
+
+  /**
+   * The identifier property represents any kind of additional identifier for any kind of SCThing
+   *
+   * E.g. GTIN codes, UUIDs, Database IDs etc.
+   */
+  identifiers?: SCMap<string>;
+
  /**
   * URL of an image of the thing
   *
   * @keyword
   */
  image?: string;
+
  /**
   * Name of the thing
   *
@@ -82,12 +95,21 @@ export interface SCThingWithoutReferences {
   * @text
   */
  name: string;
+
+  /**
+   * URL of a reference Web page that unambiguously indicates the item's identity
+   *
+   * E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website.
+   */
+  sameAs?: string;
+
  /**
   * Translations of specific values of the object
   *
   * Take precedence over "main" value for selected languages.
   */
  translations?: SCTranslations<SCThingTranslatableProperties>;
+
  /**
   * Type of the thing
   *
@@ -96,16 +118,11 @@ export interface SCThingWithoutReferences {
   * @aggregatable global
   */
  type: SCThingType;
+
  /**
   * Universally unique identifier of the thing
   */
  uid: SCUuid;
-  /**
-   * URL of the thing
-   * 
-   * @filterable
-   */
-  url?: string;
 }

 /**
@@ -252,7 +269,7 @@ export interface SCThingTranslatablePropertyOrigin {
 */
 export class SCThingMeta implements SCMetaTranslations<SCThing> {
  /**
-   * Set type definiton for singleton instance
+   * Set type definition for singleton instance
   */
  protected static _instance = new Map<string, unknown>();

@@ -263,24 +280,26 @@ export class SCThingMeta implements SCMetaTranslations<SCThing> {
    de: {
      alternateNames: 'alternative Namen',
      description: 'Beschreibung',
+      identifiers: 'Alternative Identifikation',
      image: 'Bild',
      name: 'Name',
      origin: 'Ursprung',
+      sameAs: 'ursprünglicher Link',
      translations: 'Übersetzungen',
      type: 'Typ',
      uid: 'Identifikation',
-      url: 'URL',
    },
    en: {
      alternateNames: 'alternate names',
      description: 'description',
+      identifiers: 'alternative identification',
      image: 'image',
      name: 'name',
      origin: 'origin',
+      sameAs: 'original link',
      translations: 'translations',
      type: 'type',
      uid: 'identification',
-      url: 'URL',
    },
  };

--- a/src/things/article.ts
+++ b/src/things/article.ts
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2019 StApps
+ * Copyright (C) 2019-2021 StApps
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the Free
 * Software Foundation, version 3.
@@ -21,25 +21,37 @@ import {
 } from './abstract/creative-work';
 import {SCThingMeta, SCThingType} from './abstract/thing';
 import {
-  SCThingWithCategories,
  SCThingWithCategoriesSpecificValues,
  SCThingWithCategoriesTranslatableProperties,
  SCThingWithCategoriesWithoutReferences,
  SCThingWithCategoriesWithoutReferencesMeta,
 } from './abstract/thing-with-categories';
+import {SCPeriodicalWithoutReferences} from './periodical';
+
+/**
+ * Categories of an article
+ */
+export type SCArticleCategories = 'unipedia'
+  | 'article'
+  | 'eArticle';

 /**
 * An article without references
 */
 export interface SCArticleWithoutReferences
  extends SCCreativeWorkWithoutReferences,
-    SCThingWithCategoriesWithoutReferences<SCArticleCategories, SCThingWithCategoriesSpecificValues> {
+  SCThingWithCategoriesWithoutReferences<SCArticleCategories, SCThingWithCategoriesSpecificValues> {
  /**
   * Article itself as markdown
   *
   * @text
   */
-  articleBody: string;
+  articleBody?: string;
+
+  /**
+   * Categories of an article
+   */
+  categories: SCArticleCategories[];

  /**
   * Translated fields of an article
@@ -59,8 +71,16 @@ export interface SCArticleWithoutReferences
 * @indexable
 */
 export interface SCArticle
-  extends SCCreativeWork, SCArticleWithoutReferences,
-    SCThingWithCategories<SCArticleCategories, SCThingWithCategoriesSpecificValues> {
+  extends SCCreativeWork, SCArticleWithoutReferences {
+  /**
+   * A periodical to which this article belongs
+   */
+  isPartOf?: SCPeriodicalWithoutReferences;
+  /**
+   * Additional information about how to find the article inside of its "parent" (which is provided in 'isPartOf')
+   * e.g. "40, 2011, S. 2-3"
+   */
+  reference?: string;
  /**
   * Translated fields of an article
   */
@@ -73,12 +93,7 @@ export interface SCArticle
 }

 /**
- * Categories of articles
- */
-export type SCArticleCategories = 'unipedia';
-
-/**
- * Translatable properties of creative works
+ * Translatable properties of an article
 */
 export interface SCArticleTranslatableProperties
  extends SCThingWithCategoriesTranslatableProperties, SCCreativeWorkTranslatableProperties {
@@ -103,14 +118,18 @@ export class SCArticleMeta
      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>().fieldTranslations
        .de,
      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCArticleCategories,
-        SCThingWithCategoriesSpecificValues>().fieldTranslations.de,
+      SCThingWithCategoriesSpecificValues>().fieldTranslations.de,
+      categories: 'Format',
+      reference: 'Referenz',
      articleBody: 'Artikelinhalt',
    },
    en: {
      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>().fieldTranslations
        .en,
      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCArticleCategories,
-        SCThingWithCategoriesSpecificValues>().fieldTranslations.en,
+      SCThingWithCategoriesSpecificValues>().fieldTranslations.en,
+      categories: 'format',
+      reference: 'reference',
      articleBody: 'article body',
    },
  };
@@ -122,19 +141,22 @@ export class SCArticleMeta
    de: {
      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>()
        .fieldValueTranslations.de,
-      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCArticleCategories,
-        SCThingWithCategoriesSpecificValues>().fieldValueTranslations.de,
      categories: {
-        'unipedia': 'Unipedia',
+        article: 'Artikel',
+        eArticle: 'E-Aufsatz',
+        unipedia: 'Unipedia',
      },
      type: 'Artikel',
    },
    en: {
      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>()
        .fieldValueTranslations.en,
-      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCArticleCategories,
-        SCThingWithCategoriesSpecificValues>().fieldValueTranslations.en,
      type: SCThingType.Article,
+      categories: {
+        article: 'article',
+        eArticle: 'E-Article',
+        unipedia: 'unipedia',
+      },
    },
  };
 }
--- a/src/things/book.ts
+++ b/src/things/book.ts
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2019 StApps
+ * Copyright (C) 2019-2021 StApps
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the Free
 * Software Foundation, version 3.
@@ -20,29 +20,52 @@ import {
  SCCreativeWorkWithoutReferences,
 } from './abstract/creative-work';
 import {SCThingMeta, SCThingType} from './abstract/thing';
-import {SCThingWithCategoriesTranslatableProperties} from './abstract/thing-with-categories';
-import {SCPersonWithoutReferences} from './person';
+import {
+  SCThingWithCategoriesSpecificValues,
+  SCThingWithCategoriesTranslatableProperties,
+  SCThingWithCategoriesWithoutReferences,
+  SCThingWithCategoriesWithoutReferencesMeta,
+} from './abstract/thing-with-categories';
+
+/**
+ * Categories of a book
+ */
+export type SCBookCategories = 'audio'
+  | 'book'
+  | 'cd'
+  | 'dvd'
+  | 'ePhoto'
+  | 'ebook'
+  | 'hierarchy'
+  | 'kit'
+  | 'manuscript'
+  | 'map'
+  | 'microfilm'
+  | 'musicalscore'
+  | 'photo'
+  | 'retro'
+  | 'sensorimage'
+  | 'unknown'
+  | 'video';

 /**
 * A book without references
 */
 export interface SCBookWithoutReferences
-  extends SCCreativeWorkWithoutReferences {
+  extends SCCreativeWorkWithoutReferences,
+  SCThingWithCategoriesWithoutReferences<SCBookCategories, SCThingWithCategoriesSpecificValues> {
  /**
-   * Edition of a book
-   *
-   * @filterable
-   * @keyword
+   * Categories of a book
   */
-  bookEdition?: string;
+  categories: SCBookCategories[];

  /**
-   * ISBN of a book
+   * ISBNs of a book
   *
   * @filterable
   * @keyword
   */
-  isbn?: string;
+  ISBNs?: string[];

  /**
   * Number of pages of a book
@@ -70,11 +93,6 @@ export interface SCBookWithoutReferences
 */
 export interface SCBook
  extends SCCreativeWork, SCBookWithoutReferences {
-  /**
-   * Authors of the creative work
-   */
-  authors: SCPersonWithoutReferences[];
-
  /**
   * Translated properties of a book
   */
@@ -91,12 +109,6 @@ export interface SCBook
 */
 export interface SCBookTranslatableFields
  extends SCThingWithCategoriesTranslatableProperties, SCCreativeWorkTranslatableProperties {
-  /**
-   * Translation of an edition of a book
-   *
-   * @keyword
-   */
-  bookEdition?: string;
 }

 /**
@@ -108,17 +120,19 @@ export class SCBookMeta extends SCThingMeta implements SCMetaTranslations<SCBook
   */
  fieldTranslations = {
    de: {
-      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>().fieldTranslations
-        .de,
-      bookEdition: 'Buchausgabe',
-      isbn: 'ISBN',
-      numberOfPages: 'Seitenzahl',
+      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>().fieldTranslations.de,
+      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCBookCategories,
+      SCThingWithCategoriesSpecificValues>().fieldTranslations.de,
+      categories: 'Format',
+      ISBNs: 'ISBN',
+      numberOfPages: 'Seitenanzahl',
    },
    en: {
-      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>().fieldTranslations
-        .en,
-      bookEdition: 'book edition',
-      isbn: 'ISBN',
+      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>().fieldTranslations.en,
+      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCBookCategories,
+      SCThingWithCategoriesSpecificValues>().fieldTranslations.en,
+      categories: 'format',
+      ISBNs: 'ISBN',
      numberOfPages: 'number of pages',
    },
  };
@@ -130,12 +144,56 @@ export class SCBookMeta extends SCThingMeta implements SCMetaTranslations<SCBook
    de: {
      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>()
        .fieldValueTranslations.de,
+      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCBookCategories,
+      SCThingWithCategoriesSpecificValues>().fieldValueTranslations.de,
+      categories: {
+        audio: 'Tonträger',
+        book: 'Buch',
+        cd: 'CD',
+        dvd: 'DVD',
+        ePhoto: 'E-Photo',
+        ebook: 'E-Book',
+        hierarchy: 'mehrteiliges Werk',
+        kit: 'Medienkombination',
+        manuscript: 'Handschrift',
+        map: 'Karte',
+        microfilm: 'Mikrofilm, Mikrofiche',
+        musicalscore: 'Noten',
+        photo: 'Abbildung',
+        physicalobject: 'Objekt',
+        retro: 'Retro (Buch)',
+        sensorimage: 'Blindenschrift',
+        unknown: 'Unbekannt',
+        video: 'Film',
+      },
      type: 'Buch',
    },
    en: {
      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>()
        .fieldValueTranslations.en,
+      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCBookCategories,
+      SCThingWithCategoriesSpecificValues>().fieldValueTranslations.en,
      type: SCThingType.Book,
+      categories: {
+        audio: 'audio material',
+        book: 'book',
+        cd: 'CD',
+        dvd: 'DVD',
+        ePhoto: 'E-Photo',
+        ebook: 'E-Book',
+        hierarchy: 'multipart item',
+        kit: 'media combination',
+        manuscript: 'manuscript',
+        map: 'map',
+        microfilm: 'microfilm, microfiche',
+        musicalscore: 'sheet music',
+        photo: 'illustration',
+        physicalobject: 'object',
+        retro: 'retro (book)',
+        sensorimage: 'braille',
+        unknown: 'unknown',
+        video: 'film',
+      },
    },
  };
 }
--- a/src/things/message.ts
+++ b/src/things/message.ts
@@ -22,14 +22,24 @@ import {
 } from './abstract/creative-work';
 import {SCThingMeta, SCThingType} from './abstract/thing';
 import {SCThingThatCanBeOfferedTranslatableProperties} from './abstract/thing-that-can-be-offered';
+import {
+  SCThingWithCategoriesSpecificValues,
+  SCThingWithCategoriesWithoutReferences, SCThingWithCategoriesWithoutReferencesMeta,
+} from './abstract/thing-with-categories';
 import {SCUserGroup} from './abstract/user-groups';
 import {SCOrganizationWithoutReferences} from './organization';

+/**
+ * Categories of a message
+ */
+export type SCMessageCategories = 'news';
+
 /**
 * A message without references
 */
 export interface SCMessageWithoutReferences
-  extends SCCreativeWorkWithoutReferences {
+  extends SCCreativeWorkWithoutReferences,
+  SCThingWithCategoriesWithoutReferences<SCMessageCategories, SCThingWithCategoriesSpecificValues> {
  /**
   * Organizational unit for which the message is intended
   */
@@ -42,6 +52,11 @@ export interface SCMessageWithoutReferences
   */
  audiences: SCUserGroup[];

+  /**
+   * Categories of a message
+   */
+  categories: SCMessageCategories[];
+
  /**
   * When the message was created
   *
@@ -117,6 +132,8 @@ export class SCMessageMeta
    de: {
      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>().fieldTranslations
        .de,
+      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCMessageCategories,
+      SCThingWithCategoriesSpecificValues>().fieldTranslations.de,
      audienceOrganizations: 'Zielgruppenorganisationen',
      audiences: 'Zielgruppen',
      dateCreated: 'Erstellungsdatum',
@@ -126,6 +143,8 @@ export class SCMessageMeta
    en: {
      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>().fieldTranslations
        .en,
+      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCMessageCategories,
+      SCThingWithCategoriesSpecificValues>().fieldTranslations.en,
      audienceOrganizations: 'audience organizations',
      audiences: 'audiences',
      dateCreated: 'date created',
@@ -142,9 +161,12 @@ export class SCMessageMeta
      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>()
        .fieldValueTranslations.de,
      audiences: {
-        'employees': 'Angestellte',
-        'guests': 'Gäste',
-        'students': 'Studenten',
+        employees: 'Angestellte',
+        guests: 'Gäste',
+        students: 'Studenten',
+      },
+      categories: {
+        news: 'Neuigkeiten',
      },
      type: 'Nachricht',
    },
--- a/src/things/periodical.ts
+++ b/src/things/periodical.ts
@@ -0,0 +1,137 @@
+/*
+ * Copyright (C) 2021 StApps
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the Free
+ * Software Foundation, version 3.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import {SCMetaTranslations, SCTranslations} from '../general/i18n';
+import {
+  SCCreativeWork,
+  SCCreativeWorkMeta,
+  SCCreativeWorkTranslatableProperties,
+  SCCreativeWorkWithoutReferences,
+} from './abstract/creative-work';
+import {SCThingMeta, SCThingType} from './abstract/thing';
+import {
+  SCThingWithCategoriesSpecificValues,
+  SCThingWithCategoriesTranslatableProperties,
+  SCThingWithCategoriesWithoutReferences,
+  SCThingWithCategoriesWithoutReferencesMeta,
+} from './abstract/thing-with-categories';
+
+/**
+ * Categories of a periodical
+ */
+export type SCPeriodicalCategories = 'journal' | 'electronic';
+
+/**
+ * A periodical without references
+ */
+export interface SCPeriodicalWithoutReferences
+  extends SCCreativeWorkWithoutReferences,
+  SCThingWithCategoriesWithoutReferences<SCPeriodicalCategories, SCThingWithCategoriesSpecificValues> {
+  /**
+   * Categories of a periodical
+   */
+  categories: SCPeriodicalCategories[];
+  /**
+   * A list of ISSNs of a periodical
+   *
+   * @filterable
+   * @keyword
+   */
+  ISSNs?: string[];
+
+  /**
+   * Translated properties of a periodical
+   */
+  translations?: SCTranslations<SCPeriodicalTranslatableFields>;
+
+  /**
+   * Type of a periodical
+   */
+  type: SCThingType.Periodical;
+}
+
+/**
+ * A publication published at regular intervals (e.g. a magazine or newspaper)
+ *
+ * @validatable
+ * @indexable
+ */
+export interface SCPeriodical
+  extends SCCreativeWork, SCPeriodicalWithoutReferences {
+  /**
+   * Translated properties of a periodical
+   */
+  translations?: SCTranslations<SCPeriodicalTranslatableFields>;
+
+  /**
+   * Type of a periodical
+   */
+  type: SCThingType.Periodical;
+}
+
+/**
+ * Translatable properties of a periodical
+ */
+export interface SCPeriodicalTranslatableFields
+  extends SCThingWithCategoriesTranslatableProperties, SCCreativeWorkTranslatableProperties {
+}
+
+/**
+ * Meta information about a periodical
+ */
+export class SCPeriodicalMeta extends SCThingMeta implements SCMetaTranslations<SCPeriodical> {
+  /**
+   * Translations of fields
+   */
+  fieldTranslations = {
+    de: {
+      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>().fieldTranslations.de,
+      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCPeriodicalCategories,
+      SCThingWithCategoriesSpecificValues>().fieldTranslations.de,
+      categories: 'Format',
+      ISSNs: 'ISSN',
+    },
+    en: {
+      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>().fieldTranslations.en,
+      ...SCThingWithCategoriesWithoutReferencesMeta.getInstance<SCPeriodicalCategories,
+      SCThingWithCategoriesSpecificValues>().fieldTranslations.en,
+      categories: 'format',
+      ISSNs: 'ISSN',
+    },
+  };
+
+  /**
+   * Translations of values of fields
+   */
+  fieldValueTranslations = {
+    de: {
+      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>()
+        .fieldValueTranslations.de,
+      type: 'Periodikum',
+      categories: {
+        electronic: 'E-Journal',
+        journal: 'Zeitschrift',
+      },
+    },
+    en: {
+      ...SCCreativeWorkMeta.getInstance<SCCreativeWorkMeta>()
+        .fieldValueTranslations.en,
+      type: 'periodical',
+      categories: {
+        electronic: 'E-Journal',
+        journal: 'journal',
+      },
+    },
+  };
+}
--- a/src/things/person.ts
+++ b/src/things/person.ts
@@ -57,7 +57,7 @@ export interface SCPersonWithoutReferences
   * @filterable
   * @keyword
   */
-  familyName: string;
+  familyName?: string;

  /**
   * The private fax number of the person.
@@ -80,7 +80,7 @@ export interface SCPersonWithoutReferences
   * @filterable
   * @keyword
   */
-  givenName: string;
+  givenName?: string;

  /**
   * Honorific prefix of the person.
--- a/src/things/publication-event.ts
+++ b/src/things/publication-event.ts
@@ -0,0 +1,105 @@
+/*
+ * Copyright (C) 2021 StApps
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the Free
+ * Software Foundation, version 3.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import {SCMetaTranslations, SCTranslations} from '../general/i18n';
+import {SCEvent, SCEventMeta, SCEventWithoutReferences} from './abstract/event';
+import {SCThingMeta, SCThingTranslatableProperties, SCThingType} from './abstract/thing';
+
+/**
+ * An publication event without references
+ */
+export interface SCPublicationEventWithoutReferences
+  extends SCEventWithoutReferences {
+  /**
+   * All the locations related to the event (e.g. where a creative work was published)
+   */
+  locations?: string[];
+
+  /**
+   * An organization (or a person) that is publishing at the event
+   */
+  publisher?: string;
+
+  /**
+   * Translated fields of an publication event
+   */
+  translations?: SCTranslations<SCPublicationEventTranslatableProperties>;
+
+  /**
+   * Type of an publication event
+   */
+  type: SCThingType.PublicationEvent;
+}
+
+/**
+ * An publication event
+ *
+ * @validatable
+ * @indexable
+ */
+export interface SCPublicationEvent
+  extends SCEvent, SCPublicationEventWithoutReferences {
+  /**
+   * Translated fields of an publication event
+   */
+  translations?: SCTranslations<SCPublicationEventTranslatableProperties>;
+
+  /**
+   * Type of an publication event
+   */
+  type: SCThingType.PublicationEvent;
+}
+
+/**
+ * Translatable properties of an publication event
+ */
+export interface SCPublicationEventTranslatableProperties extends SCThingTranslatableProperties {
+}
+
+/**
+ * Meta information about publication events
+ */
+export class SCPublicationEventMeta
+  extends SCThingMeta
+  implements SCMetaTranslations<SCPublicationEvent> {
+  /**
+   * Translations of fields
+   */
+  fieldTranslations = {
+    de: {
+      ...SCEventMeta.getInstance<SCEventMeta>().fieldTranslations.de,
+      locations: 'Erscheinungsorte',
+      publisher: 'Verlag',
+    },
+    en: {
+      ...SCEventMeta.getInstance<SCEventMeta>().fieldTranslations.en,
+      locations: 'places of publication',
+      publisher: 'publisher',
+    },
+  };
+
+  /**
+   * Translations of values of fields
+   */
+  fieldValueTranslations = {
+    de: {
+      ...SCEventMeta.getInstance<SCEventMeta>().fieldValueTranslations.de,
+      type: 'Veröffentlichung',
+    },
+    en: {
+      ...SCEventMeta.getInstance<SCEventMeta>().fieldValueTranslations.en,
+      type: 'publication event',
+    },
+  };
+}