2026-etpgrf-site/_prj_blueprint/backend.md

Бэкенд: Архитектура и модули

1. Django Конфигурация (etpgrf_site/etpgrf_site/)

• settings.py:
  • DEBUG и SECRET_KEY считываются из переменных окружения.
  • ADMIN_URL: настраиваемый префикс панели администратора (по умолчанию admin/).
  • База данных: SQLite в data/db-etpgrf.sqlite3 с timeout: 20 для надежности при конкурентных запросах.
  • Статика: STATICFILES_DIRS = [BASE_DIR.parent / 'public' / 'static'], STATIC_ROOT = BASE_DIR.parent / 'public' / 'static_collected'.
  • Медиа: MEDIA_ROOT = BASE_DIR.parent / 'media', MEDIA_URL = '/media/'.
  • Защита за прокси: в not DEBUG активированы SECURE_PROXY_SSL_HEADER, SECURE_SSL_REDIRECT, SESSION_COOKIE_SECURE, CSRF_COOKIE_SECURE, USE_X_FORWARDED_HOST, USE_X_FORWARDED_PORT.
• urls.py:
  • /{ADMIN_URL} -> админка Django.
  • / -> typograph.urls (главная страница типографа, API обработки и статистики).
  • /blog/ -> blog.urls (список постов, детальная страница поста).
  • /sitemap.xml -> карта сайта (PostSitemap).
  • /<slug:slug>/ -> ловушка для статических страниц (например, /about/, /privacy-policy/, /donate/).

2. Приложение typograph

Отвечает за взаимодействие с библиотекой типографирования etpgrf и сбор агрегированной аналитики.

Модели (typograph/models.py)

• DailyStat:
  • Агрегированные посуточные показатели (date - уникальная дата).
  • Метрики активности: index_views, process_requests, copy_count.
  • Объемы данных: chars_in, chars_out, chars_copied.
  • Производительность: total_processing_time_ms, вычисляемое свойство avg_processing_time_ms.
  • settings_stats: JSONField со статистикой популярности опций (языки, кавычки, переносы, висячая пунктуация и т.д.).

Представления и Эндпоинты (typograph/views.py)

• index (/): главная страница, инкрементирует просмотры index_views.
• process_text (/process/, POST):
  • Принимает текст и параметры типографирования из формы.
  • Инициализирует LayoutProcessor, Hyphenator, Typographer из пакета etpgrf.
  • Производит замер времени обработки time.perf_counter().
  • Атомарно обновляет счетчики в DailyStat.
  • Возвращает HTML-фрагмент typograph/result_fragment.html и заголовок X-Processing-Time.
• track_copy (/track-copy/, POST): фиксирует факт и длину скопированного в буфер текста.
• get_stats_summary (/stats-summary/, GET): возвращает компактный HTMX-фрагмент со статистикой для футера.

3. Приложение blog

Отвечает за публикации, статьи и произвольные статические страницы.

Модели (blog/models.py)

• Post:
  • post_type: B (Пост блога) или P (Страница).
  • title, slug (автоматическая транслитерация через pytils.translit.slugify с обработкой коллизий).
  • is_published, published_at, updated_at.
  • content (HTML-разметка), excerpt (тизер).
  • image (обложка для превью и Open Graph).
  • SEO-поля: seo_title, seo_description, seo_keywords.
  • Метод get_absolute_url(): возвращает /blog/<slug>/ для постов или /<slug>/ для страниц.

Представления (blog/views.py)

• post_list (/blog/): список опубликованных статей блога с пагинацией.
• post_detail (/blog/<slug>/): детальная страница поста с Open Graph мета-тегами и разметкой.
• page_detail (/<slug>/): отображение статических страниц.
• sitemaps.py: генерация sitemap.xml по опубликованным записям.