Phase 8: Customizable PDF Templates — locale support, admin editor, seed templates

Backend: - PdfTemplate model with locale field + UNIQUE(name, locale) constraint - Migration 007: pdf_templates table + template_id FK on generated_pdfs - Template service: CRUD, Jinja2 validation, render preview with sample data - Admin endpoints: CRUD /admin/pdf-templates + POST preview - User endpoint: GET /pdf/templates (active templates list) - pdf_service: resolves template from DB by ID or falls back to default for the appropriate locale - AI generate_pdf tool accepts optional template_id - Seed script + 4 HTML template files: - Basic Report (en/ru) — general-purpose report - Medical Report (en/ru) — health-focused with disclaimers Frontend: - Admin PDF templates page with editor, locale selector, live preview (iframe), template variables reference panel - PDF page: template selector dropdown in generation form - API clients for admin CRUD + user template listing - Sidebar: admin templates link - English + Russian translations Also added Phase 9 (OAuth) and Phase 10 (Rate Limits) placeholders to GeneralPlan. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 15:32:35 +03:00
parent b0790d719c
commit bb53eeee8e
26 changed files with 1077 additions and 16 deletions
--- a/backend/app/api/v1/admin.py
+++ b/backend/app/api/v1/admin.py
@@ -21,7 +21,15 @@ from app.schemas.admin import (
    AdminUserUpdateRequest,
 )
 from app.schemas.setting import SettingResponse, SettingsListResponse, UpdateSettingRequest
-from app.services import context_service, skill_service, setting_service, admin_user_service
+from app.schemas.pdf_template import (
+    CreatePdfTemplateRequest,
+    PdfTemplateListResponse,
+    PdfTemplateResponse,
+    PreviewRequest,
+    PreviewResponse,
+    UpdatePdfTemplateRequest,
+)
+from app.services import context_service, skill_service, setting_service, admin_user_service, pdf_template_service

 router = APIRouter(prefix="/admin", tags=["admin"])

@@ -150,3 +158,63 @@ async def update_setting(
 ):
    setting = await setting_service.upsert_setting(db, key, data.value, admin.id)
    return SettingResponse.model_validate(setting)
+
+
+# --- PDF Templates ---
+
+@router.get("/pdf-templates", response_model=PdfTemplateListResponse)
+async def list_pdf_templates(
+    _admin: Annotated[User, Depends(require_admin)],
+    db: Annotated[AsyncSession, Depends(get_db)],
+):
+    templates = await pdf_template_service.list_templates(db, active_only=False)
+    return PdfTemplateListResponse(templates=[PdfTemplateResponse.model_validate(t) for t in templates])
+
+
+@router.post("/pdf-templates", response_model=PdfTemplateResponse, status_code=status.HTTP_201_CREATED)
+async def create_pdf_template(
+    data: CreatePdfTemplateRequest,
+    _admin: Annotated[User, Depends(require_admin)],
+    db: Annotated[AsyncSession, Depends(get_db)],
+):
+    template = await pdf_template_service.create_template(db, **data.model_dump())
+    return PdfTemplateResponse.model_validate(template)
+
+
+@router.get("/pdf-templates/{template_id}", response_model=PdfTemplateResponse)
+async def get_pdf_template(
+    template_id: uuid.UUID,
+    _admin: Annotated[User, Depends(require_admin)],
+    db: Annotated[AsyncSession, Depends(get_db)],
+):
+    template = await pdf_template_service.get_template(db, template_id)
+    return PdfTemplateResponse.model_validate(template)
+
+
+@router.patch("/pdf-templates/{template_id}", response_model=PdfTemplateResponse)
+async def update_pdf_template(
+    template_id: uuid.UUID,
+    data: UpdatePdfTemplateRequest,
+    _admin: Annotated[User, Depends(require_admin)],
+    db: Annotated[AsyncSession, Depends(get_db)],
+):
+    template = await pdf_template_service.update_template(db, template_id, **data.model_dump(exclude_unset=True))
+    return PdfTemplateResponse.model_validate(template)
+
+
+@router.delete("/pdf-templates/{template_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_pdf_template(
+    template_id: uuid.UUID,
+    _admin: Annotated[User, Depends(require_admin)],
+    db: Annotated[AsyncSession, Depends(get_db)],
+):
+    await pdf_template_service.delete_template(db, template_id)
+
+
+@router.post("/pdf-templates/preview", response_model=PreviewResponse)
+async def preview_pdf_template(
+    data: PreviewRequest,
+    _admin: Annotated[User, Depends(require_admin)],
+):
+    html = await pdf_template_service.render_preview(data.html_content)
+    return PreviewResponse(html=html)
--- a/backend/app/api/v1/pdf.py
+++ b/backend/app/api/v1/pdf.py
@@ -10,11 +10,23 @@ from app.api.deps import get_current_user
 from app.database import get_db
 from app.models.user import User
 from app.schemas.pdf import GeneratePdfRequest, PdfListResponse, PdfResponse
