Update with last fixes
This commit is contained in:
@@ -26,7 +26,7 @@ site-engine/
|
||||
├── docs/ # ТЗ, ревью, журнал решений
|
||||
├── examples/studio-site/ # сайт-пример из SiteMap.md (услуги, формы, коллекция, редирект)
|
||||
├── .env.example # переменные окружения для админки
|
||||
├── tests/ # 178 тестов: ядро, сборка, безопасность, запись, вход и редактор
|
||||
├── tests/ # 206 тестов: ядро, сборка, безопасность, запись, вход и редактор
|
||||
└── src/site_engine/
|
||||
├── cli.py # validate · build · preview · fragments
|
||||
├── errors.py # Issue/Report: код, путь к полю, серьёзность, подсказка
|
||||
@@ -50,6 +50,53 @@ site-engine/
|
||||
└── mcp/ # перечень инструментов MVP (M3)
|
||||
```
|
||||
|
||||
## Запуск в Docker
|
||||
|
||||
Один том `/data`, в нём три каталога. Всё, что важно сохранить, лежит на хосте в `./data`.
|
||||
|
||||
| На хосте | В контейнере | Что это |
|
||||
|---|---|---|
|
||||
| `data/site` | `/data/site` | Ваш сайт: `site.yaml`, `pages/`, `content/`, фрагменты. Его правит редактор |
|
||||
| `data/dist` | `/data/dist` | Опубликованные релизы и симлинк `current` |
|
||||
| `data/state` | `/data/state` | Состояние входа и журнал `audit.jsonl` |
|
||||
|
||||
```bash
|
||||
docker build -t site-engine .
|
||||
docker run --rm -it site-engine site-engine hash-password # спросит пароль, напечатает хеш
|
||||
docker run --rm site-engine site-engine gen-secret # ключ подписи сессий
|
||||
cp .env.example .env # впишите хеш и ключ
|
||||
|
||||
mkdir -p data && cp -r examples/studio-site data/site # или положите свой сайт в data/site
|
||||
docker run -d --name site-engine -p 8181:8000 --env-file .env -v "$PWD/data:/data" site-engine
|
||||
```
|
||||
|
||||
Админка: `http://localhost:8181/admin/` (на обзоре сверху показаны абсолютные пути, которыми пользуется приложение), опубликованный сайт: `http://localhost:8181/`. Проверка того, что видит контейнер:
|
||||
|
||||
```bash
|
||||
docker logs site-engine # строка «site-engine: site=/data/site, dist=/data/dist, state=/data/state, admin=on»
|
||||
docker exec site-engine env | grep '^SITE_' # SITE_ROOT, SITE_DIST, SITE_STATE_DIR должны начинаться с /data/
|
||||
```
|
||||
|
||||
Если вместо `/data/...` там относительные пути (`examples/studio-site`, `dist`), эти строки остались в вашем `.env` от старой версии: удалите `SITE_ROOT`, `SITE_DIST`, `SITE_STATE_DIR` из `.env`, так как значения из `--env-file` перекрывают значения из образа. При старте приложение само пишет об этом предупреждение.
|
||||
|
||||
Правила для `.env` при `docker run --env-file`:
|
||||
|
||||
- **Без кавычек.** Docker не снимает их, они станут частью значения.
|
||||
- **Без комментариев в конце строки.** `KEY=value # текст` даёт значение «value # текст».
|
||||
- **Знак `$` в хеше экранировать не нужно.** (Для `docker compose` и его `.env` его нужно удваивать: `$$`.)
|
||||
|
||||
Приложение проверяет эти значения строго: хеш, ключ, логин, флаг Secure и host с лишними символами не принимаются молча, `/admin/` не включается, а в `docker logs` пишется причина.
|
||||
|
||||
| Симптом | Причина |
|
||||
|---|---|
|
||||
| `/admin/` даёт 404 | Не заданы `SITE_ADMIN_PASSWORD_HASH` и `SITE_SECRET_KEY`, ключ короче 32 символов или в значении кавычки или комментарий; причина в `docker logs`: «админка отключена: …» |
|
||||
| «Сайт не загружен» на обзоре | В `data/site` нет `site.yaml` или том не смонтирован; на обзоре виден абсолютный путь, который проверял движок |
|
||||
| Опубликованного сайта нет на хосте | Том не смонтирован (`-v "$PWD/data:/data"`): релизы лежат внутри контейнера и пропадут вместе с ним |
|
||||
| После ввода пароля снова страница входа | Cookie с флагом Secure не принимается по `http://` с адреса не `localhost`: поставьте `SITE_COOKIE_SECURE=0` |
|
||||
| Ответ 422 с `"loc": ["query","request"]` | Образ собран из версии до исправления: пересоберите `docker build` |
|
||||
|
||||
Контейнер работает от root, поэтому файлы в `data/` на Linux будут принадлежать root. Чтобы этого избежать, добавьте `--user "$(id -u):$(id -g)"`.
|
||||
|
||||
## Вход в админку
|
||||
|
||||
Самый простой вариант: **один администратор, без ролей**, логин и хеш пароля задаются переменными окружения, БД для входа не нужна.
|
||||
@@ -120,7 +167,7 @@ SITE_COOKIE_SECURE=0 uvicorn site_engine.web.app:create_app --factory --env-file
|
||||
|
||||
## Что проверено, а что нет
|
||||
|
||||
Тесты и сборка примера выполнялись в окружении без сети: ядро (`core/`, `build/`, `parsing/`, `storage/`, `services/`) и вся логика админки (`web/admin/handlers.py`, `editor.py`, `forms.py`, шаблоны, вход, CSRF, заголовки) запущены и покрыты 178 тестами, включая сквозные через HTML-формы. Тонкий FastAPI-адаптер `web/admin/routes.py` проверен на подставном модуле `fastapi`, а `web/app.py`, `db/`, `mcp/` и `Dockerfile` только компиляцией и чтением: FastAPI, SQLAlchemy и MCP SDK в окружении не было. Ядро намеренно не зависит от pydantic: ошибки должны нести путь к полю (`pages/index.md:regions.main[b_hero].props.title`), а валидация задаётся манифестами фрагментов. Pydantic нужен на границах API (web, mcp).
|
||||
Тесты и сборка примера выполнялись в окружении без сети: ядро (`core/`, `build/`, `parsing/`, `storage/`, `services/`) и вся логика админки (`web/admin/handlers.py`, `editor.py`, `forms.py`, шаблоны, вход, CSRF, заголовки) запущены и покрыты 206 тестами, включая сквозные через HTML-формы. Тонкий FastAPI-адаптер `web/admin/routes.py` проверен на подставном модуле `fastapi`, а `web/app.py`, `db/`, `mcp/` и `Dockerfile` только компиляцией и чтением: FastAPI, SQLAlchemy и MCP SDK в окружении не было. Ядро намеренно не зависит от pydantic: ошибки должны нести путь к полю (`pages/index.md:regions.main[b_hero].props.title`), а валидация задаётся манифестами фрагментов. Pydantic нужен на границах API (web, mcp).
|
||||
|
||||
## Соответствие журналу решений
|
||||
|
||||
|
||||
Reference in New Issue
Block a user