AP1 Trainer

Lern-App für die IHK-Abschlussprüfung Teil 1 der IT-Berufe — nach dem Prüfungskatalog ab 2025 (2. überarbeitete Auflage, erstmals angewendet Frühjahr 2025).

Deckt alle sieben Katalogbereiche ab, von Projektmanagement über Netzwerke und Softwareentwicklung bis IT-Sicherheit, Datenschutz und Vertragsrecht. Zwei Lernwege pro Thema: Karteikarten (Leitner-System) für den Einstieg, Übungsaufgaben mit begründetem Feedback für die Vertiefung.

Flutter (Web, Android, iOS aus einer Codebase) + Supabase. Läuft ohne Backend-Konfiguration sofort los — alle Inhalte sind in der App eingebaut, Supabase ist ein optionaler Aufsatz.

Bereich	Themen	Anteil
01 Projekte & Projektmanagement	8	22 %
02 Kundenbeziehungen & Kommunikation	5	13 %
03 Informations- & Softwaresysteme	4	18 %
04 Analyse & Entwicklung von Systemen	8	22 %
05 Qualitätssicherung	2	7 %
06 IT-Sicherheit & Datenschutz	4	12 %
07 Vertragsmanagement & Service	4	6 %

Bereichsnummern und -namen folgen dem amtlichen Katalog. Die Aufteilung in Themen darunter ist eine fachliche Rekonstruktion — die amtlichen Unterkapitel-Titel sind nicht frei veröffentlicht. Die Prozentwerte sind geschätzte Punkteanteile zur Lernsteuerung, keine IHK-Angabe.

---

Was 2025 gestrichen wurde

Der Katalog hat Themen entfernt: SQL und Datenbankabfragen (nach AP2 verschoben), alle Vorgehensmodelle außer Wasserfall und Scrum, Struktogramm und PAP, Vererbung, RAID/SAN, LTE/5G, SWOT-Analyse, ISO-Normen, nicht-relationale Datenbanken, Dokumentationsarten.

Die App zeigt diese Liste unter Katalog → Symbol oben rechts und stellt ihr die neuen Themen gegenüber (KI-Unterstützung, SMART, Schutzziele, Hashverfahren und 2FA, Härtung, Barrierefreiheit, ERP/SCM/CRM, IPv4/IPv6, UML-Aktivitätsdiagramm, Schreibtischtest, Betroffenenrechte, Anonymisierung, Datenmengen berechnen, HDD vs. SSD).

Aufgaben zu gestrichenen Themen werden nicht gelöscht, sondern mit CatalogStatus.removed2025 markiert: Sie fliegen aus jeder Auswahl und aus der Prüfungsreife, bleiben aber als Nachschlagewerk erhalten. Wer mit einem Lehrbuch von 2022 lernt, verliert sonst Wochen an Stoff, der nicht mehr abgefragt wird.

---

Schnellstart

flutter pub get
flutter run -d chrome

Mit Supabase-Anbindung (siehe Supabase einrichten):

flutter run -d chrome --dart-define-from-file=env.json

Ohne SUPABASE_ANON_KEY startet die App im Offline-Modus: alle Aufgaben, Karteikarten und Theorie-Snacks kommen aus lib/data/seed/, der Fortschritt liegt in einer lokalen Datenbank (hive_ce, im Web IndexedDB). Das ist kein Notbetrieb, sondern der Normalfall für Entwicklung, Demo und Flugmodus.

Tests

flutter test

81 Tests: Netzplan-Solver (Vorwärts-/Rückwärtsrechnung, GP/FP, kritischer Pfad), Bewertungslogik aller sechs Aufgabentypen, Leitner-Karteikasten, Fortschritts- und Auswahl-Algorithmen, Integrität von Aufgabenpool und Kartensammlung, Bereichsgewichte, Onboarding-Flow.

Die Integritätstests setzen Qualitätsschwellen durch, die beim Ausbau leicht verrutschen: keine Antwortoption ohne Begründung, kein Thema mit ein oder zwei Aufgaben (schlimmer als keine — die Auswahl würde sie ständig wiederholen), keine doppelten Kartenvorderseiten, Themengewichte je Bereich exakt passend.

---

Supabase einrichten

Die App braucht Supabase nicht, um zu laufen — aber für geräteübergreifenden Fortschritt und redaktionell pflegbare Aufgaben.

Projekt-Ref dieses Setups: zcxhrkwbulsedkxcbkkk

Schritt 1 — Migrationen einspielen

Zwei Wege, beide führen zum selben Ergebnis. Die Migrationen sind idempotent (on conflict do update), ein zweiter Lauf schadet also nicht.

Weg A — Supabase-CLI (empfohlen, kein Copy-Paste)

npx supabase login

npx supabase link --project-ref zcxhrkwbulsedkxcbkkk

npx supabase db push

login öffnet den Browser; link fragt nach dem Datenbank-Passwort (Dashboard → Project Settings → Database). Beides bleibt in der CLI und landet nicht im Repository.

Weg B — SQL-Editor im Dashboard (ohne Installation)

Öffne den SQL-Editor und führe nacheinander aus:

1. supabase/migrations/20260919090000_ap1_schema.sql einfügen, Run
2. supabase/migrations/20260920090000_ap1_katalog2025.sql einfügen, Run
3. supabase/migrations/20260920090100_ap1_seed.sql einfügen, Run

Die Reihenfolge ist zwingend — der Seed setzt die Tabellen voraus. Die dritte Datei ist rund 200 KB groß; der Editor verarbeitet das, braucht aber einen Moment.

Kontrolle (in beiden Fällen):

select a.number, a.title,
       count(distinct t.id) as themen,
       count(distinct q.id) as aufgaben,
       count(distinct f.id) as karten
from public.ap1_areas a
left join public.ap1_topics t on t.area_id = a.id
left join public.ap1_questions q
       on q.topic_id = t.id and q.catalog_status = 'current'
left join public.ap1_flashcards f on f.topic_id = t.id
group by a.number, a.title order by a.number;

Erwartet: 7 Bereiche, 35 Themen, 65 prüfungsrelevante Aufgaben (68 inklusive der gestrichenen) und 112 Karteikarten.

Schritt 2 — Anon-Key eintragen

cp env.example.json env.json

Dann in env.json den anon/public-Key aus Project Settings → API Keys eintragen — nicht den service_role-Key, der gehört niemals in eine Client-App. env.json steht in .gitignore.

Schritt 3 — App mit Backend starten

flutter run -d chrome --dart-define-from-file=env.json

In den Einstellungen der App steht dann „Mit Supabase verbunden" statt „Offline-Modus". Bleibt es beim Offline-Modus, ist der Key leer oder falsch — die App fällt in dem Fall bewusst auf die eingebauten Aufgaben zurück, statt einen leeren Bildschirm zu zeigen.

This is the beginning of the README. Read the rest at the original. Read the full README ↗