App passwords (SPEC App. D §D.5): one generated password per app, shown once, revocable on its own, revoked on a password reset; never accepted by the web sign-in. Settings → Security → App passwords (migration 0024). CalDAV / CardDAV server (SPEC Appendix E), built in: /dav/ with /.well-known/caldav|carddav, HTTP Basic with app passwords only (cached checks, throttled failures). The calendar and contacts plugins serve their own tables as collections (Plugin(dav=...)): - calendars as iCalendar: series with overrides, time zones, all-day, attendees and RSVP, alarms <-> reminders; MKCALENDAR / PROPPATCH / DELETE of calendars; subscriptions read-only; writes to upstream-synced calendars flow on upstream; - address books as vCard (3.0 served, 3.0/4.0 read), groups as CATEGORIES; - what a client stores is served back verbatim until the web app edits it; - sync tokens / CTags from change logs filled by triggers (calendar0008, contacts0002), so every write path counts; trimmed nightly after 90 days. REPORTs: calendar-query (time range), calendar-/addressbook-multiget, addressbook-query, sync-collection. nginx and the Vite proxy route /dav/. Settings shows the server and user name to enter; install guide §5.4. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
62 lines
2.2 KiB
Python
62 lines
2.2 KiB
Python
"""REST API routers (SPEC §9.1). One module per route group."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from fastapi import FastAPI
|
|
|
|
|
|
def register_routers(app: FastAPI) -> None:
|
|
"""Mount all API routers under the ``/api`` prefix.
|
|
|
|
Routers are added milestone by milestone; imports are local so the app
|
|
factory stays importable while modules are still being built out.
|
|
"""
|
|
from app.api.accounts import router as accounts_router
|
|
from app.api.actions import router as actions_router
|
|
from app.api.admin import router as admin_router
|
|
from app.api.avatar import router as avatar_router
|
|
from app.api.compose import router as compose_router
|
|
from app.api.mailboxes import router as mailboxes_router
|
|
from app.api.messages import router as messages_router
|
|
from app.api.plugins import router as plugins_router
|
|
from app.api.push import router as push_router
|
|
from app.api.recipients import router as recipients_router
|
|
from app.api.saved_searches import router as saved_searches_router
|
|
from app.api.search import router as search_router
|
|
from app.api.settings import router as settings_router
|
|
from app.api.spellcheck import router as spellcheck_router
|
|
from app.api.threads import router as threads_router
|
|
from app.identity.routes import router as auth_router
|
|
from app.ws import router as ws_router
|
|
|
|
for router in (
|
|
auth_router,
|
|
accounts_router,
|
|
threads_router,
|
|
messages_router,
|
|
search_router,
|
|
actions_router,
|
|
compose_router,
|
|
recipients_router,
|
|
settings_router,
|
|
mailboxes_router,
|
|
saved_searches_router,
|
|
avatar_router,
|
|
plugins_router,
|
|
admin_router,
|
|
spellcheck_router,
|
|
push_router,
|
|
):
|
|
app.include_router(router, prefix="/api")
|
|
app.include_router(ws_router, prefix="/api")
|
|
# CalDAV / CardDAV (SPEC Appendix E): at the root, where clients look for it.
|
|
from app.dav.routes import router as dav_router
|
|
|
|
app.include_router(dav_router)
|
|
|
|
# Mount discovered plugin routers at /api/plugins/{name} (SPEC §11). Hooks are
|
|
# subscribed in the lifespan startup so they register once per process.
|
|
from app.plugins import loader
|
|
|
|
loader.mount_routers(app)
|