Dateianhänge an Anleitungen #97

Closed
opened 2026-11-05 11:36:20 +01:00 by miko · 1 comment
Owner

An Anleitungen können Dateien zum Download hängen: STL, 3MF, SVG, DXF, G-Code, PDF-Handbücher, Firmware usw.

Blocked by: #106

Entscheidungen

  • Nur an Anleitungen, nicht an Schritten. Mehrere Dateien pro Anleitung, mit Anzeigename und optionaler Beschreibung.
  • Die Liste zeigt Größe und Typ in der Anleitung; im PDF erscheint sie als Hinweis.
  • Gespeichert werden die Dateien wie Bilder im lokalen Dateisystem hinter der Media-Route mit Visibility-Prüfung (ADR-0006).
  • Ausgeliefert immer als Download: Content-Disposition: attachment und X-Content-Type-Options: nosniff, sodass nichts im Browser angezeigt oder ausgeführt wird.
  • Ausführbare Dateien sind verboten:
    • Feste Sperrliste nach Endung: exe msi bat cmd com scr pif ps1 vbs js jar sh app dmg pkg deb rpm apk.
    • Zusätzlich wird jede Datei mit Windows-Programmkopf (MZ) abgelehnt, egal welche Endung.
    • Erlaubt bleiben Firmware (.bin, .hex, .uf2, .elf) und G-Code. ELF wird bewusst nicht erkannt, weil ESP- und Arduino-Firmware oft .elf ist.
  • Maximale Größe pro Datei ist eine Setting, Standard 50 MB.
  • Anhänge gehören zum versionierten Inhalt (#106). Die Dateien bleiben erhalten, solange eine Version oder die Working Copy sie referenziert.
  • Doku:
    • Neue ADR: ausführbare Dateien werden gesperrt und Anhänge nur als Download ausgeliefert.
    • GLOSSARY.md: Eintrag Attachment ergänzen.
An Anleitungen können Dateien zum Download hängen: STL, 3MF, SVG, DXF, G-Code, PDF-Handbücher, Firmware usw. Blocked by: #106 ## Entscheidungen - **Nur an Anleitungen**, nicht an Schritten. Mehrere Dateien pro Anleitung, mit Anzeigename und optionaler Beschreibung. - Die Liste zeigt Größe und Typ in der Anleitung; im PDF erscheint sie als Hinweis. - Gespeichert werden die Dateien wie Bilder im lokalen Dateisystem hinter der Media-Route mit Visibility-Prüfung (ADR-0006). - **Ausgeliefert immer als Download**: `Content-Disposition: attachment` und `X-Content-Type-Options: nosniff`, sodass nichts im Browser angezeigt oder ausgeführt wird. - **Ausführbare Dateien sind verboten**: - Feste Sperrliste nach Endung: `exe msi bat cmd com scr pif ps1 vbs js jar sh app dmg pkg deb rpm apk`. - Zusätzlich wird jede Datei mit Windows-Programmkopf (`MZ`) abgelehnt, egal welche Endung. - Erlaubt bleiben Firmware (`.bin`, `.hex`, `.uf2`, `.elf`) und G-Code. ELF wird bewusst nicht erkannt, weil ESP- und Arduino-Firmware oft `.elf` ist. - **Maximale Größe pro Datei** ist eine **Setting**, Standard 50 MB. - Anhänge gehören zum **versionierten Inhalt** (#106). Die Dateien bleiben erhalten, solange eine Version oder die Working Copy sie referenziert. - Doku: - Neue ADR: ausführbare Dateien werden gesperrt und Anhänge nur als Download ausgeliefert. - GLOSSARY.md: Eintrag **Attachment** ergänzen.
miko referenced this issue from a commit 2026-11-05 15:28:27 +01:00
Author
Owner

Implemented in #117 (feature/97-attachments → development).

Implemented in #117 (feature/97-attachments → development).
miko closed this issue 2026-11-05 15:28:30 +01:00
Sign in to join this conversation.
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
MassiveDynamic/kataba#97
No description provided.