Schritt 1: src-Layout mit FastAPI-Stack, SQLAlchemy-2.x-Modell inkl. Buchführung für Kopiermodus und Quarantäne, Alembic-Migration 0001, strukturierte Logs, CLI (migrate/version), Changelog und Devlog. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
32 lines
1.1 KiB
Markdown
32 lines
1.1 KiB
Markdown
# NetMover
|
|
|
|
Selbst gehosteter Dienst mit Web-Oberfläche, der SMB/CIFS- und NFS-Freigaben
|
|
verwaltet und Dateien zeitgesteuert zwischen ihnen verschiebt.
|
|
|
|
> Status: in Entwicklung (Schritt 1 von 6). Vollständige Doku folgt mit Schritt 6.
|
|
|
|
## Entwicklung
|
|
|
|
```bash
|
|
python3 -m venv .venv # oder: --without-pip + get-pip.py
|
|
.venv/bin/pip install -e '.[dev]'
|
|
.venv/bin/pytest
|
|
.venv/bin/ruff check . && .venv/bin/ruff format --check . && .venv/bin/mypy
|
|
NETMOVER_DATA_DIR=$PWD/data .venv/bin/netmover migrate
|
|
```
|
|
|
|
Neue Migration nach Modelländerung:
|
|
|
|
```bash
|
|
NETMOVER_DATA_DIR=$PWD/data .venv/bin/alembic revision --autogenerate -m "…"
|
|
```
|
|
|
|
## Arbeitsweise
|
|
|
|
- Commits nach [Conventional Commits](https://www.conventionalcommits.org/de/)
|
|
(`feat:`, `fix:`, `docs:`, `test:`, `chore:` …).
|
|
- Jede nutzerrelevante Änderung bekommt einen Eintrag unter `[Unreleased]` in
|
|
[CHANGELOG.md](CHANGELOG.md). Beim Release wird der Abschnitt versioniert,
|
|
die Version in `src/netmover/__init__.py` angehoben und ein Tag `vX.Y.Z` gesetzt.
|
|
- Arbeitszeit und Entscheidungen: [DEVLOG.md](DEVLOG.md).
|