Skip to main content

Organisation

The Organisation group manages the institutional structure and how users are scoped.

Institutions​

Institutions are the top-level organisational unit. Each institute has its own PostgreSQL schema, EMS environments, faculties, identity providers and exam data.

Institutes are created with a server command that provisions the schema, routing and data in one step:

python manage.py add_tenant <slug> "<Name>"

This creates the PostgreSQL schema, the subfolder route (/<slug>/...) and the institute record.

From Organisation → Institutions you can edit:

  • Name: human-readable name
  • Timezone: IANA timezone (default Europe/Amsterdam)
  • Default identity provider: OIDC provider used at login
  • Institute ID: read-only, set at creation

Faculties​

Faculties subdivide an institute so exams and results can be grouped, and teachers can be scoped to their own faculty.

  1. Go to Organisation → Faculties → Add
  2. Fill in:
    • Code: short identifier matching the OIDC claim (e.g. CS, MATH)
    • Name: human-readable name (e.g. "Computer Science")
  3. Save
Faculty isolation

Faculties are unique per institute. The same code may exist in different institutes, each in its own schema. Assign a faculty to an exam (optional) or to a teacher; the code is matched against the institute's OIDC claim to scope teachers to a faculty.