Download the PHP package companyos/core without Composer

CompanyOS Core Bundle

Ein vollständiges Symfony-Bundle für das CompanyOS-System mit Plugin-Architektur, Authentifizierung, Benutzerverwaltung und API-First-Design.

⚠️ Alpha Version

**Dies ist eine Alpha-Version (0.1.152-alpha

Was funktioniert:

• ✅ Grundlegende Bundle-Struktur (DDD-Layer)
• ✅ Service-Konfiguration
• ✅ Doctrine-Mappings
• ✅ Routing-Grundstruktur
• ✅ Plugin-System-Architektur
• ✅ API-First-Design

Was noch fehlt:

• ❌ Vollständige Controller-Implementierung
• ❌ Unit/Integration Tests
• ❌ Datenbank-Migrationen
• ❌ Vollständige Dokumentation
• ❌ Code Coverage

Architektur

Das CoreBundle folgt einer API-First-Architektur:

• Reine API: Keine UI, keine Assets, keine Templates
• Business-Logik: Domain-Logik, Application-Layer, Infrastructure
• Plugin-Framework: Event- und Service-Extension für Core und API
• Modular: Kann unabhängig vom BackendBundle verwendet werden

Features

• Plugin-System: Dynamisches Laden und Verwalten von Plugins
• OAuth2-Authentifizierung: Vollständige OAuth2-Implementierung mit Password Grant
• Benutzerverwaltung: CRUD-Operationen für Benutzer
• Rollen- und Berechtigungssystem: Flexible Zugriffskontrolle
• Webhook-System: Event-basierte Webhook-Integration
• Event-Driven Architecture: Domain Events und Event Store
• API-First: Alle Funktionen über REST-API verfügbar

Installation

⚠️ Nur für Entwickler und Tester

Bundle registrieren

Konfiguration

Plugin-System

Das Plugin-System funktioniert vollständig über Services und erfordert keine Kernel-Erweiterung:

• Automatisches Plugin-Loading: Plugins werden beim Bundle-Boot geladen
• Service-basierte Architektur: Alle Plugin-Funktionen über Services
• Dynamische Routen: Plugin-Routen werden automatisch registriert
• Service-Discovery: Plugin-Services werden automatisch geladen

Plugin erstellen

Plugin-Konfiguration

API-Endpunkte

Authentifizierung

• POST /api/auth/login - Benutzer-Login
• POST /api/auth/refresh - Token erneuern
• POST /api/auth/logout - Logout
• GET /api/auth/profile - Benutzer-Profil

Benutzerverwaltung

• GET /api/users - Benutzer auflisten
• POST /api/users - Benutzer erstellen
• GET /api/users/{id} - Benutzer abrufen
• PUT /api/users/{id} - Benutzer aktualisieren
• DELETE /api/users/{id} - Benutzer löschen

Plugin-Verwaltung

• GET /api/plugins - Plugins auflisten
• POST /api/plugins/{name}/install - Plugin installieren
• POST /api/plugins/{id}/activate - Plugin aktivieren
• POST /api/plugins/{id}/deactivate - Plugin deaktivieren
• DELETE /api/plugins/{id} - Plugin löschen

Konfiguration

Plugin-Verzeichnisse

OAuth2-Konfiguration

Webhook-Konfiguration

Entwicklung

Bundle-Struktur

Tests

Kernel-Integration

Das Bundle erweitert nicht den Symfony-Kernel. Die Plugin-Funktionalität wird vollständig über Services bereitgestellt. Siehe KERNEL_INTEGRATION.md für Details.

Roadmap

Version 0.1.152-alpha

• [ ] Vollständige Controller-Implementierung
• [ ] Basis-Tests (Unit/Integration)
• [ ] Datenbank-Migrationen
• [ ] Verbesserte Dokumentation

Version 0.1.152-alpha

• [ ] Vollständige API-Implementierung
• [ ] Frontend-Assets
• [ ] Code Coverage > 80%
• [ ] CI/CD Pipeline

Version 0.1.152-alpha

• [ ] Production-ready
• [ ] Vollständige Tests
• [ ] Vollständige Dokumentation
• [ ] Performance-Optimierungen

Third-Party-Lizenzen

Dieses Bundle verwendet verschiedene Open-Source-Bibliotheken und Frameworks. Hier sind die wichtigsten Dependencies und deren Lizenzen:

Backend Dependencies

• Symfony Framework (MIT) - PHP Web Framework
• Doctrine ORM (MIT) - Object-Relational Mapping
• League OAuth2 Server (MIT) - OAuth2 Server Implementation
• Nelmio API Doc Bundle (MIT) - API Documentation Generator
• PHPUnit (BSD-3-Clause) - Testing Framework

Frontend Dependencies

• Vue.js (MIT) - Progressive JavaScript Framework
• CoreUI (MIT) - Bootstrap-based Admin Template
• Bootstrap (MIT) - CSS Framework
• Webpack Encore (MIT) - Asset Management

Vollständige Dependency-Liste

Für eine vollständige Liste aller verwendeten Pakete und deren Lizenzen siehe:

• composer.json für PHP-Dependencies
• package.json für JavaScript-Dependencies

Alle verwendeten Pakete sind Open-Source und unter permissiven Lizenzen (hauptsächlich MIT) verfügbar.

Lizenz

MIT License - siehe LICENSE Datei.

Support

Bei Fragen oder Problemen erstellen Sie ein Issue im Repository oder kontaktieren Sie das Entwicklungsteam.

Contributing

1. Fork das Repository
2. Erstelle einen Feature-Branch (git checkout -b feature/amazing-feature)
3. Committe deine Änderungen (git commit -m 'Add some amazing feature')
4. Push zum Branch (git push origin feature/amazing-feature)
5. Öffne einen Pull Request

Doctrine-Integration

Das Bundle stellt automatisch alle Core-Entities für Doctrine bereit. Um die Entities in die Datenbank zu schreiben:

1. Doctrine-Konfiguration im Hauptprojekt

Füge folgende Konfiguration in dein config/packages/doctrine.yaml hinzu:

2. Datenbank-Schema erstellen

Verfügbare Entities

Das Bundle stellt folgende Entities bereit:

• User: Benutzer-Verwaltung (users Tabelle)
• Role: Rollen-Verwaltung (roles Tabelle)
• UserRole: Benutzer-Rollen-Zuordnung (user_roles Tabelle)
• Client: OAuth2-Clients (oauth_clients Tabelle)
• AccessToken: OAuth2-Access-Tokens (oauth_access_tokens Tabelle)
• RefreshToken: OAuth2-Refresh-Tokens (oauth_refresh_tokens Tabelle)
• Plugin: Plugin-Verwaltung (plugins Tabelle)
• Webhook: Webhook-Verwaltung (webhooks Tabelle)
• CompanySettings: Unternehmens-Einstellungen (company_settings Tabelle)
• StoredEvent: Event Store (stored_events Tabelle)