copilot-swe-agent[bot]
46b2f17acc
- Add MkDocs Material docs build stage to Dockerfile and Dockerfile.local - Mount pre-built docs as static files at /help/ in FastAPI (app/main.py) - Add app/views/help.py with /help → /help/ permanent redirect route - Register help router in app/views/__init__.py - Add Help nav link to base.html (public + app nav, desktop + mobile) - Create how-to guides: HP printer, ScanSnap, watched folder, email ingestion, mobile scanning - Update mkdocs.yml with How-To Guides section and Material theme palette - Add optional docs service (squidfunk/mkdocs-material) to docker-compose.yaml with docs profile - Add mkdocs-material to requirements-dev.txt - Add /docs_build to .gitignore - Add tests for help view (8 tests, 100% coverage on help.py) Co-authored-by: christianlouis <361235+christianlouis@users.noreply.github.com>
65 lines
2.0 KiB
Docker
65 lines
2.0 KiB
Docker
# Local development Dockerfile (avoids CI-only build metadata files)
|
||
FROM python:3.14.1 AS builder
|
||
|
||
WORKDIR /app
|
||
|
||
COPY requirements.txt /app/
|
||
RUN pip install --no-cache-dir -r requirements.txt
|
||
|
||
# ── Documentation build stage ───────────────────────────────────────────────
|
||
FROM python:3.14.1-slim AS docs-builder
|
||
|
||
WORKDIR /docs
|
||
|
||
COPY docs/requirements.txt /docs/requirements.txt
|
||
RUN pip install --no-cache-dir -r requirements.txt
|
||
|
||
COPY docs /docs/docs
|
||
COPY mkdocs.yml /docs/mkdocs.yml
|
||
|
||
RUN mkdocs build --config-file /docs/mkdocs.yml --site-dir /docs/docs_build
|
||
|
||
FROM python:3.14.1-slim
|
||
|
||
WORKDIR /app
|
||
|
||
COPY --from=builder /usr/local/lib/python3.14/site-packages /usr/local/lib/python3.14/site-packages
|
||
COPY --from=builder /usr/local/bin /usr/local/bin
|
||
|
||
# Install system-level OCR tools required for local OCR workflows:
|
||
# tesseract-ocr – OCR engine used by pytesseract and ocrmypdf
|
||
# ghostscript – required by ocrmypdf for PDF/PS operations
|
||
# poppler-utils – provides pdfinfo/pdftoppm used by pdf2image
|
||
# unpaper – optional deskewing pre-processor used by ocrmypdf
|
||
RUN apt-get update && apt-get install -y --no-install-recommends \
|
||
tesseract-ocr \
|
||
ghostscript \
|
||
poppler-utils \
|
||
unpaper \
|
||
&& apt-get clean && rm -rf /var/lib/apt/lists/*
|
||
|
||
COPY ./app /app/app
|
||
COPY ./frontend /app/frontend
|
||
COPY ./migrations /app/migrations
|
||
COPY ./alembic.ini /app/alembic.ini
|
||
COPY ./LICENSE /app/LICENSE
|
||
COPY ./VERSION /app/VERSION
|
||
COPY ./BUILD_DATE /app/BUILD_DATE
|
||
|
||
# Copy the pre-built MkDocs documentation site (served at /help)
|
||
COPY --from=docs-builder /docs/docs_build /app/docs_build
|
||
|
||
# Local fallbacks for build metadata
|
||
RUN echo "local" > /app/GIT_SHA \
|
||
&& echo "local" > /app/RUNTIME_INFO
|
||
|
||
RUN mkdir -p /app/runtime_info
|
||
RUN mkdir -p /workdir
|
||
|
||
ENV PYTHONPATH=/app
|
||
ENV PYTHONUNBUFFERED=1
|
||
|
||
EXPOSE 8000
|
||
|
||
CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
|