# Neuronetz Finetuning Platform — Setup Delta

Drop-in setup for new developers joining the platform.

→ **Start with [`MANUAL.md`](MANUAL.md)** — full developer manual with quick-start at the top.

## Quick orientation

```
MANUAL.md              ← full software manual, setup at front
bootstrap-db.sh        ← one-command DB initialization
db/01-schema.sql       ← MariaDB schema (no data)
db/02-seed.sql         ← reference data: ACL, email templates, API registry
db/03-default-users.sql ← admin@finetune.ai / admin123 and testuser@example.com / test123
db/dev-snapshot.sql    ← Stephan's working state with test data — 5 datasets, 1 job,
                         1 model, etc. Secrets pre-scrubbed. Use this if you want
                         a populated platform instead of an empty one.
```

## Two bootstrap modes

**Clean install** (default) — empty platform, just users + reference data:
```bash
./bootstrap-db.sh
```

**Dev snapshot** — Stephan's local state with test data preloaded:
```bash
NFP_USE_SNAPSHOT=1 ./bootstrap-db.sh
```

Both arrive at the same credentials (`admin@finetune.ai/admin123`, `testuser@example.com/test123`). The snapshot just gives you something to look at on day 1.

## TL;DR (10 min for experienced devs)

```bash
# /etc/hosts (one line)
sudo sh -c 'echo "127.0.0.1 local.finetune.neuronetz.ai local.websocket.finetune.neuronetz.ai local.redis-commander.neuronetz.ai local.graylog.finetune.neuronetz.ai local.kibana.finetune.neuronetz.ai" >> /etc/hosts'

# clone both repos as siblings
mkdir -p ~/PhpstormProjects && cd ~/PhpstormProjects
git clone ssh://git@gitea.neuronetz.ai:222/Neuronetz/finetuning-plattform.git
git clone ssh://git@gitea.neuronetz.ai:222/m17hr1l/finetuning-plattform-setup-delta.git

# start the stack
cd finetuning-plattform && git checkout develop
cd local && docker compose up -d
cd ../..

# bootstrap the DB
cd finetuning-plattform-setup-delta
./bootstrap-db.sh

# done — open http://local.finetune.neuronetz.ai/auth/login
# admin@finetune.ai / admin123
```

Anything else: see `MANUAL.md` §4 (Troubleshooting Setup) and §21 (Common Gotchas).