-from app.services import pdf_service
+from app.schemas.pdf_template import PdfTemplateSummaryListResponse, PdfTemplateSummaryResponse
+from app.services import pdf_service, pdf_template_service

 router = APIRouter(prefix="/pdf", tags=["pdf"])


+@router.get("/templates", response_model=PdfTemplateSummaryListResponse)
+async def list_available_templates(
+    _user: Annotated[User, Depends(get_current_user)],
+    db: Annotated[AsyncSession, Depends(get_db)],
+):
+    templates = await pdf_template_service.list_templates(db, active_only=True)
+    return PdfTemplateSummaryListResponse(
+        templates=[PdfTemplateSummaryResponse.model_validate(t) for t in templates]
+    )
+
+
@router.post("/compile", response_model=PdfResponse, status_code=status.HTTP_201_CREATED)
 async def compile_pdf(
    data: GeneratePdfRequest,
@@ -22,7 +34,7 @@ async def compile_pdf(
    db: Annotated[AsyncSession, Depends(get_db)],
 ):
    pdf = await pdf_service.generate_pdf_report(
-        db, user.id, data.title, data.document_ids or None, data.chat_id,
+        db, user.id, data.title, data.document_ids or None, data.chat_id, data.template_id,
    )
    return PdfResponse.model_validate(pdf)

--- a/backend/app/models/init.py
+++ b/backend/app/models/init.py
@@ -9,8 +9,9 @@ from app.models.memory_entry import MemoryEntry
 from app.models.notification import Notification
 from app.models.setting import Setting
 from app.models.generated_pdf import GeneratedPdf
+from app.models.pdf_template import PdfTemplate

 __all__ = [
    "User", "Session", "Chat", "Message", "ContextFile", "Skill",
-    "Document", "MemoryEntry", "Notification", "Setting", "GeneratedPdf",
+    "Document", "MemoryEntry", "Notification", "Setting", "GeneratedPdf", "PdfTemplate",
 ]
--- a/backend/app/models/generated_pdf.py
+++ b/backend/app/models/generated_pdf.py
@@ -20,4 +20,9 @@ class GeneratedPdf(Base):
        UUID(as_uuid=True), ForeignKey("chats.id", ondelete="SET NULL"), nullable=True
    )

+    template_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("pdf_templates.id", ondelete="SET NULL"), nullable=True
+    )
+
    user: Mapped["User"] = relationship(back_populates="generated_pdfs")  # noqa: F821
+    template: Mapped["PdfTemplate | None"] = relationship()  # noqa: F821
--- a/backend/app/models/pdf_template.py
+++ b/backend/app/models/pdf_template.py
@@ -0,0 +1,16 @@
+from sqlalchemy import Boolean, String, Text, UniqueConstraint
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.database import Base
+
+
+class PdfTemplate(Base):
+    __tablename__ = "pdf_templates"
+    __table_args__ = (UniqueConstraint("name", "locale", name="uq_pdf_templates_name_locale"),)
+
+    name: Mapped[str] = mapped_column(String(100), nullable=False)
+    locale: Mapped[str] = mapped_column(String(10), nullable=False, default="en")
+    description: Mapped[str | None] = mapped_column(Text, nullable=True)
+    html_content: Mapped[str] = mapped_column(Text, nullable=False)
+    is_default: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
+    is_active: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True)
--- a/backend/app/schemas/pdf.py
+++ b/backend/app/schemas/pdf.py
@@ -8,6 +8,7 @@ class GeneratePdfRequest(BaseModel):
    title: str = Field(min_length=1, max_length=255)
    document_ids: list[uuid.UUID] = []
    chat_id: uuid.UUID | None = None
