Schnittstellen

Entitäten und Beziehungen

Schemaversion: 1. Quelle: app/entities/schema.py.

REST: /api/schema, /api/schema/{kind}, /api/entities/{kind} und /api/entities/{kind}/{id}. Listen akzeptieren q, offset und limit. CLI: unios schema, unios describe, unios entity. MCP: get_entity_schema gibt nur den Vertrag zurück, keine Studiendaten. get_weekly_study_context(course_id, days) liefert für einen freigegebenen Kurs aktuelle Materialverweise und offene Aufgaben. Materialtexte können anschließend mit get_resource_text pro Quelle gelesen werden. Kurs-, Material- und Fristenfreigaben gelten auch für diesen Überblick.

Kurs (course)

Kennung: integer. Fähigkeiten: read, list, search, relate, unlink.

| Feld | Typ | Beschreibung | | --- | --- | --- | | id | integer | Stabile Kennung | | name | string | Anzeigename | | short_name | string | Kurzname | | semester_id | integer | Semester |

Material (resource)

Kennung: integer. Fähigkeiten: read, list, search, relate, unlink.

| Feld | Typ | Beschreibung | | --- | --- | --- | | id | integer | Stabile Kennung | | name | string | Anzeigename | | course_id | integer | Kurs | | kind | string | Art |

Schnellerfassung (jot)

Kennung: uuid. Fähigkeiten: read, list, search, relate, unlink.

| Feld | Typ | Beschreibung | | --- | --- | --- | | id | string | Stabile Kennung | | body | string | Anzeigename | | course_id | integer | Kurs | | kind | string | Art |

Notiz (note)

Kennung: uuid. Fähigkeiten: read, list, search, relate, unlink.

| Feld | Typ | Beschreibung | | --- | --- | --- | | id | string | Stabile Kennung | | title | string | Anzeigename | | course_id | integer | Kurs | | current_revision | integer | Version |

Projekt (project)

Kennung: integer. Fähigkeiten: read, list, search, relate, unlink.

| Feld | Typ | Beschreibung | | --- | --- | --- | | id | integer | Stabile Kennung | | name | string | Anzeigename | | course_id | integer | Kurs | | deadline_at | datetime | Frist |

Lernthema (topic)

Kennung: integer. Fähigkeiten: read, list, search, relate, unlink.

| Feld | Typ | Beschreibung | | --- | --- | --- | | id | integer | Stabile Kennung | | name | string | Anzeigename | | course_id | integer | Kurs | | slug | string | Kurzform |

Aufgabe (assignment)

Kennung: integer. Fähigkeiten: read, list, search, relate, unlink.

| Feld | Typ | Beschreibung | | --- | --- | --- | | id | integer | Stabile Kennung | | title | string | Anzeigename | | course_id | integer | Kurs | | due_at | datetime | Frist |

Prüfung (exam)

Kennung: integer. Fähigkeiten: read, list, search, relate, unlink.

| Feld | Typ | Beschreibung | | --- | --- | --- | | id | integer | Stabile Kennung | | title | string | Anzeigename | | course_id | integer | Kurs | | exam_at | datetime | Termin |

Übung (exercise)

Kennung: integer. Fähigkeiten: read, list, search, relate, unlink.

| Feld | Typ | Beschreibung | | --- | --- | --- | | id | integer | Stabile Kennung | | question | string | Anzeigename | | topic_id | integer | Lernthema |

Beziehungen

| Typ | Hinweg | Rückweg | | --- | --- | --- | | related | verknüpft mit | verknüpft mit | | prerequisite | Voraussetzung für | setzt voraus | | explains | erklärt | wird erklärt durch | | exercise_for | ist Übung zu | hat Übung | | part_of | ist Teil von | enthält | | duplicate | ist Duplikat von | ist Duplikat von | | prepares_for | bereitet vor auf | wird vorbereitet durch |

Beziehungen sind gerichtet, außer related und duplicate. Eingehende Kanten erscheinen automatisch als Rückverweise. unios relate und unios unlink verlangen --yes; --dry-run prüft nur die beabsichtigte Änderung.