mirror of
https://github.com/skoelle/dyndns-updater.git
synced 2026-09-17 16:10:25 +00:00
44 lines
1.6 KiB
Markdown
44 lines
1.6 KiB
Markdown
# AGENTS.md
|
||
|
||
## Projekt
|
||
|
||
Kleiner Docker-Container, der Cloudflare-A-Records (DNS-only) + eine FreeDNS-URL mit der
|
||
aktuellen öffentlichen IPv4-Adresse pflegt. IP wird ausschließlich über die FritzBox
|
||
TR-064-Schnittstelle ermittelt.
|
||
|
||
Kontext: [`SPEC.md`](SPEC.md) (Design), [`PLAN.md`](PLAN.md) (Tasks),
|
||
[`README.md`](README.md) (Betrieb).
|
||
|
||
## Struktur
|
||
|
||
- `app/` – Kernmodule (Python 3.12)
|
||
- `config.py` – ENV-basierte Konfiguration + Validierung
|
||
- `state.py` – persistierte letzte IP (`/data/last-known-ip.json`)
|
||
- `fritzbox.py` – IP-Ermittlung via TR-064 (Retry/Backoff)
|
||
- `cloudflare.py` – A-Record-Update (DNS-only)
|
||
- `freedns.py` – FreeDNS-Update-Call
|
||
- `healthcheck.py` – Healthchecks-Pings
|
||
- `main.py` – Flask-Webhook (`/webhook/update`, `/healthz`) + Poll-Scheduler
|
||
- `.env.example` – Referenz aller ENV-Variablen (Pflicht: FRITZBOX_*, CLOUDFLARE_*)
|
||
|
||
## Befehle
|
||
|
||
- Tests: keine Test-Suite vorhanden
|
||
- Lint/Format: `ruff check .` und `ruff format --check .` (in `.venv` via
|
||
`python3 -m venv .venv && . .venv/bin/activate`)
|
||
- Lokal: `python -m app.main` (im `.venv`, deps aus `requirements.txt`)
|
||
- Container: `docker compose up -d`
|
||
|
||
## Konventionen
|
||
|
||
- CREDENTIALS NIE committen. `.env` und `data/` sind gitignored – nie mit `-f` hinzufügen.
|
||
- Keine Co-Autoren in Commits.
|
||
- Keine Kommentare im Code außer auf Nachfrage.
|
||
- Python-Code mit Ruff formatieren (line-length 100, double quotes).
|
||
- Änderungen an `SPEC.md`/`PLAN.md`/`README.md` mitziehen, wenn sich Design/Betrieb ändert.
|
||
|
||
## Lizenz
|
||
|
||
MIT – Copyright Stefan Koelle (https://stefankoelle.de). Lizenz-Header bei neuen
|
||
Quellcode-Dateien ergänzen, wenn möglich mit `/add-license`.
|