+    template_id: uuid.UUID | None = None


 class PdfResponse(BaseModel):
@@ -16,6 +17,7 @@ class PdfResponse(BaseModel):
    title: str
    source_document_ids: list[uuid.UUID] | None
    source_chat_id: uuid.UUID | None
+    template_id: uuid.UUID | None
    created_at: datetime

    model_config = {"from_attributes": True}
--- a/backend/app/schemas/pdf_template.py
+++ b/backend/app/schemas/pdf_template.py
@@ -0,0 +1,59 @@
+import uuid
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+
+class CreatePdfTemplateRequest(BaseModel):
+    name: str = Field(min_length=1, max_length=100)
+    locale: str = Field(default="en", min_length=2, max_length=10)
+    description: str | None = None
+    html_content: str = Field(min_length=1)
+
+
+class UpdatePdfTemplateRequest(BaseModel):
+    name: str | None = Field(default=None, min_length=1, max_length=100)
+    locale: str | None = Field(default=None, min_length=2, max_length=10)
+    description: str | None = None
+    html_content: str | None = Field(default=None, min_length=1)
+    is_active: bool | None = None
+
+
+class PdfTemplateResponse(BaseModel):
+    id: uuid.UUID
+    name: str
+    locale: str
+    description: str | None
+    html_content: str
+    is_default: bool
+    is_active: bool
+    created_at: datetime
+
+    model_config = {"from_attributes": True}
+
+
+class PdfTemplateListResponse(BaseModel):
+    templates: list[PdfTemplateResponse]
+
+
+class PdfTemplateSummaryResponse(BaseModel):
+    """Lightweight response for user-facing template list (no html_content)."""
+    id: uuid.UUID
+    name: str
+    locale: str
+    description: str | None
+    is_default: bool
+
+    model_config = {"from_attributes": True}
+
+
+class PdfTemplateSummaryListResponse(BaseModel):
+    templates: list[PdfTemplateSummaryResponse]
+
+
+class PreviewRequest(BaseModel):
+    html_content: str = Field(min_length=1)
+
+
+class PreviewResponse(BaseModel):
+    html: str
--- a/backend/app/services/ai_service.py
+++ b/backend/app/services/ai_service.py
@@ -99,6 +99,7 @@ AI_TOOLS = [
            "type": "object",
            "properties": {
                "title": {"type": "string", "description": "Title for the PDF report"},
+                "template_id": {"type": "string", "description": "Optional UUID of a specific PDF template to use"},
            },
            "required": ["title"],
        },
