Entwicklung

Entwickler-Dokumentation und Tools für die Appiyon-Plattform.

Übersicht

Diese Sektion enthält alle wichtigen Informationen für Entwickler:

• Setup & Installation - Projekt aufsetzen und konfigurieren
• Troubleshooting - Häufige Probleme und Lösungen
• Best Practices - Code-Standards und Patterns
• Tools - Entwickler-Tools und Utilities
• Changelog - Was wurde wann implementiert

Quick Links

🚀 Setup

• Installation Guide - Projekt initial aufsetzen
• Environment Setup - .env Konfiguration
• Database Setup - Datenbank einrichten

🐛 Troubleshooting

• Admin Panel Issues - Admin-Panel Probleme
• Migration Issues - Datenbank-Migrations-Probleme
• Common Errors - Häufige Fehler

📝 Guides

• Creating Entities - Neue Entities erstellen
• Creating Use Cases - Use Cases implementieren
• Working with Events - Event-System nutzen
• Creating Migrations - Datenbank-Migrationen

🛠️ Tools

• Console Commands - Verfügbare Commands
• Code Generation - Code-Generatoren
• Testing - Test-Tools

📊 Status

• Changelog - Was wurde implementiert
• TODO - Offene Aufgaben
• Known Issues - Bekannte Probleme

Aktueller Stand

Datum: 2025-10-24

✅ Implementiert

Infrastructure Layer

• ✅ Admin-Modul komplett (Entities, Repositories, Use Cases, Events)
• ✅ EasyAdmin Dashboard
• ✅ Domain Restriction (nur appisym.go4family.net)
• ✅ Console Command: admin:create
• ✅ Datenbank-Migrationen

Shared Layer

• ✅ Exception System (Domain, Application, Infrastructure)
• ✅ Audit System (AuditLog, AuditMessage, AuditableInterface)
• ✅ Event System (DomainEventTrait, AuditEventSubscriber)

Dev Layer

• ✅ EasyAdmin Controllers (Admin, AuditLog, LoginAttempt)
• ✅ Event Subscribers (AdminDomainRestriction)
• ✅ Console Commands (CreateAdmin)

🏗️ In Arbeit

• [ ] Security/Authentication für Admin-Panel
• [ ] Weitere Console Commands
• [ ] Test-Suite aufbauen

📚 Dokumentation

Diese Entwickler-Dokumentation ist Teil der VitePress-Dokumentation und wird bei Bedarf manuell aktualisiert.

Rebuild Dokumentation:

cd /var/www/vhosts/canshare.me/appiyon.com/appisym
php doku/scripts/generate-complete-docs.php

Entwickler-Workflow

1. Feature Branch erstellen

git checkout -b feature/neue-funktion

2. Code schreiben

• Entities im passenden Layer erstellen
• Use Cases implementieren
• Events definieren
• Tests schreiben

3. Migration erstellen

php bin/console doctrine:migrations:diff

4. Tests ausführen

vendor/bin/phpunit

5. Pull Request erstellen

git push origin feature/neue-funktion

Wichtige Dateien

Konfiguration

• .env - Environment-Variablen
• config/services.yaml - Service-Container
• config/packages/doctrine.yaml - Datenbank-Konfiguration
• .php-cs-fixer.dist.php - Code-Style

Dokumentation

• doku/docs/ - VitePress-Dokumentation
• README.md - Projekt-Übersicht
• DEPLOYMENT.md - Deployment-Guide

Entry Points

• public/index.php - Haupt-Entry-Point
• bin/console - CLI-Entry-Point

Support

Bei Fragen oder Problemen:

1. Prüfe Troubleshooting
2. Suche in Known Issues
3. Prüfe Logs: var/log/dev.log