gendesign/Caddyfile

# Caddy config.
#
# - gendsgn.ru — main production site, auto-TLS via Let's Encrypt.
# - www.gendsgn.ru — 301 redirect to apex (canonical URL).
# - :80 — fallback for raw IP access. Closed by same auth gate (pilot phase).
#
# `handle /api/*` (NOT `handle_path`) — we keep the /api prefix because
# the FastAPI router is mounted at /api/v1/*.
#
# Auth gate: basic_auth for pilot phase (2026-05-23).
# Users managed via caddy/users.caddy.snippet (git history = audit trail).
# Public exclusions: /health (liveness probe), /preview/* (static mockups).
#
# #2558: с 2026-07 basic_auth гейтит ТОЛЬКО Site Finder (`/`, `/api/*`,
# `/analytics` и т.д.). `/trade-in/*` (+ `/sale-share` redirect) вынесены ВЫШЕ
# import'а — у trade-in своя авторизация (форма входа + opaque session-cookie,
# см. #2552) поверх RBAC (`tradein-mvp/backend/app/core/rbac.py`). Site Finder
# всё ещё легаси-пилотный basic_auth (roles.yaml dual-mode остаётся живым для
# него — НЕ трогать caddy/users.caddy.snippet).
#
# IMPORTANT: route { } block is required to preserve directive order.
# Without route { }, Caddy executes directives in hard-coded default order
# (basic_auth runs before handle), making /health and /preview/* exclusions
# ineffective. With route { }, handlers are matched top-to-bottom as written.

# #2213: global `log_credentials` УБРАН. Он заставлял Caddy писать raw
# Authorization header (Base64 `user:password`, тривиально обратимый) в ОБА лог-файла
# (gendsgn.ru.log + auth_audit.log). Даже при root-only доступе и коротком retention
# это plaintext-пароли пилотов на диске — недопустимый риск против скромной выгоды.
# Trade-off: glitchtip-auth-forwarder больше не извлекает `attempted_username` из 401
# (тег деградирует в "(none)" — forwarder это уже обрабатывает gracefully, не падает).
# Событие basic_auth 401 (remote_ip / uri / method) по-прежнему уходит в GlitchTip.

