Initial MANGABOM website

This commit is contained in:
2026-11-02 04:08:02 +03:00
commit b86e8a9eff
150 changed files with 5728 additions and 0 deletions

74
DEPLOY.md Normal file
View File

@@ -0,0 +1,74 @@
# Перенос MANGABOM на свой сервер
Для текущего OMV (192.168.0.181), автоматического обновления библиотеки и публичного адреса без домена используй [SERVER.md](SERVER.md) и compose.server.yaml. Ниже сохранены способы обычной статической публикации.
Это самостоятельный статический сайт. Для размещения не нужны Node.js, npm, Python, база данных или ChatGPT. Все картинки, шрифты, стили и JavaScript включены в архив. Доступ через ChatGPT на своём сервере не требуется.
## Самый простой вариант: существующий веб-сервер
1. Распакуй архив.
2. Скопируй **содержимое `dist/`** в корень сайта своего домена. Именно содержимое, а не всю папку проекта: `index.html` должен оказаться в document root.
3. Настрой обычную раздачу статических файлов через Nginx, Apache, Caddy либо панель хостинга.
4. Открой домен и проверь `serials.html`, `login.html` и `schedule.html` напрямую.
Страницы используют относительные ссылки. Можно размещать сайт как в корне домена, так и в отдельном каталоге. Для файлов с расширением `.html` не нужно SPA-перенаправление на главную. Отсутствующий файл должен возвращать 404.
## Docker + Nginx / Nginx Proxy Manager
В папке с `compose.yaml` выполни:
```bash
docker compose up -d --build
```
Контейнер раздаёт сайт на `127.0.0.1:8080`. Эта привязка намеренно доступна только с самого сервера. Настрой существующий reverse proxy на этот адрес и включи HTTPS для домена.
Если Nginx Proxy Manager работает в другом контейнере, `127.0.0.1` внутри него относится к нему самому. Подключи оба контейнера к общей Docker-сети и направь Proxy Host на `mangabom:80`, либо используй доступный из NPM адрес хоста. Не меняй привязку на публичную без необходимости.
Конфигурация Nginx находится в `deploy/nginx.conf`. Для обычной установки без Docker замени `root /usr/share/nginx/html` на путь к своей папке `dist` и укажи свой домен в `server_name`.
## Локальный просмотр
Из корня проекта, если установлен Python:
```bash
python3 -m http.server 8080 --directory dist
```
Открой `http://localhost:8080`. Не проверяй работу localStorage через `file://`: нужен HTTP/HTTPS.
## Что хранится у читателя
Избранное, демо-профиль, голос, настройки и черновик обращения лежат в localStorage с префиксом `mangabom.`. При смене домена старые данные браузера автоматически не переносятся. На другом устройстве будет отдельное состояние.
## Что не является подключённым сервисом
- Вход — локальный демо-режим, не настоящая авторизация.
- Поддержка не принимает платежи; подписка не оформляется.
- Обратная связь сохраняет черновик, но не отправляет его.
- Голосование не передаёт голоса на сервер и не считает общий рейтинг.
- Читалка работает на статических изображениях. Перед публикацией обнови `dist/manga/library.json` командой `update-library.cmd`. Аккаунты и синхронизация прогресса между устройствами пока не подключены.
- Юридические страницы — проекты для согласования, а не готовые документы сервиса.
Для серверной авторизации, синхронизации, платежей, отправки обращений и общего голосования потребуется отдельный backend. Для читалки backend не нужен.
## Изменение исходников
Готовые файлы можно редактировать непосредственно в `dist/`. Для генерации страниц из шаблона используй:
```bash
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements-dev.txt
python scripts/build-product.py
```
Шаблон главной — `scripts/product-home-template.html`; данные сериалов и содержимое внутренних страниц — `scripts/build-product.py`. Стили — `dist/styles.css`, поведение — `dist/app.js`.
**Важно:** генерация перезаписывает HTML-страницы. Изменения текстов и разметки вноси в шаблон и генератор, если планируешь повторно их запускать. CSS и JavaScript генератор не перезаписывает. `scripts/build-pages.py` и `scripts/home-template.html` сохранены как прежняя версия заглушек; для текущей версии не запускай этот генератор.
## После переноса
Проверь все пункты `REVIEW.md`. Ссылки в переданном чек-листе сделаны относительными и ведут к локальным файлам `dist/`.
Не размещай в публичном document root папки `scripts/`, исходные шаблоны и файлы конфигурации. Публикуется только `dist/`.