# 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`
