Architecture Overview

AutoDoc Architecture

This section contains the architectural documentation for AutoDoc.

Documents

Application Lifecycle

Describes how the application starts, initializes, and processes HTTP requests.

• Application Lifecycle

Document Processing

Placeholder detection, values input, computed aliases, real page counting via LibreOffice, and page-fit generation — the core of what AutoDoc does.

• Document Processing

Authentication & Member Management

Roles, endpoints, self-action guards, and the built-in admin UI.

• Member Management

Deployment Documentation

Deployment guides, including the portable LibreOffice setup, are located in:

docs/deployment/

Development Principles

• Every document belongs to exactly one member (owner_id-scoped) and is never shared
• Everything server-side — no feature should require a member's own PC
• Page count should not change during generation unless truly unavoidable, and the member is always told when it couldn't be kept
• Graceful degradation when LibreOffice isn't available (e.g. local development) rather than hard failures