# Fernzugriff und KI-Zugriff fuer kotsch.tech

Diese Datei ist die kurze Uebergabe fuer dich, andere Entwickler oder eine KI, die in diesem Projekt arbeiten soll.

## Projekt

- Projektordner: `C:\xampp\htdocs\kotsch.tech\kotsch-tech`
- Stack: Laravel 12, PHP 8.2+, Composer, Vite, Tailwind CSS, XAMPP/Apache
- Website-Betrieb laut vorhandener Doku: Cloudflare Tunnel -> Apache/XAMPP auf Port 85 -> Laravel `public/`
- Wichtige Dateien:
  - `routes/web.php` fuer Web-Routen
  - `config/subdomains.php` fuer Subdomain-Registry
  - `resources/views/` fuer Blade-Templates
  - `public/` fuer oeffentliche Assets
  - `app/Http/Controllers/` fuer Controller
  - `tests/` fuer Feature- und Unit-Tests

## Fernzugriff starten

1. Im Projektordner `fernzugriff.bat` doppelklicken.
2. Beim ersten Start im Browser mit deinem Microsoft- oder GitHub-Konto anmelden.
3. Den angezeigten `vscode.dev/tunnel/...`-Link nur an Personen oder KIs weitergeben, denen du Zugriff geben willst.
4. Zum Beenden das BAT-Fenster schliessen oder `STRG+C` druecken.

Vorab pruefen, ohne den Tunnel zu starten:

```bat
fernzugriff.bat --check
```

Der Starter nutzt `code tunnel --name kotsch-tech --accept-server-license-terms`. VS Code Remote Tunnels verlangen Anmeldung und zeigen beim Start einen Link fuer den Zugriff an.

Wenn `fernzugriff.bat --check` bei `code` `[FEHLT]` zeigt:

1. VS Code installieren oder oeffnen.
2. In VS Code die Command Palette oeffnen.
3. `Shell Command: Install 'code' command in PATH` ausfuehren oder beim Windows-Installer die PATH-Option aktivieren.
4. Danach `fernzugriff.bat --check` erneut ausfuehren.

## KI Zugriff geben

Wenn du einer KI Zugriff geben willst:

1. Starte `fernzugriff.bat`.
2. Oeffne den angezeigten VS-Code-Tunnel oder gib der KI den Tunnel-Zugriff in einer Umgebung, der du vertraust.
3. Gib der KI diese Datei als Startanweisung.
4. Sage klar, was sie sehen oder aendern darf.

Empfohlene Startanweisung fuer eine KI:

```text
Arbeite im Projekt C:\xampp\htdocs\kotsch.tech\kotsch-tech.
Lies zuerst fernzugriff.md, README.md, composer.json, package.json und die relevanten Dateien fuer meine Aufgabe.
Du darfst Dateien lesen. Aendere Dateien nur, wenn ich es ausdruecklich sage.
Fasse vor Aenderungen kurz zusammen, welche Dateien du bearbeiten willst.
Fasse nach Aenderungen zusammen, was geaendert wurde und welche Tests/Checks gelaufen sind.
```

## Sicherheitsregeln

- `.env` enthaelt Geheimnisse. Nicht kopieren, nicht an Chats senden, nicht veroeffentlichen.
- Keine anonymen Datei-Manager, keine offenen Schreibzugriffe und keine Freigabe von `C:\xampp\htdocs` komplett.
- Zugriff nur starten, wenn er gebraucht wird, danach wieder beenden.
- Vor Aenderungen `git status --short` pruefen, weil in diesem Projekt bereits viele uncommitted Dateien existieren.
- Keine fremden Aenderungen zuruecksetzen, ausser du sagst es ausdruecklich.

## Nuetzliche Befehle

```bat
git status --short
composer install
npm install
npm run build
php artisan test
php artisan route:list
```

## Hinweise fuer Arbeiten am Projekt

- Die App ist keine kleine statische Seite, sondern ein Laravel-Projekt mit Subdomain-Struktur, News, Tools, Shop-/Admin-Bereichen und vielen Views.
- Bestehende Doku liegt unter `docs/superpowers/`.
- Die vorhandene Infrastruktur-Doku nennt einen Cloudflare Tunnel fuer die Website selbst. Dieser Fernzugriff hier ist davon getrennt und dient nur zum Arbeiten im Projektordner.
- Wenn eine KI Aenderungen macht, soll sie moeglichst kleine, nachvollziehbare Schritte machen und nach jedem Schritt nennen, welche Datei betroffen war.