gendsgn.ru {
    encode zstd gzip

    log {
        output file /var/log/caddy/gendsgn.ru.log {
            roll_size 50MiB
            roll_keep 5
            roll_keep_for 720h
        }
        format json
    }

    # Отдельный лог только для auth-событий.
    # Forwarder (ops/glitchtip-auth-forwarder) читает именно этот файл.
    # Retention 7 дней (меньше чем main log) — содержит plain Base64 credentials.
    log auth_audit {
        output file /var/log/caddy/auth_audit.log {
            roll_size 10MiB
            roll_keep 3
            roll_keep_for 168h
        }
        format json
    }

    route {
        # /health и /preview/* — public, без auth, short-circuit.
        handle /health {
            reverse_proxy backend:8000
        }

        # Static HTML mockups для review (audit alternatives).
        # Public access — без auth (по запросу 2026-05-17).
        handle_path /preview/* {
            root * /srv/preview
            file_server browse
        }

        # Trade-In UI preview — public CI surface (#801). Рендерит mock-фикстуру
        # «денежного экрана» без бэкенда → axe/lighthouse гоняются без креды.
        # Реальных клиентских данных нет (статичная фикстура) → безопасно публично.
        # ДО auth-import: route матчит сверху вниз, handle short-circuit'ит.
        # Без strip — Next.js basePath=/trade-in ждёт префикс в URL (как @tradein).
        # ui-preview + его статика (_next/static — CSS/JS бандлы, без секретов).
        # Оба ДО auth-import, иначе ассеты страницы уходят в @tradein (под auth) → 401 → без CSS.
        @uipreview path /trade-in/ui-preview/* /trade-in/_next/static/*
        handle @uipreview {
            reverse_proxy tradein-frontend:3000
        }

        # #2558: Trade-In MVP subproject (tradein-mvp/) — gendesign-tradein docker
        # stack, подключен через gendesign_shared network. Секция ЦЕЛИКОМ ДО
        # `import caddy/users.caddy.snippet` ниже — /trade-in имеет собственную
        # авторизацию (форма входа + opaque session-cookie, #2552; RBAC-проверка
        # роли внутри tradein-backend, `app/core/rbac.py`), Site Finder basic_auth
        # ей больше не нужен и не должен применяться (short-circuit сверху вниз,
        # как /health и /preview/* выше).
        #
        # X-Authenticated-User — ЯВНОЕ УДАЛЕНИЕ (`header_up -X-Authenticated-User`),
        # НЕ `header_up X-Authenticated-User {http.auth.user.id}`. Причина: этот
        # блок больше не идёт ПОСЛЕ basic_auth, поэтому `{http.auth.user.id}`
        # никогда не резолвится Caddy'ем (плейсхолдер пуст) — а поведение
        # `header_up <field> <value>` при пустом value НЕ задокументировано как
        # надёжное удаление заголовка (это Set-операция; нет гарантии, что Caddy
        # трактует пустую строку как "не отправлять поле" во всех версиях).
        # Полагаться на это было бы небезопасно: если бы Caddy просто НЕ
        # устанавливал заголовок (leave as-is) при пустом value, то ЛЮБОЙ
        # клиентский `X-Authenticated-User: someone` прошёл бы НАСКВОЗЬ до
        # tradein-backend — а backend в auth_mode="dual" (`app/core/config.py`)
        # всё ещё принимает legacy trusted-header путь (`rbac.py:186`) → внешняя
        # подмена личности без единого валидного пароля. `-Field` — единственная
        # ФОРМА С ЯВНО ЗАДОКУМЕНТИРОВАННОЙ семантикой "удалить заголовок"
        # (Caddyfile reverse_proxy directive: `-<field>` = delete), поэтому
        # используем её вместо Set с пустым значением — гарантия, а не догадка.
        # X-Internal-Auth-Secret НЕ трогаем — #2213-секрет всегда перезаписывается
        # из env (Set-операция с непустым значением, никак не связана с auth-гейтом
        # basic_auth), это единственное, что теперь отсекает подделку заголовков
        # изнутри gendesign_shared network для legacy dual-mode пути.
        handle /trade-in/api/* {
            # `handle_path /trade-in/api/*` стрипал бы целиком /trade-in/api;
            # FastAPI router замаунтен на /api/v1/trade-in/* — нужен strip только
            # префикса basePath /trade-in (Next.js basePath leak).
            uri strip_prefix /trade-in
            reverse_proxy tradein-backend:8000 {
                header_up -X-Authenticated-User
                header_up X-Internal-Auth-Secret {env.TRADEIN_INTERNAL_AUTH_SECRET}
            }
        }

        # gendsgn.ru/sale-share — короткий адрес standalone-продукта «Поиск домов».
        # Next basePath=/trade-in → редиректим на канонический /trade-in/sale-share
        # (тот же tradein-frontend контейнер; query-string сохраняется). True vanity-URL
        # в адресной строке требует отдельного Next-app с basePath=/sale-share.
        # #2558: перенесён ВЫШЕ auth-import вместе с trade-in — редирект ведёт на
        # /trade-in/sale-share, который теперь публичен без basic_auth; оставлять
        # короткий /sale-share под basic_auth, а канонический адрес назначения без
        # него — несогласованно (короткий URL был бы строже целевой страницы).
        @saleshare path /sale-share /sale-share/
        handle @saleshare {
            redir /trade-in/sale-share permanent
        }

        # Matcher `path /trade-in /trade-in/*` ловит И /trade-in (без слеша),
        # И /trade-in/ + /trade-in/anything. Без обоих случаев `handle /trade-in/*`
        # пропускал /trade-in без слеша → попадал в общий frontend → пустой ответ.
        @tradein path /trade-in /trade-in/*
        handle @tradein {
            # Next.js basePath=/trade-in — фронт сам ждёт префикса в URL
            reverse_proxy tradein-frontend:3000 {
                # См. комментарий над /trade-in/api/* выше — та же логика (явное
                # удаление вместо Set с пустым {http.auth.user.id}).
                header_up -X-Authenticated-User
                header_up X-Internal-Auth-Secret {env.TRADEIN_INTERNAL_AUTH_SECRET}
            }
        }

        # Auth gate — с #2558 применяется ТОЛЬКО к Site Finder (handle /api/* и
        # handle {} ниже). Trade-In уже отработал и short-circuit'нул выше.
        import caddy/users.caddy.snippet

        handle /api/* {
            reverse_proxy backend:8000 {
                header_up X-Authenticated-User {http.auth.user.id}
            }
        }

        handle {
            reverse_proxy frontend:3000 {
                header_up X-Authenticated-User {http.auth.user.id}
            }
        }
    }
}

www.gendsgn.ru {
    redir https://gendsgn.ru{uri} permanent
}

# Obsidian Self-hosted LiveSync (CouchDB backend).
# Auto-TLS Let's Encrypt. CORS уже включён на стороне CouchDB через bootstrap
# (см. scripts/setup-couchdb.sh). Basic-auth — на стороне CouchDB (admin user).
#
# DNS: A-record obsidian.gendsgn.ru → IP VPS.
# Клиенты Obsidian + Self-hosted LiveSync plugin указывают на этот URL.
obsidian.gendsgn.ru {
    encode zstd gzip

    reverse_proxy couchdb:5984 {
        # Большие документы (vault attachments / images) — увеличиваем timeout
        transport http {
            response_header_timeout 120s
        }
    }
}

# GlitchTip — self-hosted error tracking (Sentry-compatible).
# DNS: A-record errors.gendsgn.ru → IP VPS.
errors.gendsgn.ru {
    encode zstd gzip

    reverse_proxy glitchtip-web:8080

    log {
        output file /var/log/caddy/errors.gendsgn.ru.log
    }
}

# Uptime Kuma — self-hosted uptime monitoring + public status page (#75 B6-1).
# DNS: A-record status.gendsgn.ru → IP VPS (добавить перед деплоем стека).
# Контейнер из docker-compose.uptime.yml (project gendesign-uptime) на shared
# gendesign_shared network. Если стек не запущен — Caddy отдаёт 502 ТОЛЬКО на
# этом домене, main-сайт не страдает (как obsidian.gendsgn.ru).
#
# ВНИМАНИЕ: status-page НАМЕРЕННО публичен (trust-building для пилотов, issue #75).
# Admin-панель Kuma (/dashboard, /manage-*) защищена собственным логином Kuma —
# НЕ кладём её за caddy/users.caddy.snippet, иначе double-auth сломает setup.
status.gendsgn.ru {
    encode zstd gzip

    reverse_proxy uptime-kuma:3001

    log {
        output file /var/log/caddy/status.gendsgn.ru.log
    }
}

# Forgejo — self-hosted git (migration 2026-05-16).
# DNS: A-record git.gendsgn.ru → IP VPS.
# Forgejo container из forgejo-migration/docker-compose.yml на shared
# gendesign_default network. HTTP port 3000 (default Forgejo).
# Был добавлен вручную при migration, потерян при первом auto-deploy после
# изменения Caddyfile (deploy.yml делает git reset --hard). См. fix issue.
git.gendsgn.ru {
    encode zstd gzip

    reverse_proxy forgejo:3000

    log {
        output file /var/log/caddy/git.gendsgn.ru.log
    }
}

# Plain HTTP by IP — closed by same auth gate (prevent bypass via direct IP / SSH tunnel).
# Caddy issues no TLS here (no hostname). /health remains public.
:80 {
    encode zstd gzip

    route {
        # /health — public, без auth (GHA deploy smoke check, liveness probe).
        handle /health {
            reverse_proxy backend:8000
        }

        # Auth gate (same snippet as gendsgn.ru).
        import caddy/users.caddy.snippet

        handle /api/* {
            reverse_proxy backend:8000 {
                header_up X-Authenticated-User {http.auth.user.id}
            }
        }

        handle {
            reverse_proxy frontend:3000 {
                header_up X-Authenticated-User {http.auth.user.id}
            }
        }
    }
}
# Test deploy flow 2026-05-15T21:43:32Z