Files
minmal-file-cloud-email-pim…/backend/app/services/system_mail.py
T
Stefan Hacker e811210977 feat: System-Email-Benachrichtigungen bei Freigaben und Benutzer-Erstellung
Automatische E-Mail-Benachrichtigungen ueber die konfigurierte
System-Email bei folgenden Ereignissen:

- Datei/Ordner mit Benutzer geteilt -> Empfaenger wird benachrichtigt
- Share-Link heruntergeladen -> Ersteller wird benachrichtigt (mit IP)
- Kalender mit Benutzer geteilt -> Empfaenger wird benachrichtigt
- Adressbuch mit Benutzer geteilt -> Empfaenger wird benachrichtigt
- Passwort-Eintrag/-Ordner geteilt -> Empfaenger wird benachrichtigt
- Admin erstellt neuen Benutzer -> Neuer Benutzer wird benachrichtigt

Alle Benachrichtigungen sind fail-safe (try/except), damit die
eigentliche Aktion nie durch Email-Fehler blockiert wird.
Emails werden nur gesendet wenn System-SMTP konfiguriert ist UND
der Empfaenger eine Email-Adresse hat.

Neuer Service: app/services/system_mail.py mit zentralem Helper

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-11 18:31:19 +02:00

153 lines
5.5 KiB
Python

"""System email sending helper. Uses the admin-configured SMTP settings."""
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
def send_system_email(to, subject, body_text, body_html=None):
"""Send an email via the system SMTP configuration.
Returns (success: bool, error: str|None)
"""
from app.models.settings import AppSettings
host = AppSettings.get('system_smtp_host', '')
port = int(AppSettings.get('system_smtp_port', '587'))
ssl = AppSettings.get_bool('system_smtp_ssl', default=True)
username = AppSettings.get('system_smtp_username', '')
password = AppSettings.get('system_smtp_password', '')
from_addr = AppSettings.get('system_email_from', '') or username
if not host or not username or not password:
return False, 'System-Email nicht konfiguriert'
try:
if body_html:
msg = MIMEMultipart('alternative')
msg.attach(MIMEText(body_text, 'plain', 'utf-8'))
msg.attach(MIMEText(body_html, 'html', 'utf-8'))
else:
msg = MIMEText(body_text, 'plain', 'utf-8')
msg['From'] = from_addr
msg['To'] = to
msg['Subject'] = subject
if ssl and port == 465:
server = smtplib.SMTP_SSL(host, port, timeout=10)
else:
server = smtplib.SMTP(host, port, timeout=10)
server.starttls()
server.login(username, password)
server.sendmail(from_addr, [to], msg.as_string())
server.quit()
return True, None
except Exception as e:
return False, str(e)
def notify_share_link_accessed(share_link, file_name, accessor_ip):
"""Notify the share link creator that someone accessed their shared file."""
from app.models.user import User
creator = User.query.get(share_link.created_by)
if not creator or not creator.email:
return
subject = f'Mini-Cloud: Zugriff auf geteilte Datei "{file_name}"'
body = (
f'Hallo {creator.username},\n\n'
f'Jemand hat auf deine geteilte Datei zugegriffen:\n\n'
f' Datei: {file_name}\n'
f' IP-Adresse: {accessor_ip}\n'
f' Downloads bisher: {share_link.download_count}\n\n'
f'Falls du diesen Zugriff nicht erwartet hast, kannst du den '
f'Freigabe-Link in deiner Mini-Cloud loeschen.\n\n'
f'Deine Mini-Cloud'
)
send_system_email(creator.email, subject, body)
def notify_file_shared_with_user(file_name, owner_username, target_user):
"""Notify a user that a file/folder was shared with them."""
if not target_user.email:
return
subject = f'Mini-Cloud: "{file_name}" wurde mit dir geteilt'
body = (
f'Hallo {target_user.username},\n\n'
f'{owner_username} hat "{file_name}" mit dir geteilt.\n\n'
f'Melde dich in deiner Mini-Cloud an, um die Datei zu sehen.\n\n'
f'Deine Mini-Cloud'
)
send_system_email(target_user.email, subject, body)
def notify_calendar_shared(calendar_name, owner_username, target_user, permission):
"""Notify a user that a calendar was shared with them."""
if not target_user.email:
return
perm_text = 'Lesen' if permission == 'read' else 'Lesen und Schreiben'
subject = f'Mini-Cloud: Kalender "{calendar_name}" wurde mit dir geteilt'
body = (
f'Hallo {target_user.username},\n\n'
f'{owner_username} hat den Kalender "{calendar_name}" mit dir geteilt.\n'
f'Berechtigung: {perm_text}\n\n'
f'Melde dich in deiner Mini-Cloud an, um den Kalender zu sehen.\n\n'
f'Deine Mini-Cloud'
)
send_system_email(target_user.email, subject, body)
def notify_contacts_shared(addressbook_name, owner_username, target_user, permission):
"""Notify a user that an address book was shared with them."""
if not target_user.email:
return
perm_text = 'Lesen' if permission == 'read' else 'Lesen und Schreiben'
subject = f'Mini-Cloud: Adressbuch "{addressbook_name}" wurde mit dir geteilt'
body = (
f'Hallo {target_user.username},\n\n'
f'{owner_username} hat das Adressbuch "{addressbook_name}" mit dir geteilt.\n'
f'Berechtigung: {perm_text}\n\n'
f'Melde dich in deiner Mini-Cloud an.\n\n'
f'Deine Mini-Cloud'
)
send_system_email(target_user.email, subject, body)
def notify_password_shared(shareable_type, owner_username, target_user, permission):
"""Notify a user that passwords were shared with them."""
if not target_user.email:
return
type_text = 'Ein Passwort-Ordner' if shareable_type == 'folder' else 'Ein Passwort-Eintrag'
subject = f'Mini-Cloud: {type_text} wurde mit dir geteilt'
body = (
f'Hallo {target_user.username},\n\n'
f'{owner_username} hat {type_text.lower()} mit dir geteilt.\n'
f'Berechtigung: {permission}\n\n'
f'Melde dich in deiner Mini-Cloud an, um die Passwoerter zu sehen.\n\n'
f'Deine Mini-Cloud'
)
send_system_email(target_user.email, subject, body)
def notify_user_created(user, created_by_username):
"""Notify a newly created user about their account."""
if not user.email:
return
subject = 'Mini-Cloud: Dein Konto wurde erstellt'
body = (
f'Hallo {user.username},\n\n'
f'{created_by_username} hat ein Konto fuer dich in der Mini-Cloud erstellt.\n\n'
f'Benutzername: {user.username}\n\n'
f'Bitte melde dich an und aendere dein Passwort.\n\n'
f'Deine Mini-Cloud'
)
send_system_email(user.email, subject, body)