Skip to content
aYOUne
Not in your language

This page is not yet available in en. You're reading the de version.

@tolinax/ayoune-core

Stand: Commit 4876d41 · 2026-09-27

Der Kern prüft bei jedem Aufruf Anmeldung, Recht und Mandant, begrenzt die Aufruf-Rate, meldet Fehler als Aufgaben und trägt neue Bereiche in Rollen und Menü ein; ein Administrator begegnet ihm in Rollen, Menü, Aufgaben und Feature-Schaltern.

Funktionen

  • Rechteprüfung – Jeder Aufruf wird gegen Rolle, Zusatzrechte und die gebuchten Bereiche des Mandanten geprüft.
  • Bereiche melden sich selbst an – Ein neuer Bereich trägt seine Rechte in die Administrator-Rolle und seine Ansichten in das Menü ein, sobald er das erste Mal läuft.
  • Fehler als Aufgaben – Laufzeitfehler landen als Aufgabe vom Typ Fehler im Projektmanagement des Mandanten.
  • Aufruf-Begrenzung – Je angemeldetem Nutzer und je Absenderadresse gilt eine Obergrenze an Aufrufen pro Stunde.
  • Feature-Schalter – Bereiche lesen Schalter, die ein Verhalten an- oder abschalten; Änderungen wirken innerhalb einer Minute.

Zweck

Der Kern ist der gemeinsame Unterbau aller Bereiche. Er prüft bei jedem Aufruf, ob der Nutzer angemeldet ist, ob seine Rolle das Recht trägt und ob der Datensatz zu seinem Mandanten gehört. Für Ihr Unternehmen heißt das: Rechte, Mandantentrennung und Fehlerbehandlung funktionieren in jedem Bereich gleich.

Sie richten den Kern nicht ein. Sie begegnen ihm in Rollen, Menü, Feature-Schaltern und in den Aufgaben, die er bei Fehlern anlegt.

Einrichten

Es gibt nichts einzurichten. Zwei Dinge geschehen von selbst, wenn ein Bereich für Ihren Mandanten das erste Mal läuft:

  1. Die Rechte des Bereichs werden in die Rolle „Administrator" eingetragen. Ihre Administratoren sehen den neuen Bereich sofort; alle anderen Rollen erhalten die Rechte erst, wenn Sie sie dort ergänzen.
  2. Die Ansichten des Bereichs erscheinen im Menü Ihres Mandanten. Untergeordnete Funktionen innerhalb eines Bereichs trägt der Kern nicht ein; sie werden über die Menüpflege ergänzt.

Feature-Schalter finden Sie in den Einstellungen unter „Feature-Flags". Jeder Bereich meldet dort die Schalter an, die er kennt; ein Schalter ohne diese Anmeldung hat keine Wirkung.

Rollen und Rechte

Ein Nutzer darf einen Aufruf ausführen, wenn zwei Bedingungen zugleich gelten: seine Rolle oder seine Zusatzrechte tragen das Recht, und Ihr Mandant hat den Bereich über ein Paket oder eine Zusatzfreigabe gebucht. Ein Recht in einer Rolle, das Ihr Paket nicht abdeckt, bleibt wirkungslos.

Rechte gelten je Ansicht und Aktion, nicht je Feld. Wer eine Entität bearbeiten darf, darf alle ihre Felder bearbeiten.

Laufender Betrieb

Aufruf-Begrenzung. Je angemeldetem Nutzer sind 2.500 Aufrufe pro Stunde vorgesehen, je Absenderadresse ohne Anmeldung 3.600. Wer darüber liegt, erhält für den Rest der Stunde eine Ablehnung mit Wartezeit. Die Werte kann der Betreiber je Umgebung anpassen.

Fehler als Aufgaben. Tritt in einem Bereich ein Fehler auf, legt der Kern eine Aufgabe vom Typ „Bug" im Projektmanagement Ihres Mandanten an; gleiche Fehler werden zusammengefasst. Dort sehen Sie, ob ein Bereich Probleme hat, ohne auf Rückmeldungen Ihrer Nutzer zu warten. Tritt ein Fehler wiederholt auf, geben Sie die Aufgabe an den Support.

