Entwickler-Onboarding

Branches und Deployment

Der im main-Branch dieses Repositories abgelegte Code entspricht der Produktivinstanz des Intranets.

Sobald neuer Code auf main veröffentlicht wird, wird die Produktivinstanz automatisch neu gebaut. Änderungen auf diesem Branch gehen daher unmittelbar produktiv live.

Der dev-Branch entspricht der Test- bzw. Entwicklungsinstanz des Intranets. Wird dort neuer Code veröffentlicht, wird die Dev-Instanz ebenfalls automatisch neu gebaut.

Die Dev-Instanz kann über das Entwicklerdashboard im Intranet oder direkt unter folgender Adresse aufgerufen werden:

https://intranet.dev.nak-reinickendorf.de/

Pull Requests

Auf main und dev kann nicht direkt gepusht werden. Neuer Code wird ausschließlich über einen Pull Request (PR) veröffentlicht.

Für einen Merge in main ist zusätzlich mindestens ein Approval eines weiteren Entwicklers erforderlich.

Wichtig: Bevor Änderungen auf main gemerged werden, müssen sie vollständig in der Dev-Instanz getestet worden sein.

Entwicklerdashboard und Projektverwaltung

Im Entwicklerdashboard befinden sich unter anderem Links zu:

der Datenbank
dem Git-Repository
dem Kanban-Projektboard
dem SSO

Das Kanban-Projektboard dient der Verwaltung anstehender, aktueller und abgeschlossener Aufgaben innerhalb des Teams.

Jede Codeänderung sollte einem entsprechenden Issue zugeordnet sein.

Änderungen und relevante technische Entscheidungen sollten nachvollziehbar dokumentiert werden. Bitte kommentiert bzw. referenziert sie daher an den entsprechenden Stellen:

im zugehörigen Issue
in den Commits
im Pull Request

Infrastruktur, Hochverfügbarkeit und Backups

Sämtliche Anwendungen laufen in einem High-Availability-Cluster und werden durchgehend repliziert.

Bei einem Geräte- oder Hardwareausfall wird die betroffene Anwendung innerhalb weniger Minuten auf redundanter Hardware neu aufgebaut.

Backups werden täglich erstellt und automatisch auf verschiedene Standorte verteilt.

Lokales Setup

1. SSO-Zugang einrichten

Erstelle zunächst einen SSO-Zugang (Single Sign-On) unter:

https://id.pelpino.de/login/alternative/email/

Dort ist die im Intranet hinterlegte E-Mail-Adresse zum anmelden zu verwenden. Hinterlege für deinen Account anschließend mindestens einen Passkey.

2. Projekt lokal einrichten

Fahre danach mit der Anleitung zur lokalen Einrichtung des Projekts fort: