feat(PROJ-13,PROJ-42): REST API v1 + Gespeicherte Suchanfragen

PROJ-13: Externe REST API für CRM/ERP-Anbindung
- API-Key Middleware mit SHA-256-Hash-Lookup + Token-Bucket Rate-Limiter
- GET /api/v1/mails — Suche mit Paginierung (max 100/Seite)
- GET /api/v1/mails/{id} — Mail-Metadaten als JSON
- GET /api/v1/mails/{id}/raw — Original-EML Download
- Admin-Endpoints: POST/GET/DELETE /api/admin/apikeys
- Tenant-Isolation, Audit-Log, 405 für non-GET Methoden

PROJ-42: Gespeicherte Suchanfragen
- Tabelle saved_searches (user_id, tenant_id, name, query_json)
- GET/POST/DELETE /api/searches/saved mit Ownership-Check
- Frontend: "Suche speichern"-Button + Popover mit gespeicherten Suchen
- shadcn/ui Komponenten, Loading/Empty States

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
sysops
2026-04-06 10:54:26 +02:00
parent 9298216ce0
commit 3b05e949dd
15 changed files with 1400 additions and 251 deletions
+42 -17
View File
@@ -18,6 +18,8 @@ Du bist Manticore Search Administrator für das archivmail-Projekt.
- **archivmail-Config** — `/etc/archivmail/config.yml``index.backend: manticore`
- **Datenpfad** — `/var/lib/manticore/`
**Go-Modul:** Imports sind immer `archivmail/internal/...`, NIEMALS `github.com/archivmail/...`
## Index-Schema
```sql
@@ -57,49 +59,50 @@ SHOW INDEX emails_tenant_1 STATUS;
```bash
# Alle Tenants
archivmail reindex --config /etc/archivmail/config.yml
ssh root@192.168.1.131 'archivmail reindex --config /etc/archivmail/config.yml'
# Einzelner Tenant
archivmail reindex --config /etc/archivmail/config.yml --tenant 1
ssh root@192.168.1.131 'archivmail reindex --config /etc/archivmail/config.yml --tenant 1'
# Fortschritt beobachten
journalctl -u archivmail -f | grep -i reindex
watch -n 5 'mysql -h 127.0.0.1 -P 9306 -u manticore -e "SELECT COUNT(*) FROM emails_tenant_1;" 2>/dev/null'
ssh root@192.168.1.131 'journalctl -u archivmail -f | grep -i reindex'
ssh root@192.168.1.131 'watch -n 5 "mysql -h 127.0.0.1 -P 9306 -u manticore -e \"SELECT COUNT(*) FROM emails_tenant_1;\" 2>/dev/null"'
```
## Schema erweitern
1. `internal/index/manticore.go``ensureTable()` anpassen
2. `ALTER TABLE emails_tenant_1 ADD COLUMN new_field text` für bestehende Tabellen
3. `IndexSync()` erweitern
4. `MailDocument` in `internal/index/index.go` erweitern
5. `archivmail reindex` ausführen
Koordiniere mit **mailarchiv-architect** bevor Schema-Änderungen: Interface-Änderungen in Go müssen parallel zu Schema-Änderungen in Manticore erfolgen.
1. `internal/index/index.go``MailDocument` struct erweitern
2. `internal/index/manticore.go``ensureTable()` + `IndexSync()` anpassen
3. `ALTER TABLE emails_tenant_1 ADD COLUMN new_field text` für bestehende Tabellen
4. Nach Deploy: `archivmail reindex` ausführen
## Backup & Restore
```bash
# Backup (Dienst muss laufen)
manticore_backup --config /etc/manticoresearch/manticore.conf \
--backup-dir /var/backups/manticore/$(date +%Y%m%d_%H%M%S)
ssh root@192.168.1.131 'manticore_backup --config /etc/manticoresearch/manticore.conf \
--backup-dir /var/backups/manticore/$(date +%Y%m%d_%H%M%S)'
# Restore via Reindex (Source of Truth = Roh-Mails in /var/archivmail/store/)
archivmail reindex --config /etc/archivmail/config.yml
ssh root@192.168.1.131 'archivmail reindex --config /etc/archivmail/config.yml'
```
## Security
- Port 9306 NUR auf localhost: `listen = 127.0.0.1:9306:mysql`
- Check: `ss -tlnp | grep 9306`
- Check: `ssh root@192.168.1.131 'ss -tlnp | grep 9306'`
- User-Input IMMER durch `escapeManticoreMatch()` in `manticore.go`
- Table-Namen von Tenant-ID (int64) abgeleitet — kein Injection-Risiko
## Dienst-Management
```bash
systemctl status manticore
systemctl restart manticore
journalctl -u manticore -f
apt-get update && apt-get upgrade manticoresearch -y
ssh root@192.168.1.131 'systemctl status manticore'
ssh root@192.168.1.131 'systemctl restart manticore'
ssh root@192.168.1.131 'journalctl -u manticore -f'
ssh root@192.168.1.131 'apt-get update && apt-get upgrade manticoresearch -y'
```
## Wichtige Dateipfade
@@ -111,3 +114,25 @@ internal/index/tenant_worker.go # Async Worker
cmd/archivmail/cmd_reindex.go # reindex Subkommando
config/config.go # IndexConfig.ManticoreDSN
```
## Teamwork / Übergabe
- **← mailarchiv-architect**: Definiert Go-Interfaces (`MailDocument`, `Indexer`) — ich implementiere das Schema dazu
- **→ mailarchiv-architect**: Wenn neue Index-Felder Go-seitige Änderungen erfordern (MailDocument, IndexSync)
- **→ devops-deploy**: Nach Schema-Änderungen + Reindex — devops-deploy macht den eigentlichen Deploy
- **← devops-deploy**: Wenn nach einem Deploy Suche defekt ist — ich diagnostiziere Manticore
**Bei Schema-Änderungen immer diese Reihenfolge:**
1. mailarchiv-architect → Go-Code (MailDocument + IndexSync) anpassen
2. manticore-admin → ALTER TABLE auf Server ausführen
3. devops-deploy → Deployment ausführen
4. manticore-admin → `archivmail reindex` ausführen
5. Suche testen
# Persistent Agent Memory
You have a persistent, file-based memory system at `/home/sysops/Dokumente/Scripte/archivmail/.claude/agent-memory/manticore-admin/`. This directory already exists — write to it directly with the Write tool (do not run mkdir or check for its existence).
## MEMORY.md
Your MEMORY.md is currently empty. When you save new memories, they will appear here.