Entity · unit_progress

Unit Progress Schema

Schema-ID

unit_progress

Collection

unit_progress

Permissions

Lesenunit_progress_view
Anlegenunit_progress_create
Ändernunit_progress_edit
Löschenunit_progress_delete

Beziehungen

courseId → course

Felder

Unit Progress Schema

unit_progress4 Permissions

Schema for tracking student progress per learning unit

enrollmentIdstringerforderlich

ID of the student enrollment

min 1 Zeichen

learningUnitIdstringerforderlich

ID of the learning unit

min 1 Zeichen

lessonIdstringerforderlich

ID of the parent lesson/section (denormalized)

min 1 Zeichen

courseIdstringerforderlich

ID of the parent course (denormalized)

min 1 Zeichen

userIdstringerforderlich

ID of the student

min 1 Zeichen

statusstringerforderlich

Current progress status for this unit

Werte

not_startedin_progresscompletedrequires_approval

videoProgressSecsnumberoptional

Furthest video position watched in seconds

≥ 0nullable

videoTotalSecsnumberoptional

Total video duration in seconds

≥ 0nullable

textScrollPercentnumberoptional

Furthest scroll depth reached in text content (0-100)

0 – 100nullable

viewedSlideIdsstring[]optional

Stable ids of the slides the learner has viewed (type: slides units)

nullable

timeSpentSecsnumberoptional

Total time spent on this unit in seconds

≥ 0nullable

lastAccessedAtdatetimeoptional

Last time the student accessed this unit

nullable

completedAtdatetimeoptional

When the unit was completed

nullable

bestScorenumberoptional

Best quiz/exam score across all attempts

0 – 100nullable

attemptCountnumberoptional

Number of quiz/exam attempts made

≥ 0nullable

fileSubmissionIdsstring[]optional

IDs of the uploaded file submissions

fileSubmittedAtdatetimeoptional

When the file was submitted

nullable

requirementsMetbooleanoptional

Whether all completion requirements have been fulfilled

nullable

reviewFeedbackstringoptional

Instructor feedback text for the file submission

nullable

reviewScorenumberoptional

Manual score assigned by instructor (0-100)

0 – 100nullable

reviewedBystringoptional

User ID of the instructor who reviewed

nullable

reviewedAtdatetimeoptional

When the instructor review was completed

nullable

rejectedAtdatetimeoptional

When the submission was rejected

nullable

rejectionReasonstringoptional

Reason for rejection

nullable

rejectionCountnumberoptional

Number of times this submission has been rejected

≥ 0nullable

aiReviewFeedbackstringoptional

AI-generated feedback for the file submission

nullable

aiReviewScorenumberoptional

AI-suggested score (0-100)

0 – 100nullable

aiReviewConfidencenumberoptional

AI confidence level (0.0-1.0)

0 – 1nullable

aiReviewedAtdatetimeoptional

When the AI review was completed

nullable

aiReviewStatusstringoptional

Current status of the AI review

Werte

pendingcompletedfailed

nullable

extraAttemptsGrantednumberoptional

Number of additional attempts granted by instructor beyond maxAttempts

≥ 0nullable

extraAttemptsGrantedBystringoptional

User ID of the instructor who granted extra attempts

nullable

extraAttemptsGrantedAtdatetimeoptional

When extra attempts were last granted

nullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

GET /api/v1/unit_progress — Liste, paginiert + filterbar
GET /api/v1/unit_progress/<id> — Einzelne Entity
POST /api/v1/unit_progress — Anlegen
PATCH /api/v1/unit_progress/<id> — Teil-Update
DELETE /api/v1/unit_progress/<id> — Soft-Delete
GET /api/v1/unit_progress/<id>/timeline — Audit + Aktivitäten