Files
leocrm/app/plugins/builtins/kommunikation/plugin.py
T
Agent Zero fc96a2f86c Phase 3: Plugin-UI-System (WordPress-Style)
Backend:
- PluginManifest um 5 neue UI-Felder erweitert: menu_items, page_routes,
  detail_tabs, settings_pages, dashboard_widgets (FrontendMenuItem,
  FrontendPageRoute, FrontendDetailTab, FrontendSettingsPage,
  FrontendDashboardWidget)
- GET /api/v1/plugins/active-manifests Endpoint liefert UI-Manifeste
  aller aktiven Plugins
- Registry.get_active_manifests() + PluginService.get_active_manifests()
- 12 Built-in Plugins mit UI-Manifest-Daten gefuellt (menu_items,
  page_routes, detail_tabs, settings_pages)
- Plugin-Install-System: POST /upload (ZIP), POST /install-url (URL)
  mit Validierung (Manifest, dangerous imports, SQL migrations)

Frontend:
- pluginStore.ts (Zustand) mit PluginUiManifest Typen + Selektoren
- useActivePluginManifests() React Query Hook
- PluginRegistry.tsx — fetcht Manifeste beim App-Start
- PluginLoader.tsx — dynamisches React.lazy() mit ErrorBoundary
- PluginRouteRenderer.tsx — Catch-all fuer Plugin-Routes
- routes/index.tsx — Catch-all Routes fuer Plugin-Pages + Settings
- Sidebar.tsx — dynamische Plugin Menu-Items mit Grouping + Icons
- Settings.tsx — dynamische Plugin Settings-Pages
- ContactDetail.tsx — dynamische Plugin Detail-Tabs mit Permissions
- AppShell.tsx — PluginRegistry Provider eingebunden
- SettingsPlugins.tsx — Install-UI (ZIP Upload + URL Install)
- plugins.ts — useUploadPlugin() + useInstallPluginFromUrl() Hooks

Docs & Templates:
- docs/plugin-development-guide.md — komplette Entwickler-Doku
- templates/plugin-template/ — Boilerplate mit allen Manifest-Feldern

Tests:
- 34 Vitest-Tests (PluginRegistry, PluginLoader, PluginRouteRenderer,
  pluginStore) — alle bestanden
- TSC: keine neuen Errors (nur pre-existing Dms.tsx)
2026-07-23 19:01:18 +02:00

98 lines
3.4 KiB
Python

"""Kommunikation plugin — unified messaging: chat, AI, system, messenger."""
from __future__ import annotations
import logging
from typing import Any
from app.plugins.base import BasePlugin
from app.plugins.manifest import PluginManifest, PluginRouteDef, FrontendMenuItem, FrontendPageRoute
logger = logging.getLogger(__name__)
class KommunikationPlugin(BasePlugin):
"""Unified messaging plugin: conversations, messages, participants, WebSocket, rich content."""
manifest = PluginManifest(
name="kommunikation",
version="1.0.0",
display_name="Kommunikation",
description=(
"Unified Messaging: Chat, KI, System, Messenger — "
"alles ist ein Teilnehmer."
),
dependencies=["permissions", "dms"],
routes=[
PluginRouteDef(
path="/api/v1/comm",
module="app.plugins.builtins.kommunikation.routes",
router_attr="router",
),
],
events=[
"message.received",
"message.sent",
"conversation.created",
"conversation.updated",
"participant.joined",
"participant.left",
"reaction.added",
],
migrations=["0001_initial.sql"],
permissions=[
"comm:read",
"comm:write",
"comm:create",
"comm:manage",
"comm:admin",
"comm:delete",
],
is_core=True,
menu_items=[
FrontendMenuItem(label_key='nav.communication', label='Communication', path='/communication', icon='MessageSquare', order=80),
],
page_routes=[
FrontendPageRoute(path='/communication', component='@/pages/Communication', protected=True),
],
)
async def on_activate(self, db, service_container, event_bus) -> None:
"""Register participant registry and WebSocket manager."""
await super().on_activate(db, service_container, event_bus)
# Register WebSocket manager as a shared service
from app.plugins.builtins.kommunikation.websocket_manager import WebSocketManager
ws_manager = WebSocketManager()
service_container.register("comm_websocket", ws_manager)
# Register Mini-App registry as a shared service
from app.plugins.builtins.kommunikation.miniapp_registry import MiniAppRegistry
miniapp_registry = MiniAppRegistry()
service_container.register("comm_miniapps", miniapp_registry)
logger.info("Kommunikation plugin activated — WebSocket + MiniApp registries ready")
async def on_deactivate(self, db, service_container, event_bus) -> None:
"""Clean up registries."""
await super().on_deactivate(db, service_container, event_bus)
logger.info("Kommunikation plugin deactivated")
def get_notification_types(self) -> list[dict[str, Any]]:
return [
{
"type_key": "comm_message",
"category": "communication",
"label": "Neue Nachricht",
"description": "Neue Nachricht in einer Konversation",
"is_enabled_by_default": True,
},
{
"type_key": "comm_mention",
"category": "communication",
"label": "Erwähnung",
"description": "Du wurdest in einer Nachricht erwähnt",
"is_enabled_by_default": True,
},
]