Microservices, Matrix Phase 3 & Massive Konsolidierung

Außergewöhnlich produktiver Tag mit 55 Commits - aufgeteilt in drei große Bereiche:

• 3 neue Microservices - mana-llm (LLM Abstraction), mana-crawler (Web Crawler), mana-notify (Notifications)
• Matrix Web Client Phase 3 - VoIP/Video Calls, Screen Sharing, @Mentions, Emoji Reactions, Search
• Massive Konsolidierung - 8 neue Shared Packages, ~2.500 LOC Code-Deduplizierung

Neue Microservices

mana-llm: Central LLM Abstraction Service

Neuer Python/FastAPI Service als zentraler Gateway für alle LLM-Anfragen im Monorepo.

Architektur

┌─────────────────────────────────────────────────────────────────────┐
│                        Consumer Apps                                 │
│  matrix-ollama-bot │ telegram-ollama-bot │ chat-backend │ etc.     │
└────────────────────────────────┬────────────────────────────────────┘
                                 │ HTTP/SSE
                                 ▼
┌─────────────────────────────────────────────────────────────────────┐
│                     mana-llm (Port 3025)                            │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐                 │
│  │   Router    │  │   Cache     │  │   Metrics   │                 │
│  │ (Provider)  │  │  (Redis)    │  │ (Prometheus)│                 │
│  └──────┬──────┘  └─────────────┘  └─────────────┘                 │
│         │                                                           │
│  ┌──────┴──────────────────────────────────────────┐               │
│  │              Provider Adapters                   │               │
│  │  ┌──────────┐  ┌──────────┐  ┌──────────────┐  │               │
│  │  │  Ollama  │  │ OpenAI   │  │  OpenRouter  │  │               │
│  │  │  Adapter │  │ Adapter  │  │   Adapter    │  │               │
│  │  └──────────┘  └──────────┘  └──────────────┘  │               │
│  └─────────────────────────────────────────────────┘               │
└─────────────────────────────────────────────────────────────────────┘

Features

Provider Routing

# Ollama (Standard wenn kein Prefix)
curl -X POST http://localhost:3025/v1/chat/completions \
  -d '{"model": "ollama/gemma3:4b", "messages": [...]}'

# OpenRouter
curl -X POST http://localhost:3025/v1/chat/completions \
  -d '{"model": "openrouter/meta-llama/llama-3.1-8b-instruct", ...}'

# Groq
curl -X POST http://localhost:3025/v1/chat/completions \
  -d '{"model": "groq/llama-3.1-8b-instant", ...}'

Projekt-Struktur

services/mana-llm/
├── src/
│   ├── main.py                 # FastAPI Entry Point
│   ├── config.py               # Pydantic Settings
│   ├── providers/
│   │   ├── base.py             # Abstract Provider
│   │   ├── ollama.py           # Ollama Provider
│   │   ├── openai_compat.py    # OpenAI-compatible Provider
│   │   └── router.py           # Provider Routing
│   ├── models/
│   │   ├── requests.py         # Request Models
│   │   └── responses.py        # Response Models
│   ├── streaming/
│   │   └── sse.py              # SSE Response Handler
│   └── utils/
│       ├── cache.py            # Redis Caching
│       └── metrics.py          # Prometheus Metrics
├── tests/
│   ├── test_api.py
│   ├── test_providers.py
│   └── test_streaming.py
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
└── pyproject.toml

mana-crawler: Web Crawler Service

NestJS-basierter Web Crawler für systematisches Crawling und Content-Extraktion.

Architektur

┌─────────────────────────────────────────────────────────────────────┐
│              mana-crawler (Port 3023)                                │
│                                                                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐                  │
│  │ Crawl API   │  │ Queue       │  │ Parser      │                  │
│  │ Controller  │──│ Service     │──│ Service     │                  │
│  └─────────────┘  │ (BullMQ)    │  │ (Cheerio)   │                  │
│                   └─────────────┘  └─────────────┘                  │
│                         │                │                          │
│                   ┌─────┴────────────────┴─────┐                    │
│                   │     Storage Service         │                    │
│                   │  (PostgreSQL + Redis)       │                    │
│                   └─────────────────────────────┘                    │
└─────────────────────────────────────────────────────────────────────┘

API Endpoints

Features

Beispiel-Request

curl -X POST http://localhost:3023/api/v1/crawl \
  -H "Content-Type: application/json" \
  -d '{
    "startUrl": "https://docs.example.com",
    "config": {
      "maxDepth": 3,
      "maxPages": 500,
      "respectRobots": true,
      "rateLimit": 2,
      "includePatterns": ["/docs/*"],
      "excludePatterns": ["/api/*", "*.pdf"],
      "selectors": {
        "content": "article.main-content",
        "title": "h1.page-title"
      },
      "output": {
        "format": "markdown"
      }
    }
  }'

mana-notify: Central Notification Service

Zentraler Notification-Service für Email, Push, Matrix und Webhooks.

Architektur

