Files
finetuning-plattform-setup-…/README.md
m17hr1l f3d6d6b6d3 Add db/dev-snapshot.sql with Stephan's local working state
Full mariadb-dump (schema + data) from the live develop instance,
post-NFP-18 migration. Includes test data new devs can immediately
poke at instead of staring at an empty dashboard.

Contents:
  - 36 tables (full schema)
  - 2 users (admin@finetune.ai/admin123, testuser@example.com/test123)
  - 5 datasets, 1 job (Support Bot v1, completed), 1 model
  - 1 user_billing row, 5 user_settings rows
  - 8 email_templates, 3 ACL roles, all migrations table state

Sanitization applied at the end of the dump (POST-LOAD block):
  - user.user_pass set to NULL (legacy AES-encrypted passwords;
    post-NFP-18 auth uses user_password_hash only)
  - user_settings values for keys matching token/key/secret/password/api
    set to empty string (devs add their own HF token, etc.)
  - user_password_hash for both default users reset to freshly-generated
    argon2id hashes that verify against the documented plaintexts

bootstrap-db.sh adds NFP_USE_SNAPSHOT=1 to load this instead of the
clean 3-file path. Both routes arrive at the same credentials.

Verified end-to-end:
  - dump loads on a fresh DB (exit 0)
  - both default credentials authenticate via password_verify
  - all data rows preserved
  - no credential-shaped strings in non-comment lines
2026-05-14 13:15:32 +02:00

59 lines
2.1 KiB
Markdown

# 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).