Feature-Schalter. Der Kern liest die Schalter alle 60 Sekunden neu. Eine Änderung wirkt deshalb bis zu einer Minute verzögert.

Störungen

Ein Nutzer sieht einen Bereich nicht, obwohl seine Rolle das Recht trägt. Der Bereich ist für Ihren Mandanten nicht gebucht. Prüfen Sie Ihre Pakete und Zusatzfreigaben.

Ein neuer Bereich fehlt in einer Rolle. Nur „Administrator" wird automatisch befüllt. Ergänzen Sie das Recht in den übrigen Rollen.

Nutzer erhalten die Meldung, dass zu viele Aufrufe gestellt wurden. Die Stundengrenze ist erreicht. Die Sperre endet mit der laufenden Stunde; die Meldung nennt die Wartezeit.

Eine Änderung an einem Feature-Schalter wirkt nicht. Warten Sie eine Minute. Wirkt sie dann noch nicht, hat der Bereich den Schalter nicht angemeldet; prüfen Sie den Namen in der Liste der angemeldeten Schalter.

Glossar

  • Bereich – Ein Fachmodul der Plattform, etwa Kontakte, Marketing oder Buchhaltung.
  • Zusatzrecht – Ein Recht, das einem einzelnen Nutzer oder Mandanten außerhalb einer Rolle zugewiesen ist.
  • Feature-Schalter – Eine benannte Einstellung, mit der ein Verhalten der Plattform für einen Mandanten an- oder abgeschaltet wird.

Work with this page

Ready-made instructions for your AI tool. Copy, paste, go — the AI fetches the content itself via the address in the text.

Summarise the steps for me The essentials, in the right order.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/tolinax-ayoune-core.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Summarise the content for me.

- First, in two sentences: what is this about?
- Then the steps in the order I need to take them.
- One line per step, in plain language.
- At the end: what I should have ready beforehand.

Leave out nothing I need in order to actually finish.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Explain what I need this for What it is good for — and when it is worth it.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/tolinax-ayoune-core.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Explain to me what I need this for.

1. Which problem does it solve? In one sentence, from my point of view.
2. Three typical situations in which it genuinely helps me.
3. When I do NOT need it — that saves me time.
4. What I can do instead if it is not a fit.

Stick to what the source says. Where it gives nothing, say so openly instead
of guessing.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Help me set this up Step by step, asking me as you go.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/tolinax-ayoune-core.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Walk me through the setup step by step.

- First tell me what I need to have ready (access, data, time).
- Then take me through ONE step at a time. Wait for my "next".
- For each step, say how I can tell that it worked.
- If something goes wrong, ask me for the exact message instead of guessing.

If the instructions leave a point open, tell me so rather than inventing it.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Help me with a problem Narrow down the cause instead of guessing.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/tolinax-ayoune-core.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Help me narrow down a problem.

- First ask me what I observe and what I expected instead.
- From that, derive the most likely causes consistent with this source.
- For each cause, give me ONE test that confirms or rules it out.
- Order them so the cheapest test comes first.

Do not guess. If the source does not cover the problem, tell me where I should
look next.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
Explain it in plain words No jargon, from the ground up.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/tolinax-ayoune-core.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Explain the content so that someone without prior knowledge understands it.

- Start with the purpose: why does this exist at all?
- Explain technical terms in half a sentence on first use.
- One everyday comparison where it genuinely holds — none where it limps.
- At the end: the three things worth remembering.

Do not shorten by dropping conditions. A simplification that hides a
prerequisite is a false statement.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.
A checklist to tick off To follow along while you do it.
Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/tolinax-ayoune-core.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Turn this into a **tick-off checklist** for practical use.

- Exactly one action per item, in the imperative.
- Order it so that no item depends on a later prerequisite.
- Prerequisites and pitfalls as indented sub-items.
- End with an acceptance step: how do I know everything is right?
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.

Was this article helpful?

👎 No (0)
Leave a comment