# Academy

> Internal courses with levels, lessons and quizzes. Authors create a course in a conversation with the AI Assistant, review it and publish it. Learners work through it level by level and build competency scores.

The Academy is the training inside nexxus. A course leads level by level through lessons and quizzes, for example a course on your internal processes for new colleagues, built from the documents you already have. The next level opens only when the quizzes of the previous one are passed, and the answers give each person a score per competency.

Courses come out of a conversation with the AI Assistant: it researches your sources and proposes the course, and you review it before anyone else sees it. While people learn, it explains the units, gives examples and quizzes them.

## Before you start

- The Academy is under <MenuPath to="Start > Academy" /> (address `/academy`), next to Workspace and Apps.
- Your tenant needs the area <Ui>Apps & workspace</Ui>. An administrator switches it on under <MenuPath to="Administration > Operations > Setup" /> in the step <Ui>Areas</Ui>. When it is off, Academy, Workspace and Apps are all missing.
- To create courses in conversation and to ask questions while learning, the [AI Assistant](/use/assistant/) must be set up and you must be allowed to use it.

Four permissions decide what you can do in the Academy:

| Permission | In the app | What it opens |
|---|---|---|
| `academy.course.read` | <Ui>Academy: courses</Ui> › <Ui>Read (management)</Ui> | The Academy page and all published courses |
| `academy.enrollment.read` | <Ui>Academy: learning</Ui> › <Ui>Read (management)</Ui> | Your own progress |
| `academy.enrollment.write` | <Ui>Academy: learning</Ui> › <Ui>Write</Ui> | Taking courses: completing lessons and answering quizzes |
| `academy.course.write` | <Ui>Academy: courses</Ui> › <Ui>Write</Ui> | Creating, changing and publishing courses, seeing drafts and solutions |

Learners need the first three, authors the fourth as well. Administrators have all four. The role templates of the setup do not include them: for everyone else, an administrator adds them to a role under <MenuPath to="Administration > Users & access > Access Roles" />.

## How a course is built

A course names its **competencies**, meaning what people should be able to do afterwards, and consists of **levels**. Each level has a title, a goal and **units** of two kinds:

- A **lesson** is a text with a reading time and sources.
- A **quiz** asks questions with several answers to choose from. Each question belongs to a competency and has an explanation you see after answering. A quiz is passed from the mark it sets itself, usually 70 %.

## Work through a course

<Steps>

1. Open <MenuPath to="Start > Academy" />. Under <Ui>Courses</Ui> you find every published course with its audience, number of units, duration and your progress. What you have not started yet shows <Ui>Not started</Ui>.

2. Click a course. The course page shows the levels with their units, along with <Ui>Your progress</Ui> and <Ui>Competencies</Ui>.

3. Open a lesson, read the text and click <Ui>Read, continue</Ui>. On a unit you have already completed, the button is called <Ui>Next</Ui>.

4. In a quiz, choose one answer per question and click <Ui>Check answers</Ui>. You see for each question whether it was right, with its explanation.

5. The result appears below the questions, for example <Ui>Passed (from 70 %).</Ui> or <Ui>Not passed, 70 % needed. Read the explanations and try again.</Ui> <Ui>Try again</Ui> restarts the quiz, <Ui>Next</Ui> goes to the next unit. After the last unit, <Ui>Back to course</Ui> returns to the course page.

6. Once all lessons are read and all quizzes passed, the course shows <Ui>Course completed</Ui>.

</Steps>

## How levels and competencies count

- **Levels:** Level 1 is always open. Each further level opens as soon as all quizzes of the level before it are passed. A later, worse attempt never locks a level that has opened.
- **Competencies:** The score is the <Ui>Share of correct answers in the latest attempt of each quiz.</Ui> A new attempt can therefore lower it too.
- **Who sees what:** Each person sees progress and results for themselves only. The Academy has no overview of who completed which course.

## Create a course with the AI Assistant

You need `academy.course.write` for this.

<Steps>

1. In the Academy, click <Ui>Create course with AI Assistant</Ui>. The AI Assistant opens.

2. Describe what your team should learn. It clarifies topic, audience, prior knowledge and depth, with at most three questions at once.

3. It researches your tenant's sources and shows you an outline of competencies and levels. Then it waits for your agreement.

4. When you agree, it proposes the course on a confirmation card. Confirm the card. The course is created as a draft, for example with <Ui>Course “Privacy in daily work” created as a draft.</Ui>

5. Open the draft and go through the units in preview. There you see <Ui>Preview of a draft: answers only count once the course is published.</Ui>

6. If something should change, click <Ui>Revise with AI Assistant</Ui> and say what should be different.

