From c4c00dc885ac75c85a97bb12dc632b633df19fe7 Mon Sep 17 00:00:00 2001 From: Till-JS <101404291+Till-JS@users.noreply.github.com> Date: Tue, 27 Jan 2026 03:37:59 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs:=20add=20devlog=20for=20202?= =?UTF-8?q?6-01-26=20monitoring,=20auth=20&=20AI=20updates?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Document 54 commits covering Prometheus metrics, Brevo email service, email verification flow, Ollama integration, Speech-to-Text service, and two new Telegram bots. Co-Authored-By: Claude Opus 4.5 --- .../devlog/2026-01-26-monitoring-auth-ai.md | 285 ++++++++++++++++++ 1 file changed, 285 insertions(+) create mode 100644 apps/manacore/apps/landing/src/content/devlog/2026-01-26-monitoring-auth-ai.md diff --git a/apps/manacore/apps/landing/src/content/devlog/2026-01-26-monitoring-auth-ai.md b/apps/manacore/apps/landing/src/content/devlog/2026-01-26-monitoring-auth-ai.md new file mode 100644 index 000000000..b2c4d392a --- /dev/null +++ b/apps/manacore/apps/landing/src/content/devlog/2026-01-26-monitoring-auth-ai.md @@ -0,0 +1,285 @@ +--- +title: 'Monitoring, Auth & Local AI: Prometheus, Email Verification & Speech-to-Text' +description: 'Prometheus Metrics für alle Backends, Brevo Email Service, Email Verification Flow, Ollama Integration, Speech-to-Text Service und zwei neue Telegram Bots' +date: 2026-01-26 +author: 'Till Schneider' +category: 'feature' +tags: + [ + 'monitoring', + 'prometheus', + 'grafana', + 'auth', + 'email', + 'brevo', + 'ollama', + 'speech-to-text', + 'telegram-bot', + 'ai', + ] +featured: true +commits: 54 +readTime: 10 +--- + +Produktiver Tag mit Fokus auf **Monitoring-Infrastruktur**, **Email-Authentifizierung** und **lokale AI-Services**. Die wichtigsten Errungenschaften: + +- **Prometheus Metrics** für alle NestJS Backends +- **Grafana Dashboards** mit CI/CD und User Statistics +- **Brevo SMTP** für transaktionale Emails +- **Email Verification** Flow komplett implementiert +- **Ollama Integration** für lokale LLM-Inferenz +- **Speech-to-Text Service** mit Whisper MLX +- **2 neue Telegram Bots** (Ollama Bot, Project Doc Bot) + +--- + +## Monitoring & Prometheus + +### Prometheus Metrics für alle Backends + +Alle NestJS Backends wurden mit Prometheus Metrics ausgestattet: + +- `/metrics` Endpoint auf jedem Backend +- Request/Response Metriken +- User Statistics (registrierte Nutzer pro App) +- Health Check Endpoints korrigiert + +### Grafana Dashboards + +| Dashboard | Inhalt | +| ---------------- | ----------------------------- | +| **CI/CD** | GitHub Actions, Deployments | +| **User Stats** | Registrierungen pro App | +| **System** | CPU, Memory, Disk | +| **Container** | Docker Container Metriken | + +### Health Check Fixes + +Korrektur der Health Check Endpoints für alle Services: + +- `mana-core-auth`: `/health` +- `chat-backend`: `/api/health` +- `calendar-backend`: `/health` +- `clock-backend`: `/health` +- `contacts-backend`: `/health` +- `todo-backend`: `/health` +- Alle Web Apps: `/health` Endpoint hinzugefügt + +--- + +## Auth & Email Service + +### Brevo SMTP Integration + +Implementierung von **Brevo** (ehemals Sendinblue) als Email-Provider: + +``` +mana-core-auth +├── src/lib/email/ +│ ├── brevo.ts # Brevo SMTP Client +│ └── templates/ # Email Templates +``` + +**Features:** +- Transaktionale Emails via SMTP +- HTML Email Templates +- Einladungs-Emails für Team-Mitglieder +- Password Reset Emails + +### Email Verification Flow + +Kompletter Email-Verification-Flow für neue Registrierungen: + +| Komponente | Beschreibung | +| ------------------------ | ----------------------------------------- | +| `sendVerificationEmail` | Sendet Verification Link | +| `/verify-email` Endpoint | Better Auth API Endpoint | +| Verification Pages | Success/Error Pages in ManaCore Web | +| Redirect Flow | Zurück zur Ursprungs-App nach Verifizierung | +| Login Banner | "Email verified" Banner auf Login Pages | + +**User Flow:** +1. Nutzer registriert sich +2. Verification Email wird gesendet +3. Nutzer klickt Link → `/verify-email?token=...` +4. Erfolgsseite mit Redirect zur Ursprungs-App +5. Login Page zeigt "Email erfolgreich verifiziert" Banner + +### Auth Fixes + +- Minimum Passwortlänge auf 8 Zeichen reduziert +- Password Reset API-Methode korrigiert +- Inviter Name in Einladungs-Emails gefixed +- Email Verification Config an richtige Stelle verschoben + +--- + +## Ollama Integration + +### Telegram Ollama Bot + +Neuer Telegram Bot für lokale LLM-Inferenz via Ollama: + +``` +services/telegram-ollama-bot/ +├── src/ +│ ├── bot/ # Telegram Bot Logic +│ ├── ollama/ # Ollama API Client +│ └── main.ts +``` + +**Features:** +- Chat mit lokalen LLMs (Llama 3.2, Qwen, etc.) +- Streaming Responses +- Conversation History +- Model Selection + +### Chat Backend Ollama + +Integration von Ollama in das Chat Backend für lokale LLM-Inferenz: + +- Docker Compose Configuration für Ollama +- API Endpoint für lokale Modelle +- Fallback zu Cloud-APIs wenn Ollama nicht verfügbar + +--- + +## Speech-to-Text Service + +### Whisper MLX Service + +Neuer Speech-to-Text Service für den Mac Mini: + +``` +services/speech-to-text/ +├── src/ +│ ├── transcription/ # Whisper MLX +│ ├── api/ # FastAPI Endpoints +│ └── main.py +``` + +**Technologie:** +- **lightning-whisper-mlx** für Apple Silicon +- **Modell:** large-v3 (optimiert für Genauigkeit) +- **API:** FastAPI mit `/transcribe` Endpoint + +### Voxtral Multimodal (Experimentell) + +Experimente mit Voxtral für multimodale Audio-Verarbeitung: + +- Base64 Audio Encoding +- AutoModel für korrekte Architektur +- Homebrew PATH für ffmpeg + +--- + +## Todo App Refactoring + +### ExpandableToolbar Pattern + +Übernahme des ExpandableToolbar-Patterns aus der Calendar App: + +- Konsolidierte Toolbar-Komponente +- Bessere Mobile-UX +- Einheitliches Design + +### Inline Task Editing + +Refactoring des Task-Editierens: + +| Vorher | Nachher | +| ------------------- | -------------------------- | +| Modal zum Editieren | Inline-Editing direkt in der Liste | +| Extra Click nötig | Direktes Editieren | +| Context Switch | Fokus bleibt in der Liste | + +### Homepage Redesign + +- Verbesserte Empty State Darstellung +- Optimierte Section Visibility +- Klarere Call-to-Actions + +--- + +## Calendar App Fix + +Behebung eines kritischen Bugs: + +- **Problem:** App hing beim Laden +- **Ursache:** Layout Issues +- **Fix:** Korrektur der Layout-Komponenten + +--- + +## Neue Telegram Bots + +### telegram-ollama-bot + +Bot für lokale LLM-Inferenz: + +| Feature | Beschreibung | +| -------------------- | -------------------------- | +| Chat | Unterhaltung mit lokalen LLMs | +| Streaming | Echtzeit-Antworten | +| Model Selection | Verschiedene Modelle wählbar | + +### telegram-project-doc-bot + +Bot für Projekt-Dokumentation: + +| Feature | Beschreibung | +| -------------------- | -------------------------- | +| Drizzle ORM | PostgreSQL Datenbank | +| OpenAI Integration | AI-gestützte Features | +| S3 Storage | Datei-Upload via MinIO | + +--- + +## Dokumentation + +### Neue Docs + +- **Design UX Guidelines** (`.claude/guidelines/design-ux.md`) +- **Local Models Documentation** +- **External Services Analysis** - Self-Hosting Guide +- **Telegram Ollama Bot** in MAC_MINI_SERVER.md + +--- + +## Infrastruktur Updates + +### Watchtower Notifications + +Experimente mit verschiedenen Notification-Methoden: + +- Telegram API (nicht funktional) +- n8n Webhook (Alternative) +- nickfedor Fork mit Telegram Support + +### Cloudflare Tunnel + +- Pushgateway zur Tunnel-Konfiguration hinzugefügt + +--- + +## Zusammenfassung + +| Bereich | Commits | Highlights | +| -------------- | ------- | ------------------------------------ | +| Monitoring | 15 | Prometheus, Grafana, Health Checks | +| Auth | 12 | Brevo SMTP, Email Verification | +| AI Services | 10 | Ollama, Speech-to-Text | +| Todo | 5 | Inline Editing, Toolbar | +| Telegram Bots | 4 | Ollama Bot, Project Doc Bot | +| Bugfixes | 8 | Calendar, Auth, Docker | + +--- + +## Nächste Schritte + +1. **Grafana Alerts** für kritische Metriken konfigurieren +2. **Speech-to-Text** in Chat App integrieren +3. **Ollama** Performance-Optimierungen +4. **Mobile Apps** mit neuen Auth-Features testen +5. **Project Doc Bot** Features erweitern