@@ -174,7 +175,8 @@ async def _execute_tool(

    elif tool_name == "generate_pdf":
        from app.services.pdf_service import generate_pdf_report
-        pdf = await generate_pdf_report(db, user_id, title=tool_input["title"])
+        tmpl_id = uuid.UUID(tool_input["template_id"]) if tool_input.get("template_id") else None
+        pdf = await generate_pdf_report(db, user_id, title=tool_input["title"], template_id=tmpl_id)
        await db.commit()
        return json.dumps({
            "status": "generated",
--- a/backend/app/services/pdf_service.py
+++ b/backend/app/services/pdf_service.py
@@ -13,10 +13,11 @@ from app.models.user import User
 from app.services.memory_service import get_user_memories

 TEMPLATE_DIR = Path(__file__).parent.parent / "templates" / "pdf"
-jinja_env = Environment(
+_file_jinja_env = Environment(
    loader=FileSystemLoader(str(TEMPLATE_DIR)),
    autoescape=select_autoescape(["html"]),
 )
+_string_jinja_env = Environment(autoescape=select_autoescape(["html"]))


 async def generate_pdf_report(
@@ -25,6 +26,7 @@ async def generate_pdf_report(
    title: str,
    document_ids: list[uuid.UUID] | None = None,
    chat_id: uuid.UUID | None = None,
+    template_id: uuid.UUID | None = None,
 ) -> GeneratedPdf:
    # Load user
    result = await db.execute(select(User).where(User.id == user_id))
@@ -52,9 +54,7 @@ async def generate_pdf_report(
                    "excerpt": (doc.extracted_text or "")[:2000],
                })

-    # Render HTML
-    template = jinja_env.get_template("report.html")
-    html = template.render(
+    template_vars = dict(
        title=title,
        user_name=user.full_name or user.username,
        generated_at=datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC"),
@@ -63,6 +63,23 @@ async def generate_pdf_report(
        ai_summary=None,
    )

+    # Resolve template
+    resolved_template_id = template_id
+    if template_id:
+        from app.services.pdf_template_service import get_template
+        tmpl = await get_template(db, template_id)
+        jinja_template = _string_jinja_env.from_string(tmpl.html_content)
+    else:
+        from app.services.pdf_template_service import get_default_template
+        default_tmpl = await get_default_template(db)
+        if default_tmpl:
+            resolved_template_id = default_tmpl.id
+            jinja_template = _string_jinja_env.from_string(default_tmpl.html_content)
+        else:
+            jinja_template = _file_jinja_env.get_template("report.html")
+
+    html = jinja_template.render(**template_vars)
+
    # Generate PDF
    pdf_id = uuid.uuid4()
    pdf_dir = Path(settings.UPLOAD_DIR).parent / "pdfs" / str(user_id)
@@ -73,7 +90,6 @@ async def generate_pdf_report(
        from weasyprint import HTML
        HTML(string=html).write_pdf(str(pdf_path))
    except ImportError:
-        # WeasyPrint not installed — write HTML as fallback
        pdf_path = pdf_path.with_suffix(".html")
        pdf_path.write_text(html, encoding="utf-8")

@@ -85,6 +101,7 @@ async def generate_pdf_report(
        storage_path=str(pdf_path),
        source_document_ids=document_ids,
        source_chat_id=chat_id,
+        template_id=resolved_template_id,
    )
    db.add(generated)
    await db.flush()
--- a/backend/app/services/pdf_template_service.py
+++ b/backend/app/services/pdf_template_service.py
@@ -0,0 +1,114 @@
+import uuid
+
+from fastapi import HTTPException, status
+from jinja2 import Environment, TemplateSyntaxError, select_autoescape
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.models.pdf_template import PdfTemplate
+
+_jinja_env = Environment(autoescape=select_autoescape(["html"]))
+
+
+def validate_jinja2(html: str) -> tuple[bool, str]:
+    """Validate Jinja2 template syntax. Returns (is_valid, error_message)."""
+    try:
+        _jinja_env.parse(html)
+        return True, ""
+    except TemplateSyntaxError as e:
+        return False, f"Template syntax error at line {e.lineno}: {e.message}"
+
+
+async def list_templates(db: AsyncSession, active_only: bool = True, locale: str | None = None) -> list[PdfTemplate]:
+    stmt = select(PdfTemplate)
+    if active_only:
+        stmt = stmt.where(PdfTemplate.is_active == True)  # noqa: E712
+    if locale:
+        stmt = stmt.where(PdfTemplate.locale == locale)
+    stmt = stmt.order_by(PdfTemplate.is_default.desc(), PdfTemplate.name, PdfTemplate.locale)
+    result = await db.execute(stmt)
+    return list(result.scalars().all())
+
+
+async def get_template(db: AsyncSession, template_id: uuid.UUID) -> PdfTemplate:
+    result = await db.execute(select(PdfTemplate).where(PdfTemplate.id == template_id))
+    template = result.scalar_one_or_none()
+    if not template:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Template not found")
+    return template
+
+
+async def get_default_template(db: AsyncSession, locale: str = "en") -> PdfTemplate | None:
+    result = await db.execute(
+        select(PdfTemplate).where(
+            PdfTemplate.is_default == True,  # noqa: E712
+            PdfTemplate.locale == locale,
+        )
+    )
+    tmpl = result.scalar_one_or_none()
+    if not tmpl:
+        # Fallback to any default
+        result = await db.execute(
+            select(PdfTemplate).where(PdfTemplate.is_default == True)  # noqa: E712
+        )
+        tmpl = result.scalars().first()
+    return tmpl
+
+
+async def create_template(db: AsyncSession, **kwargs) -> PdfTemplate:
+    html = kwargs.get("html_content", "")
+    valid, error = validate_jinja2(html)
+    if not valid:
+        raise HTTPException(status_code=status.HTTP_422_UNPROCESSABLE_ENTITY, detail=error)
+
+    template = PdfTemplate(**kwargs)
+    db.add(template)
+    await db.flush()
+    return template
+
+
+async def update_template(db: AsyncSession, template_id: uuid.UUID, **kwargs) -> PdfTemplate:
+    template = await get_template(db, template_id)
+
+    if "html_content" in kwargs and kwargs["html_content"] is not None:
+        valid, error = validate_jinja2(kwargs["html_content"])
+        if not valid:
+            raise HTTPException(status_code=status.HTTP_422_UNPROCESSABLE_ENTITY, detail=error)
+
+    for key, value in kwargs.items():
+        if value is not None:
+            setattr(template, key, value)
+    await db.flush()
+    return template
+
+
+async def delete_template(db: AsyncSession, template_id: uuid.UUID) -> None:
+    template = await get_template(db, template_id)
+    if template.is_default:
+        raise HTTPException(
+            status_code=status.HTTP_403_FORBIDDEN,
+            detail="Cannot delete the default template",
+        )
+    await db.delete(template)
+
+
+async def render_preview(html_content: str) -> str:
+    """Render template with sample data for preview."""
+    valid, error = validate_jinja2(html_content)
+    if not valid:
+        raise HTTPException(status_code=status.HTTP_422_UNPROCESSABLE_ENTITY, detail=error)
+
+    template = _jinja_env.from_string(html_content)
+    return template.render(
+        title="Sample Report",
+        user_name="John Doe",
+        generated_at="2026-03-19 12:00 UTC",
+        memories=[
+            {"category": "health", "title": "Annual Checkup", "content": "Last checkup was in January 2026. All results normal.", "importance": "medium"},
+            {"category": "finance", "title": "Tax Deadline", "content": "Filing deadline: April 15, 2026", "importance": "high"},
+        ],
+        documents=[
+            {"original_filename": "report_2026.pdf", "doc_type": "report", "excerpt": "This is a sample document excerpt showing how document content appears in the report..."},
+        ],
+        ai_summary="This is a sample AI-generated summary of the user's data.",
+    )
--- a/backend/app/templates/pdf/seeds/basic_en.html
+++ b/backend/app/templates/pdf/seeds/basic_en.html
@@ -0,0 +1,70 @@
+<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>
+  body { font-family: 'Helvetica', 'Arial', sans-serif; font-size: 12pt; color: #333; margin: 40px; }
+  h1 { color: #1a7a8a; border-bottom: 2px solid #1a7a8a; padding-bottom: 8px; }
+  h2 { color: #2a5a6a; margin-top: 24px; }
+  .header { margin-bottom: 24px; }
+  .header p { margin: 2px 0; color: #666; }
+  .section { margin-bottom: 20px; }
+  .memory-entry { background: #f5f9fa; padding: 10px 14px; border-radius: 6px; margin-bottom: 8px; }
+  .memory-entry .category { font-size: 10pt; color: #888; text-transform: uppercase; }
+  .memory-entry .title { font-weight: bold; }
+  .memory-entry .importance { display: inline-block; padding: 2px 8px; border-radius: 10px; font-size: 9pt; }
+  .importance-critical { background: #fee; color: #c33; }
+  .importance-high { background: #fff3e0; color: #e65100; }
+  .importance-medium { background: #e3f2fd; color: #1565c0; }
+  .importance-low { background: #f5f5f5; color: #666; }
+  .document { border: 1px solid #ddd; padding: 12px; border-radius: 6px; margin-bottom: 10px; }
+  .document .filename { font-weight: bold; color: #1a7a8a; }
+  .document .excerpt { font-size: 10pt; color: #555; white-space: pre-wrap; max-height: 200px; overflow: hidden; }
+  .footer { margin-top: 40px; padding-top: 12px; border-top: 1px solid #ddd; font-size: 9pt; color: #999; }
+</style>
+</head>
+<body>
+  <div class="header">
+    <h1>{{ title }}</h1>
+    <p>Prepared for: {{ user_name }}</p>
+    <p>Generated: {{ generated_at }}</p>
+  </div>
+
+  {% if memories %}
+  <div class="section">
+    <h2>Key Information</h2>
+    {% for m in memories %}
+    <div class="memory-entry">
+      <span class="category">{{ m.category }}</span>
+      <span class="importance importance-{{ m.importance }}">{{ m.importance }}</span>
+      <div class="title">{{ m.title }}</div>
+      <div>{{ m.content }}</div>
+    </div>
+    {% endfor %}
+  </div>
+  {% endif %}
+
+  {% if documents %}
+  <div class="section">
+    <h2>Document Summaries</h2>
+    {% for d in documents %}
+    <div class="document">
+      <div class="filename">{{ d.original_filename }} ({{ d.doc_type }})</div>
+      <div class="excerpt">{{ d.excerpt }}</div>
+    </div>
+    {% endfor %}
+  </div>
+  {% endif %}
+
+  {% if ai_summary %}
+  <div class="section">
+    <h2>AI Summary</h2>
+    <p>{{ ai_summary }}</p>
+  </div>
+  {% endif %}
+
+  <div class="footer">
+    Generated by AI Assistant &bull; This document is for informational purposes only.
+  </div>
+</body>
+</html>
--- a/backend/app/templates/pdf/seeds/basic_ru.html
+++ b/backend/app/templates/pdf/seeds/basic_ru.html
@@ -0,0 +1,70 @@
+<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>
+  body { font-family: 'Helvetica', 'Arial', sans-serif; font-size: 12pt; color: #333; margin: 40px; }
+  h1 { color: #1a7a8a; border-bottom: 2px solid #1a7a8a; padding-bottom: 8px; }
+  h2 { color: #2a5a6a; margin-top: 24px; }
+  .header { margin-bottom: 24px; }
+  .header p { margin: 2px 0; color: #666; }
+  .section { margin-bottom: 20px; }
+  .entry { background: #f5f9fa; padding: 10px 14px; border-radius: 6px; margin-bottom: 8px; }
+  .entry .cat { font-size: 10pt; color: #888; text-transform: uppercase; }
+  .entry .title { font-weight: bold; }
+  .entry .badge { display: inline-block; padding: 2px 8px; border-radius: 10px; font-size: 9pt; }
+  .badge-critical { background: #fee; color: #c33; }
+  .badge-high { background: #fff3e0; color: #e65100; }
+  .badge-medium { background: #e3f2fd; color: #1565c0; }
+  .badge-low { background: #f5f5f5; color: #666; }
+  .doc { border: 1px solid #ddd; padding: 12px; border-radius: 6px; margin-bottom: 10px; }
+  .doc .fname { font-weight: bold; color: #1a7a8a; }
+  .doc .excerpt { font-size: 10pt; color: #555; white-space: pre-wrap; max-height: 200px; overflow: hidden; }
+  .footer { margin-top: 40px; padding-top: 12px; border-top: 1px solid #ddd; font-size: 9pt; color: #999; }
+</style>
+</head>
+<body>
+  <div class="header">
+    <h1>{{ title }}</h1>
+    <p>Подготовлено для: {{ user_name }}</p>
+    <p>Дата: {{ generated_at }}</p>
+  </div>
+
+  {% if memories %}
+  <div class="section">
+    <h2>Ключевая информация</h2>
+    {% for m in memories %}
+    <div class="entry">
+      <span class="cat">{{ m.category }}</span>
+      <span class="badge badge-{{ m.importance }}">{{ m.importance }}</span>
+      <div class="title">{{ m.title }}</div>
+      <div>{{ m.content }}</div>
+    </div>
+    {% endfor %}
+  </div>
+  {% endif %}
+
+  {% if documents %}
+  <div class="section">
+    <h2>Сводка по документам</h2>
+    {% for d in documents %}
+    <div class="doc">
+      <div class="fname">{{ d.original_filename }} ({{ d.doc_type }})</div>
+      <div class="excerpt">{{ d.excerpt }}</div>
+    </div>
+    {% endfor %}
+  </div>
+  {% endif %}
+
+  {% if ai_summary %}
+  <div class="section">
+    <h2>Резюме ИИ</h2>
+    <p>{{ ai_summary }}</p>
+  </div>
+  {% endif %}
+
+  <div class="footer">
+    Сгенерировано ИИ-ассистентом
+  </div>
+</body>
+</html>
--- a/backend/app/templates/pdf/seeds/medical_en.html
+++ b/backend/app/templates/pdf/seeds/medical_en.html
@@ -0,0 +1,75 @@
+<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>
+  body { font-family: 'Georgia', serif; font-size: 11pt; color: #222; margin: 30px; }
+  h1 { color: #c0392b; border-bottom: 3px double #c0392b; padding-bottom: 10px; }
+  h2 { color: #8e2323; margin-top: 20px; border-left: 4px solid #c0392b; padding-left: 10px; }
+  .header { margin-bottom: 20px; }
+  .header p { margin: 2px 0; color: #555; }
+  .warning { background: #fff3cd; border: 1px solid #ffc107; padding: 10px; border-radius: 4px; margin-bottom: 16px; font-size: 10pt; }
+  .section { margin-bottom: 16px; }
+  .entry { border-bottom: 1px solid #eee; padding: 8px 0; }
+  .entry .cat { font-size: 9pt; color: #999; text-transform: uppercase; letter-spacing: 1px; }
+  .entry .title { font-weight: bold; font-size: 12pt; }
+  .entry .badge { display: inline-block; padding: 1px 6px; border-radius: 3px; font-size: 8pt; font-weight: bold; }
+  .badge-critical { background: #e74c3c; color: white; }
+  .badge-high { background: #e67e22; color: white; }
+  .badge-medium { background: #3498db; color: white; }
+  .badge-low { background: #95a5a6; color: white; }
+  .doc { background: #f8f9fa; padding: 10px; margin-bottom: 8px; border-left: 3px solid #3498db; }
+  .doc .fname { font-weight: bold; }
+  .doc .excerpt { font-size: 10pt; color: #444; white-space: pre-wrap; }
+  .footer { margin-top: 30px; padding-top: 10px; border-top: 2px solid #eee; font-size: 8pt; color: #999; }
+</style>
+</head>
+<body>
+  <div class="header">
+    <h1>Medical Report: {{ title }}</h1>
+    <p>Patient: {{ user_name }}</p>
+    <p>Date: {{ generated_at }}</p>
+  </div>
+
+  <div class="warning">
+    This report is generated by AI and is for informational purposes only. Always consult a healthcare professional for medical decisions.
+  </div>
+
+  {% if memories %}
+  <div class="section">
+    <h2>Health Profile</h2>
+    {% for m in memories %}
+    <div class="entry">
+      <span class="cat">{{ m.category }}</span>
+      <span class="badge badge-{{ m.importance }}">{{ m.importance }}</span>
+      <div class="title">{{ m.title }}</div>
+      <div>{{ m.content }}</div>
+    </div>
+    {% endfor %}
+  </div>
+  {% endif %}
+
+  {% if documents %}
+  <div class="section">
+    <h2>Medical Documents</h2>
+    {% for d in documents %}
+    <div class="doc">
+      <div class="fname">{{ d.original_filename }} ({{ d.doc_type }})</div>
+      <div class="excerpt">{{ d.excerpt }}</div>
+    </div>
+    {% endfor %}
+  </div>
+  {% endif %}
+
+  {% if ai_summary %}
+  <div class="section">
+    <h2>AI Clinical Summary</h2>
+    <p>{{ ai_summary }}</p>
+  </div>
+  {% endif %}
+
+  <div class="footer">
+    Generated by AI Assistant &bull; For informational purposes only &bull; Not a substitute for professional medical advice
+  </div>
+</body>
+</html>
--- a/backend/app/templates/pdf/seeds/medical_ru.html
+++ b/backend/app/templates/pdf/seeds/medical_ru.html
@@ -0,0 +1,75 @@
+<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>
+  body { font-family: 'Georgia', serif; font-size: 11pt; color: #222; margin: 30px; }
+  h1 { color: #c0392b; border-bottom: 3px double #c0392b; padding-bottom: 10px; }
+  h2 { color: #8e2323; margin-top: 20px; border-left: 4px solid #c0392b; padding-left: 10px; }
+  .header { margin-bottom: 20px; }
+  .header p { margin: 2px 0; color: #555; }
+  .warning { background: #fff3cd; border: 1px solid #ffc107; padding: 10px; border-radius: 4px; margin-bottom: 16px; font-size: 10pt; }
+  .section { margin-bottom: 16px; }
+  .entry { border-bottom: 1px solid #eee; padding: 8px 0; }
+  .entry .cat { font-size: 9pt; color: #999; text-transform: uppercase; letter-spacing: 1px; }
+  .entry .title { font-weight: bold; font-size: 12pt; }
+  .entry .badge { display: inline-block; padding: 1px 6px; border-radius: 3px; font-size: 8pt; font-weight: bold; }
+  .badge-critical { background: #e74c3c; color: white; }
+  .badge-high { background: #e67e22; color: white; }
+  .badge-medium { background: #3498db; color: white; }
+  .badge-low { background: #95a5a6; color: white; }
+  .doc { background: #f8f9fa; padding: 10px; margin-bottom: 8px; border-left: 3px solid #3498db; }
+  .doc .fname { font-weight: bold; }
+  .doc .excerpt { font-size: 10pt; color: #444; white-space: pre-wrap; }
+  .footer { margin-top: 30px; padding-top: 10px; border-top: 2px solid #eee; font-size: 8pt; color: #999; }
+</style>
+</head>
+<body>
+  <div class="header">
+    <h1>Медицинский отчёт: {{ title }}</h1>
+    <p>Пациент: {{ user_name }}</p>
+    <p>Дата: {{ generated_at }}</p>
+  </div>
+
+  <div class="warning">
+    Этот отчёт сгенерирован ИИ и предназначен только для информационных целей. Всегда консультируйтесь с врачом для принятия медицинских решений.
+  </div>
+
+  {% if memories %}
+  <div class="section">
+    <h2>Профиль здоровья</h2>
+    {% for m in memories %}
+    <div class="entry">
+      <span class="cat">{{ m.category }}</span>
+      <span class="badge badge-{{ m.importance }}">{{ m.importance }}</span>
+      <div class="title">{{ m.title }}</div>
+      <div>{{ m.content }}</div>
+    </div>
+    {% endfor %}
+  </div>
+  {% endif %}
+
+  {% if documents %}
+  <div class="section">
+    <h2>Медицинские документы</h2>
+    {% for d in documents %}
+    <div class="doc">
+      <div class="fname">{{ d.original_filename }} ({{ d.doc_type }})</div>
+      <div class="excerpt">{{ d.excerpt }}</div>
+    </div>
+    {% endfor %}
+  </div>
+  {% endif %}
+
+  {% if ai_summary %}
+  <div class="section">
+    <h2>Клиническое резюме ИИ</h2>
+    <p>{{ ai_summary }}</p>
+  </div>
+  {% endif %}
+
+  <div class="footer">
+    Сгенерировано ИИ-ассистентом &bull; Только для информационных целей &bull; Не заменяет консультацию врача
+  </div>
+</body>
+</html>