7. Click <Ui>Publish</Ui>. nexxus checks that the course is complete and reports, the first time, <Ui>Published as version 1.</Ui>

</Steps>

Drafts are listed in the overview under <Ui>Drafts</Ui>, and only authors see them. You may save a half-finished draft; the check runs only when you publish.

The AI Assistant enters in each unit where the content comes from, and writes <Ui>Allgemeinwissen</Ui> (general knowledge) where it uses no source of your tenant. You find this in the unit under <Ui>Sources</Ui>. Its target for a course is 2 to 6 competencies and 2 to 5 levels, with 1 to 3 lessons per level and one quiz of 3 to 6 questions. Tell it if you need something else, this is no fixed limit.

## Change a published course

Published courses are read-only. To change one:

<Steps>

1. Open the course and click <Ui>Withdraw</Ui>. nexxus reports <Ui>Withdrawn. The course is a draft again.</Ui> From now on only authors see it.

2. Change it with <Ui>Revise with AI Assistant</Ui>.

3. Click <Ui>Publish</Ui>. The version goes up by one.

</Steps>

Learners' results stay when a course is withdrawn and carry the version they were earned on. They belong to the units: if a unit is replaced rather than changed, the result for it is lost. The AI Assistant therefore keeps the units that stay.

## Learn with the AI Assistant

On the overview and the course page, <Ui>Ask AI Assistant</Ui> opens the conversation; on a unit the button is called <Ui>Ask AI Assistant about this unit</Ui>. It is the same AI Assistant as everywhere in nexxus, with one conversation across all three pages. It knows which unit you have open and offers questions such as <Ui>Explain it more simply</Ui>, <Ui>Quiz me</Ui> or <Ui>Give me an example from our daily work</Ui>.

In a quiz it gives hints, but no solution before you have answered. It does not record quiz results, only you do that. It acts with your permissions: without `academy.course.write` it creates no course.

## What happens behind the scenes

- Quizzes are scored on the server. Correct answers and explanations leave it only with the result of your answer.
- Courses belong to a tenant. A course of another tenant opens only for a SUPERADMIN, not for an ADMIN.

## When something goes wrong

Messages from the server exist in German only. Their meaning is in the right-hand column.

| What you see | What it means |
|---|---|
| <Ui>Academy</Ui> is missing from the menu | You lack `academy.course.read`, or the area <Ui>Apps & workspace</Ui> is switched off. If Workspace and Apps are missing too, it is the area. |
| <Ui>No courses yet</Ui> | Nothing is published for you yet. With `academy.course.write` you can create the first course here. |
| <Ui>The Academy could not be loaded.</Ui> | The server did not answer. Reload the page. |
| <Ui>Dieses Level ist noch gesperrt. Erst die Quizze des vorigen Levels bestehen.</Ui> | This level is still locked: the previous level has a quiz that is not passed yet. |
| <Ui>This unit does not exist in this course.</Ui> | The link points to a unit the course no longer has. Open the course from the Academy. |
| <Ui>Veröffentlichte Kurse sind schreibgeschützt. Zurückziehen, bearbeiten und neu veröffentlichen.</Ui> | Published courses are read-only. Withdraw the course first, see above. |
| <Ui>Der Kurs ist noch nicht vollständig</Ui> | The course is not complete yet: publishing found gaps, the table below lists them. |

The notes when publishing:

| Note | What to do |
|---|---|
| <Ui>Mindestens eine Kompetenz</Ui> | The course names no competency. |
| <Ui>Mindestens ein Level</Ui> | The course has no level. |
| <Ui>Level ohne Titel</Ui>, <Ui>Einheit ohne Titel</Ui> | A title is missing. |
| <Ui>Level ohne Einheiten</Ui> | A level is empty. |
| <Ui>Jedes Level braucht ein Quiz, sonst öffnet sich das nächste nie</Ui> | Add a quiz to this level, otherwise the next one never opens. |
| <Ui>Lerntext fehlt</Ui> | A lesson has no text. |
| <Ui>Quiz ohne Fragen</Ui>, <Ui>Frage ohne Text</Ui> | A quiz has no questions, or a question has no text. |
| <Ui>Unbekannte Kompetenz</Ui> followed by its name | A question belongs to a competency the course does not name. |

The quickest way to close these gaps is <Ui>Revise with AI Assistant</Ui>: tell it the note.

## Next steps

<CardGrid>
  <LinkCard title="Work with the AI Assistant" href="/use/assistant/" description="How conversations, confirmation cards and sources work." />
  <LinkCard title="Permissions" href="/reference/permissions/" description="All permissions, grouped by area as in the role editor." />
</CardGrid>