INSIGHT-MVP/repos/INSIGHT-Shared/BRIEFING.md
Thomas Reitz 36196457ea feat(infra): vollständige Ansible-Struktur Phase 1
- Alle Ansible-Rollen erstellt: common, disk_setup, docker, postgresql,
  pgbouncer, redis, nginx, zabbix_agent
- ansible.cfg mit Pipeline-Optimierung
- hosts.yml mit echten IPs (DBS01=.20, APS01=.21, WEB01=.22)
- group_vars für alle Server (dbs, aps, web)
- Zabbix-Server auf sentinel.xinion.de gesetzt
- vault.yml.example als Vorlage für Secrets
- site.yml nutzt import_playbook (DBS01→APS01→WEB01)
- BRIEFING.md für alle 4 Repos angelegt (Platform, Apps, Infra, Shared)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-15 15:23:29 +01:00

59 lines
2.1 KiB
Markdown

# INSIGHT-Shared — Developer Briefing
> Dieses Dokument ist der Einstiegspunkt für jede neue Claude Code Session in diesem Repo.
> Lies es vollständig bevor du Code schreibst.
## Was ist dieses Repo?
**INSIGHT-Shared** ist das zentrale Wissens- und Vertrags-Repository der INSIGHT-Plattform.
**Kein ausführbarer Code** — ausschließlich Dokumentation, API-Verträge und Architektur-Entscheidungen.
Ziel: Jede Claude Code Session in jedem Repo kann dieses Repo lesen und weiß sofort:
- Was andere Repos liefern
- Welche Interfaces einzuhalten sind
- Was der aktuelle Entwicklungsstand ist
## Struktur & Zuständigkeiten
```
contracts/
├── module-interface.md # InsightModule-Contract (Platform ↔ Apps) — PFLICHTLEKTÜRE für Apps
├── api-platform.md # REST-API von INSIGHT-Platform Core-Service
└── api-crm.md # REST-API von INSIGHT-Apps CRM-Service
architecture/
├── decisions/ # ADRs — Architektur-Entscheidungen mit Begründung
│ ├── 001-plugin-system.md
│ ├── 002-rbac-model.md
│ └── 003-repo-struktur.md
└── overview.md # Gesamtarchitektur
types/
└── shared-types.md # TypeScript Interfaces die alle Repos kennen müssen
dev-status/
├── platform.md # Was ist fertig / läuft / blockiert in INSIGHT-Platform
├── apps.md # Status INSIGHT-Apps
└── infra.md # Status INSIGHT-Infra
```
## Wer liest/schreibt was
| Repo | Liest | Schreibt |
|------|-------|----------|
| INSIGHT-Platform | module-interface.md, dev-status/* | api-platform.md, dev-status/platform.md |
| INSIGHT-Apps | api-platform.md, module-interface.md | api-crm.md, dev-status/apps.md |
| INSIGHT-Infra | dev-status/* | dev-status/infra.md |
## Confluence Dokumentation
- **Projekt-Übersicht:** https://xinion.atlassian.net/wiki/spaces/ProjektINS/overview
- **Konzeptdokument:** https://xinion.atlassian.net/wiki/x/AQCVEw
## Deploy Key (dieses Repo)
```
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAZp7rLiyNmEm3439yjChUC6TQbP8O7xdfGQyr37MNjh deploy@INSIGHT-Shared
```
Privater Key: `.keys/deploy_shared_ed25519`