marcandClaude Opus 5
f71ab710e1
Bisher konnte ein CalDAV-Client Termine verwalten, aber keine Kalender:
MKCALENDAR -> 405 anlegen
PROPPATCH -> 501 umbenennen, umfaerben
DELETE -> 404 loeschen
go-webdav deckt davon nur MKCOL ab, und selbst da verwarf unser Backend
die vom Client gewaehlte Adresse. Alle drei Verben faengt der Handler
jetzt vorher ab (collections.go).
Der Kern steckt aber nicht in den Verben, sondern in der Adresse: Bei
MKCALENDAR sucht *der Client* aus, wo der Kalender liegen soll
("…/calendars/max/arbeit/"). Unsere Kalender lagen bisher zwingend unter
ihrer UUID -- der Client haette angelegt und auf seine eigene Adresse
sofort ein 404 bekommen.
Deshalb Migration 23 mit einer Spalte path_segment: gesetzt = die
gewaehlte Adresse, NULL = es gilt weiterhin die UUID. Bestehende
Kalender bleiben damit unter genau der Adresse erreichbar, unter der die
eingerichteten Geraete sie kennen -- ein Wechsel haette jedes Telefon
dazu gebracht, seine Termine fuer geloescht zu halten. Aufgeloest wird
beides in einer Abfrage (GetCalendarByRef), die gewaehlte Adresse hat
Vorrang.
PROPPATCH antwortet mit einem Status je Eigenschaft, auch wenn alles
geklappt hat: Es kann teilweise gelingen, und ein nacktes 200
verschwiege, welcher Teil angekommen ist. Was wir nicht aendern koennen,
bekommt 403 statt stillem Schlucken -- ein Client, der seine Aenderung
fuer angekommen haelt, ist schlimmer dran als einer mit klarer Absage.
Ebenso eine unlesbare Farbe: absagen statt raten.
DELETE auf eine Sammlung loescht den Kalender mitsamt allen Terminen --
das ist in WebDAV seine Bedeutung.
CalDAV-Selbsttest von 45 auf 62 Pruefungen: anlegen, unter der
gewaehlten Adresse erreichbar, Farbe aus dem MKCALENDAR uebernommen,
Termin darin ablegen und abrufen, zweites Anlegen auf dieselbe Adresse
405, umbenennen und umfaerben mit Status je Eigenschaft, loeschen, danach
404 -- und dasselbe noch einmal ueber MKCOL, das Verb, das DAVx5 nimmt.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
59 lines
2.2 KiB
Go
59 lines
2.2 KiB
Go
// Package calendar ist ein eigenständiges Modul, kein Kernbestandteil:
|
||
// CalDAV für Termine und Aufgaben. Es importiert nichts aus files, sharing
|
||
// oder admin – nur auth und acl, wie jeder andere Bereich auch. Ist es
|
||
// abgeschaltet, gibt es keine Route und keinen Menüpunkt; die Tabellen
|
||
// bleiben dann einfach ungenutzt liegen. Siehe kalender-plan.md.
|
||
package calendar
|
||
|
||
import (
|
||
"time"
|
||
|
||
"github.com/google/uuid"
|
||
)
|
||
|
||
// Calendar ist eine Sammlung von Terminen/Aufgaben – das, was ein Client als
|
||
// einen Kalender in seiner Liste zeigt.
|
||
type Calendar struct {
|
||
ID uuid.UUID `json:"id"`
|
||
OwnerID uuid.UUID `json:"owner_id"`
|
||
Name string `json:"name"`
|
||
Color string `json:"color"`
|
||
Description string `json:"description"`
|
||
SupportsTodo bool `json:"supports_todo"`
|
||
// TimeZone ist die Vorgabe für neue Termine, die die Web-Oberfläche
|
||
// künftig hier anlegt (Phase 3). CalDAV selbst braucht sie nicht –
|
||
// jeder Termin trägt seine Zeitzone bereits im .ics.
|
||
TimeZone string `json:"timezone"`
|
||
// PathSegment ist die Adresse, unter der ein Client diesen Kalender
|
||
// angelegt hat ("…/calendars/max/arbeit/"). Leer heißt: keine gewählte
|
||
// Adresse, es gilt die UUID. Siehe Ref.
|
||
PathSegment string `json:"-"`
|
||
CTag int64 `json:"ctag"`
|
||
CreatedAt time.Time `json:"created_at"`
|
||
}
|
||
|
||
// Ref ist das Pfadsegment, unter dem dieser Kalender in CalDAV erreichbar
|
||
// ist: die vom Client gewählte Adresse, sonst die UUID.
|
||
func (c *Calendar) Ref() string {
|
||
if c.PathSegment != "" {
|
||
return c.PathSegment
|
||
}
|
||
return c.ID.String()
|
||
}
|
||
|
||
// Object ist ein einzelner Termin oder eine Aufgabe. Data ist die
|
||
// vollständige .ics-Datei, unverändert wie vom Client geschickt – siehe
|
||
// kalender-plan.md, Abschnitt "Felder".
|
||
type Object struct {
|
||
ID uuid.UUID `json:"id"`
|
||
CalendarID uuid.UUID `json:"calendar_id"`
|
||
UID string `json:"uid"`
|
||
Component string `json:"component"` // "VEVENT" | "VTODO"
|
||
Data string `json:"-"`
|
||
ETag string `json:"etag"`
|
||
DTStart *time.Time `json:"dtstart,omitempty"`
|
||
DTEnd *time.Time `json:"dtend,omitempty"`
|
||
CreatedAt time.Time `json:"created_at"`
|
||
UpdatedAt time.Time `json:"updated_at"`
|
||
}
|