┌─────────────────────────────────────────────────────────────────────┐
│                 Consumer Apps                                        │
│   Auth │ Calendar │ Chat │ Picture │ Zitare │ ...                   │
└─────────────────────────┬───────────────────────────────────────────┘
                          ▼
┌─────────────────────────────────────────────────────────────────────┐
│              mana-notify (Port 3040)                                 │
│                                                                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐                  │
│  │ Notification│  │ Template    │  │ Preferences │                  │
│  │ API         │  │ Engine      │  │ Manager     │                  │
│  └──────┬──────┘  └──────┬──────┘  └─────────────┘                  │
│         │                │                                           │
│         ▼                ▼                                           │
│  ┌──────────────────────────────────────────────┐                   │
│  │           BullMQ Job Queues                   │                   │
│  │  Email │ Push │ Matrix │ Webhook              │                   │
│  └──────────────────────────────────────────────┘                   │
│         │         │         │         │                             │
│         ▼         ▼         ▼         ▼                             │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐                   │
│  │ Brevo   │ │ Expo    │ │ Matrix  │ │ HTTP    │                   │
│  │ SMTP    │ │ Push    │ │ API     │ │ Client  │                   │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘                   │
└─────────────────────────────────────────────────────────────────────┘

Notification Channels

API Endpoints

Client SDK

import { NotifyClient } from '@manacore/notify-client';

const notify = new NotifyClient({
	serviceUrl: 'http://localhost:3040',
	serviceKey: process.env.MANA_NOTIFY_SERVICE_KEY,
	appId: 'calendar',
});

// Email senden
await notify.sendEmail({
	to: '[email protected]',
	template: 'calendar-reminder',
	data: { eventTitle: 'Meeting', eventTime: '14:00' },
});

// Push an User
await notify.sendPush({
	userId: 'user-uuid',
	title: 'Erinnerung',
	body: 'Meeting in 15 Minuten',
	data: { eventId: 'xxx' },
});

Default Templates

Matrix Web Client Phase 3

Massive Feature-Erweiterung des SvelteKit Matrix Clients mit 25 Commits.

VoIP & Video Calls

Vollständige WebRTC-Integration für Audio/Video-Anrufe.

apps/matrix/apps/web/src/lib/components/call/
├── CallView.svelte           # 224 LOC - Anruf-UI mit Steuerung
├── IncomingCallDialog.svelte # 123 LOC - Eingehender Anruf Dialog
└── index.ts

Features:

@Mention Autocomplete

Intelligente User-Erwähnung mit Autocomplete:

<!-- MessageInput.svelte -->
<script lang="ts">
	let showMentionPopup = $state(false);
	let mentionSearch = $state('');
	let mentionCandidates = $state<MatrixUser[]>([]);

	function handleInput() {
		const text = inputElement?.textContent || '';
		const mentionMatch = text.match(/@(\w*)$/);
		if (mentionMatch) {
			showMentionPopup = true;
			mentionSearch = mentionMatch[1];
			mentionCandidates = filterMembers(mentionSearch);
		}
	}
</script>

