Hacker-Software/minmal-file-cloud-email-pim-passmanager
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

feat: Kontakte mit Outlook-Feldern + CardDAV-Server + Sharing

Browse Source 
Komplette Kontakte-Ueberarbeitung analog zum Kalender-Ausbau.

Backend-Model:
* AddressBook: color (pro Buch), ausserdem Per-User-Color via
  AddressBookShare.color wie bei CalendarShare.
* Contact: volle Outlook-artige Struktur - prefix/first/middle/
  last/suffix, display_name, nickname, organization, department,
  job_title, birthday, anniversary, notes, photo sowie JSON-
  Spalten fuer mehrfach vorhandene Felder (emails, phones,
  addresses mit allen Adressteilen, websites, impp, categories).

Backend-API:
* REST CRUD uebernimmt die neuen Felder und generiert vCard 3.0
  als Source of Truth fuer CardDAV. Voller vCard-Parser +
  -Builder mit Escape/Unescape, TYPE-Parametern, Line-Folding.
* Neuer Endpoint PUT /addressbooks/<id>/my-color - persoenliche
  Farbe pro Buch ohne den Besitzer zu beeinflussen.
* SSE-Events vom Typ 'addressbook' an Besitzer + alle Share-
  Empfaenger bei jeder Aenderung.

CardDAV-Server (backend/app/dav/carddav.py):
* Volle Discovery via principal - addressbook-home-set wird
  neben calendar-home-set annonciert.
* PROPFIND/REPORT/GET/PUT/DELETE/MKCOL fuer
  /dav/<user>/ab-<id>/ und /<...>/{uid}.vcf
* addressbook-query + addressbook-multiget REPORTs
* ETag-basierte Konfliktpruefung via If-Match/If-None-Match

Frontend (ContactsView.vue):
* Komplett neuer Editor mit vier Tabs: Allgemein (Name, Org),
  Kommunikation (Emails/Phones/Websites/IMPP dynamisch),
  Adressen (mehrere mit allen Teilen), Details (Geburtstag,
  Jahrestag, Kategorien, Notizen).
* Avatar mit Fotoauswahl oder Initialen-Farbkreis.
* Kalender-Sharing-Flow 1:1 uebernommen: Autocomplete fuer
  Benutzersuche, Share-Liste mit Stift zum Bearbeiten, Muelleimer
  zum Entfernen, Per-User-Farbe, CardDAV-URL-Info-Block pro
  Adressbuch, Live-Refresh via SSE.
* Suche durchsucht Displayname, E-Mail und Firma.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Stefan Hacker
2026-04-12 15:16:01 +02:00
parent fbf10197d7
commit 9c102823e4
6 changed files with 1401 additions and 208 deletions
Download Patch File Download Diff File Expand all files Collapse all files
backend/app/models/contact.py
+77 -3
View File
@@ -10,6 +10,7 @@ class AddressBook(db.Model):
owner_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False, index=True)
name = db.Column(db.String(255), nullable=False)
description = db.Column(db.Text, nullable=True)
color = db.Column(db.String(7), default='#3788d8')
created_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc))
updated_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc),
onupdate=lambda: datetime.now(timezone.utc))
@@ -18,6 +19,7 @@ class AddressBook(db.Model):
cascade='all, delete-orphan')
shares = db.relationship('AddressBookShare', backref='address_book', lazy='dynamic',
cascade='all, delete-orphan')
# `owner` wird automatisch durch User.address_books backref erzeugt
def to_dict(self):
return {
@@ -25,6 +27,7 @@ class AddressBook(db.Model):
'owner_id': self.owner_id,
'name': self.name,
'description': self.description,
'color': self.color,
'created_at': self.created_at.isoformat() if self.created_at else None,
}
@@ -36,22 +39,92 @@ class Contact(db.Model):
address_book_id = db.Column(db.Integer, db.ForeignKey('address_books.id'),
nullable=False, index=True)
uid = db.Column(db.String(255), unique=True, nullable=False)
vcard_data = db.Column(db.Text, nullable=False) # Full VCARD
vcard_data = db.Column(db.Text, nullable=False)
# Structured name fields
prefix = db.Column(db.String(64), nullable=True)
first_name = db.Column(db.String(128), nullable=True)
middle_name = db.Column(db.String(128), nullable=True)
last_name = db.Column(db.String(128), nullable=True, index=True)
suffix = db.Column(db.String(64), nullable=True)
display_name = db.Column(db.String(255), nullable=True, index=True)
nickname = db.Column(db.String(128), nullable=True)
# Organisation
organization = db.Column(db.String(255), nullable=True)
department = db.Column(db.String(255), nullable=True)
job_title = db.Column(db.String(255), nullable=True)
# Primary fields for quick listing (denormalised)
primary_email = db.Column(db.String(255), nullable=True, index=True)
primary_phone = db.Column(db.String(50), nullable=True)
# JSON-encoded multi-valued fields
# Each list entry: {"type": "home|work|other|mobile|fax|pager|...", "value": "..."}
emails = db.Column(db.Text, nullable=True)
phones = db.Column(db.Text, nullable=True)
# address: {"type": ..., "street": ..., "po_box": ..., "city": ...,
# "region": ..., "postal_code": ..., "country": ...}
addresses = db.Column(db.Text, nullable=True)
websites = db.Column(db.Text, nullable=True)
impp = db.Column(db.Text, nullable=True) # {"protocol": "skype", "value": "..."}
categories = db.Column(db.Text, nullable=True) # ["family", "work", ...]
# Dates
birthday = db.Column(db.String(10), nullable=True) # YYYY-MM-DD
anniversary = db.Column(db.String(10), nullable=True)
# Free text
notes = db.Column(db.Text, nullable=True)
# Photo: data URL (data:image/jpeg;base64,...) oder http(s)://
photo = db.Column(db.Text, nullable=True)
# Legacy column kept for old clients / migrations
email = db.Column(db.String(255), nullable=True)
phone = db.Column(db.String(50), nullable=True)
created_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc))
updated_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc),
onupdate=lambda: datetime.now(timezone.utc))
def to_dict(self):
import json
def _loads(s, default):
if not s:
return default
try:
return json.loads(s)
except (ValueError, TypeError):
return default
return {
'id': self.id,
'address_book_id': self.address_book_id,
'uid': self.uid,
'prefix': self.prefix,
'first_name': self.first_name,
'middle_name': self.middle_name,
'last_name': self.last_name,
'suffix': self.suffix,
'display_name': self.display_name,
'email': self.email,
'phone': self.phone,
'nickname': self.nickname,
'organization': self.organization,
'department': self.department,
'job_title': self.job_title,
'emails': _loads(self.emails, []),
'phones': _loads(self.phones, []),
'addresses': _loads(self.addresses, []),
'websites': _loads(self.websites, []),
'impp': _loads(self.impp, []),
'categories': _loads(self.categories, []),
'birthday': self.birthday,
'anniversary': self.anniversary,
'notes': self.notes,
'photo': self.photo,
'primary_email': self.primary_email or self.email,
'primary_phone': self.primary_phone or self.phone,
'created_at': self.created_at.isoformat() if self.created_at else None,
'updated_at': self.updated_at.isoformat() if self.updated_at else None,
}
@@ -65,6 +138,7 @@ class AddressBookShare(db.Model):
nullable=False, index=True)
shared_with_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False, index=True)
permission = db.Column(db.String(20), nullable=False, default='read')
color = db.Column(db.String(7), nullable=True) # personal display color
shared_with = db.relationship('User', backref='shared_address_books')