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

2.1 KiB

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

Deploy Key (dieses Repo)

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAZp7rLiyNmEm3439yjChUC6TQbP8O7xdfGQyr37MNjh deploy@INSIGHT-Shared

Privater Key: .keys/deploy_shared_ed25519