trading-system-docs/README.md

108 lines
5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Trading-System — Modulare Architektur
Zentrales, modulares automatisiertes Trading-System, betrieben auf einem Hostinger-VPS (`187.124.31.123`).
**Repository-Inhalt:** Live-Dokumentation der Infrastruktur, der Module und des aktuellen Betriebszustands.
Jede Änderung folgt dem **Notation-Format**: Autor (`Alice` / `Rain Ocampo`) + Zeitstempel (`DD.MM.YYYY HH:MM`) + Grund.
---
## Architektur-Überblick
- **19 Module** (`Modul-01-PostgreSQL` … `Modul-18-Position-Manager`, `Modul-26-Telegram-Gateway`), orchestriert über `docker-compose.yml` unter `/opt/trading-modules/`.
- **Netzwerk:** `trading-modules` (bridge). Kommunikation ausschließlich über **Docker-interne Service-Hostnamen** (keine festen IPs).
- **Feste Host-Ports:** Modul-01=`55432`, Modul-02=`55672`+`15672`, Modul-0317=`55003``55017`.
- **Zugangsdaten:** nur über Environment Variables / Docker-Secrets (Defaults in Compose mit `${VAR:-default}`).
- **Kernprinzip:** bestehende Container/Volumes/Daten nie löschen, keine unnötigen öffentlichen Ports öffnen, Ist-Zustand vor Änderung prüfen.
### Multi-Agent-Setup (Resident-Evil-Theme)
| Agent | Rolle | Port |
|-------|-------|------|
| **Alice** (OpenClaw) | Primary | 55163 |
| **Matt Addison** (OpenClaw) | Backup | 54524 |
| **Rain Ocampo** (Hermes) | Technischer Support | 32776 (UI) |
---
## Module
| Modul | Name | Status | Port |
|-------|------|--------|------|
| 01 | PostgreSQL | ✅ healthy (postgres:16-alpine) | 55432 |
| 02 | RabbitMQ | ✅ healthy (rabbitmq:3-management) | 55672 / 15672 |
| 03 | Market-Data | ✅ healthy (market-data:0.1.0) | 55003 (intern) |
| 04 | Market-Regime | ✅ healthy (market-regime:1.0.0) | 55004 (intern) |
| 05 | Strategy-Engine | ✅ healthy (strategy-engine:0.1.0) | 55005 (intern) |
| 06 | Signal-Ranking | ✅ FREIGEGEBEN (signal-ranking:0.1.0) | 55006 (intern) |
| 07 | Risk-Manager | ✅ FREIGEGEBEN (risk-manager:0.1.0) | 55007 (intern) |
| 08 | Portfolio-Manager | ✅ FREIGEGEBEN (portfolio-manager:0.1.0) | 55008 (intern) |
| 09 | Execution-Service | ✅ FREIGEGEBEN (execution-service:0.1.0) | 55009 (intern) |
| 10 | Trade-Journal | ✅ FREIGEGEBEN (trade-journal:0.1.0) | 55010 (intern) |
| 11 | Analytics | ✅ FREIGEGEBEN (analytics-service:0.1.0) | 55011 (intern) |
| 12 | Backtesting | ✅ FREIGEGEBEN (backtesting:0.1.2) | 55012 (intern) |
| 13 | Optimization | ✅ FREIGEGEBEN (optimization:0.1.0) | 55013 (intern) |
| 14 | Notification | ✅ FREIGEGEBEN (notification:0.1.0) | 55014 (intern) |
| 15 | Monitoring-Control | ✅ FREIGEGEBEN (monitoring-control:0.1.0) | 55015 (intern) |
| 16 | Paperclip | ✅ FREIGEGEBEN (paperclip:0.1.0) | 55016 (intern) |
| 17 | Hermes-Agent | ✅ FREIGEGEBEN (hermes-agent:0.1.0) | 55017 (intern) |
| 18 | Position-Manager | ✅ FREIGEGEBEN (position-manager:0.1.0) | 55018 (intern) |
| 26 | Telegram-Gateway | ✅ FREIGEGEBEN (telegram-gateway:0.1.0) | 55026 (intern) |
Details: siehe `modul-03-market-data.md``modul-18-position-manager.md` (Module 0318
vollständig implementiert und freigegeben) + `modul-26-telegram-gateway.md` (Telegram-Gateway).
---
## Notation / Audit-Trail
Jede Änderung wird mit folgender Zeile dokumentiert:
```
Geändert von: [Alice | Rain Ocampo]
Datum: DD.MM.YYYY HH:MM
Grund: <Kurzbeschreibung>
```
- **Alice** = Änderungen durch OpenClaw
- **Rain Ocampo** = Änderungen durch Hermes
---
## Geändert
```
Geändert von: Rain Ocampo
Datum: 20.08.2026
Grund: Initiale Repository-Struktur und Modul-03-Dokumentation angelegt.
```
Geändert von: Rain Ocampo
Datum: 20.08.2026
Grund: README aktualisiert — Modul-04 und Modul-05 als healthy/freigegeben eingetragen (Ports intern), Details-Link ergänzt.
Geändert von: Rain Ocampo
Datum: 20.08.2026
Grund: README-Modultabelle aktualisiert — Module 0612 als freigegeben eingetragen; Modul-12-Backtesting als FREIGEGEBEN markiert.
Geändert von: Rain Ocampo
Datum: 20.08.2026
Grund: README-Modultabelle aktualisiert — Modul-12 auf backtesting:0.1.2 (V1.1), Modul-13 Optimization als E2E-VERIFIZIERT eingetragen.
Geändert von: Rain Ocampo
Datum: 20.08.2026
Grund: README-Modultabelle aktualisiert — Modul-13 Optimization als FREIGEGEBEN markiert (Freigabe durch Nutzer 20.08.2026).
Geändert von: Rain Ocampo
Datum: 20.08.2026
Grund: README-Modultabelle aktualisiert — Modul-14 Notification als FREIGEGEBEN eingetragen; Details-Link auf modul-14-notification.md erweitert.
Geändert von: Rain Ocampo
Datum: 20.08.2026
Grund: README-Modultabelle aktualisiert — Modul-15 Monitoring-Control als FREIGEGEBEN eingetragen; Details-Link auf modul-15-monitoring-control.md erweitert.
Geändert von: Rain Ocampo
Datum: 21.08.2026
Grund: README-Modultabelle aktualisiert — Modul-16 Paperclip, Modul-17 Hermes-Agent, Modul-18 Position-Manager als FREIGEGEBEN eingetragen; Details-Link auf modul-18-position-manager.md erweitert.
Geändert von: Rain Ocampo
Datum: 21.08.2026
Grund: README-Modultabelle aktualisiert — Modul-26 Telegram-Gateway als FREIGEGEBEN eingetragen (E2E 20/20, Prompt-/UX-Fix); Modulanzahl auf 19 erweitert.