{#if showMentionPopup}
	<div class="mention-popup">
		{#each mentionCandidates as user}
			<button onclick={() => insertMention(user)}>
				<Avatar src={user.avatarUrl} />
				<span>{user.displayName}</span>
			</button>
		{/each}
	</div>
{/if}

Message Forwarding

Nachrichten an andere Räume weiterleiten:

apps/matrix/apps/web/src/lib/components/chat/
├── ForwardMessageDialog.svelte  # 173 LOC - Room-Auswahl Dialog
└── Message.svelte               # Forward-Button hinzugefügt

Emoji Reactions

Reaktionen auf Nachrichten:

Extended Emoji Picker

Vollständiger Emoji-Picker mit Kategorien und Skin-Tone Support.

Message Search

Nachrichten im aktuellen Raum durchsuchen:

apps/matrix/apps/web/src/lib/components/chat/
└── SearchDialog.svelte  # 185 LOC

Features:

• Volltextsuche in Nachrichten
• Ergebnisse mit Kontext
• Keyboard Shortcut: Cmd+F / Ctrl+F
• Jump to Message

Browser Notifications

// apps/matrix/apps/web/src/lib/notifications/index.ts (171 LOC)

export class NotificationService {
	async requestPermission(): Promise<boolean>;
	async showNotification(room: Room, event: MatrixEvent): Promise<void>;
	private shouldShowNotification(event: MatrixEvent): boolean;
}

Features:

• Permission Request bei erstem Nachrichtenempfang
• Click-to-Focus auf Nachricht
• Unread Badge Update
• Tab-Focus Detection (keine Notifikation wenn aktiv)

Keyboard Shortcuts

Online Status & Presence

• Online/Offline/Busy Indikatoren
• Letzte Aktivität
• Typing Indicator (verbessert)

Read Receipts

• Gelesen-Markierung pro Nachricht
• Aggregierte Receipts (Avatar-Stack)
• Eigene Nachricht: “Gelesen von X”

UI/UX Verbesserungen

Massive Konsolidierung

Der wichtigste Teil des Tages: ~2.500 LOC Code-Deduplizierung durch 8 neue Shared Packages.

Neue Shared Packages

@manacore/shared-nestjs-health

// Vorher (26 LOC pro Backend)
@Controller('health')
export class HealthController {
  @Get()
  check() {
    return { status: 'ok', timestamp: new Date().toISOString(), service: 'chat' };
  }
}

// Nachher (1 Import)
import { HealthModule } from '@manacore/shared-nestjs-health';
@Module({ imports: [HealthModule.forRoot({ serviceName: 'chat-backend' })] })

Migrierte Backends (12): calendar, chat, clock, contacts, nutriphi, picture, planta, presi, skilltree, storage, todo, zitare

@manacore/shared-nestjs-setup

// Vorher (85 LOC pro Backend)
async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  const corsOrigins = process.env.CORS_ORIGINS?.split(',') || [...];
  app.enableCors({ origin: corsOrigins, ... });
  app.useGlobalPipes(new ValidationPipe({ ... }));
  app.setGlobalPrefix('api/v1', { exclude: ['health'] });
  // ...
}

// Nachher (15 LOC)
import { bootstrapApp } from '@manacore/shared-nestjs-setup';
const app = await bootstrapApp(AppModule, { defaultPort: 3002 });
await app.listen(process.env.PORT || 3002);

Migrierte Backends (8): chat, calendar, contacts, zitare, clock, planta, presi, nutriphi

@manacore/shared-tsconfig

// Vorher (25 LOC pro Backend)
{
  "compilerOptions": {
    "module": "commonjs",
    "moduleResolution": "node",
    // ... 20+ weitere Zeilen
  }
}

// Nachher (3 LOC)
{
  "extends": "@manacore/shared-tsconfig/nestjs"
}

Verfügbare Configs:

• nestjs.json - NestJS Backend
• sveltekit.json - SvelteKit Web
• expo.json - Expo Mobile
• astro.json - Astro Landing

@manacore/shared-vite-config

// Vorher (30-60 LOC pro App)
export default defineConfig({
  plugins: [tailwindcss(), sveltekit()],
  server: { port: 5174, strictPort: true },
  ssr: { noExternal: ['@manacore/shared-icons', ...] },
  optimizeDeps: { exclude: ['@manacore/shared-icons', ...] },
});

// Nachher (12 LOC)
import { createViteConfig, mergeViteConfig } from '@manacore/shared-vite-config';

const baseConfig = createViteConfig({ port: 5174 });
export default defineConfig(mergeViteConfig(baseConfig, {
  plugins: [tailwindcss(), sveltekit()],
}));

Migrierte Apps (15): Alle SvelteKit Web Apps

@manacore/shared-drizzle-config

// Vorher (10-15 LOC)
export default defineConfig({
	schema: './src/db/schema/index.ts',
	out: './src/db/migrations',
	dialect: 'postgresql',
	dbCredentials: { url: process.env.DATABASE_URL || '...' },
	verbose: true,
	strict: true,
});

// Nachher (1 Zeile)
import { createDrizzleConfig } from '@manacore/shared-drizzle-config';
export default createDrizzleConfig({ dbName: 'chat' });

Bot Migration zu mana-llm

Alle LLM-nutzenden Bots und Services wurden auf mana-llm migriert:

Vorteile:

• Zentrale Provider-Konfiguration
• Einheitliches Logging/Metrics
• Einfacher Cloud-Provider-Wechsel
• Caching über Services hinweg

// Vorher (in jedem Bot)
const response = await fetch(`${OLLAMA_URL}/api/chat`, {
	method: 'POST',
	body: JSON.stringify({ model, messages, stream: true }),
});

// Nachher (via mana-llm)
const response = await fetch(`${MANA_LLM_URL}/v1/chat/completions`, {
	method: 'POST',
	body: JSON.stringify({ model: 'ollama/gemma3:4b', messages, stream: true }),
});

Dokumentation

CONSOLIDATION_OPPORTUNITIES.md

Vollständige Analyse der Konsolidierungsmöglichkeiten mit:

• Detaillierte Code-Analyse
• LOC-Einsparungen pro Maßnahme
• Status-Tracking (erledigt/offen)
• Code-Beispiele vorher/nachher

MICROSERVICES_API_OVERVIEW.md

Neues Dokument mit API-Übersicht aller Microservices:

• Ports und Endpoints
• Authentication-Methoden
• Request/Response Beispiele

Bugfixes

Neue Services/Ports

Zusammenfassung

Gesamteinsparung: ~2.584 LOC durch Konsolidierung + bessere Wartbarkeit

Nächste Schritte

1. mana-llm auf Mac Mini deployen
2. mana-notify mit Auth-Service integrieren
3. mana-crawler für Questions App nutzen
4. Matrix E2EE aktivieren
5. Restliche Backends zu shared-nestjs-setup migrieren
6. Mobile Apps mit mana-notify für Push integrieren