pyferro-demo 0.1.0__tar.gz

pyferro_demo-0.1.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: pyferro-demo
+Version: 0.1.0
+Summary: Showcase & educational demo application built on the PyFerro framework (SEO Forum, JSON-RPC, Granian RSGI).
+Author-email: Alex Titoff <a.tit.off@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/atitoff-dotcom/PyFerro
+Project-URL: Repository, https://github.com/atitoff-dotcom/PyFerro.git
+Keywords: pyferro,demo,forum,showcase,rsgi,wsrpc
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: pyferro>=2.1.0
+
+# 🚀 PyFerro Showcase & Demo Application
+
+Официальное демонстрационное и обучающее приложение на реактивном фреймворке **PyFerro**.
+Служит образцом архитектуры, живым примером использования и E2E-тестером ядра.
+
+---
+
+## 💡 Особенности
+
+- **Изолированная база данных:** Приложение по умолчанию создает и использует локальную базу данных `demo.db` (SQLite). Ваша корпоративная БД остается в полной безопасности.
+- **Полнофункциональный SEO-форум:**
+  - Древовидная структура разделов и веток (`Topic`, `Message`).
+  - Микроразметка Schema.org (`BreadcrumbList`, `DiscussionForumPosting` в JSON-LD).
+  - Динамический рендеринг страниц для поисковых ботов (Jinja2).
+- **Симметричный JSON-RPC 2.0:** Примеры декларации методов с контролем ролей (RBAC).
+- **Готовые сид-данные:** Автоматическое наполнение 10 темами и ветками обсуждений при первом запуске.
+
+---
+
+## ⚡ Быстрый старт
+
+### 1. Установка из PyPI:
+```bash
+pip install pyferro-demo
+```
+
+### 2. Запуск приложения:
+```bash
+pyferro-demo run
+```
+или без предварительной установки:
+```bash
+pipx run pyferro-demo
+```
+
+Приложение запустится на Rust-сервере Granian:
+- **Админка PyFerro:** [http://localhost:8080/pyferro_admin/](http://localhost:8080/pyferro_admin/) (логин: `admin`, пароль: `admin`)
+- **JSON-RPC эндпоинт:** `ws://localhost:8080/wsrpc`
+- **Sitemap XML:** [http://localhost:8080/sitemap.xml](http://localhost:8080/sitemap.xml)
+
+---
+
+## 📂 Структура проекта
+
+```text
+pyferro_demo/
+├── cli.py             # Точка входа консольной команды pyferro-demo
+├── app.py             # Фабрика приложения PyFerroApp и регистрация модулей
+├── forum/
+│   ├── models.py      # SQLAlchemy-модели топиков и сообщений
+│   ├── rpc.py         # JSON-RPC 2.0 методы (forum.list_topics, forum.get_topic и т.д.)
+│   ├── seeder.py      # Идемпотентный сидинг демонстрационных данных
+│   └── seo.py         # Генерация JSON-LD микроразметки и хлебных крошек
+└── templates/
+    └── forum_topic.html # Шаблон Jinja2 для Dynamic Rendering
+```
+
+---
+
+## 🧪 Запуск тестов
+
+```bash
+pytest
+```

pyferro_demo-0.1.0/README.md

@@ -0,0 +1,64 @@
+# 🚀 PyFerro Showcase & Demo Application
+
+Официальное демонстрационное и обучающее приложение на реактивном фреймворке **PyFerro**.
+Служит образцом архитектуры, живым примером использования и E2E-тестером ядра.
+
+---
+
+## 💡 Особенности
+
+- **Изолированная база данных:** Приложение по умолчанию создает и использует локальную базу данных `demo.db` (SQLite). Ваша корпоративная БД остается в полной безопасности.
+- **Полнофункциональный SEO-форум:**
+  - Древовидная структура разделов и веток (`Topic`, `Message`).
+  - Микроразметка Schema.org (`BreadcrumbList`, `DiscussionForumPosting` в JSON-LD).
+  - Динамический рендеринг страниц для поисковых ботов (Jinja2).
+- **Симметричный JSON-RPC 2.0:** Примеры декларации методов с контролем ролей (RBAC).
+- **Готовые сид-данные:** Автоматическое наполнение 10 темами и ветками обсуждений при первом запуске.
+
+---
+
+## ⚡ Быстрый старт
+
+### 1. Установка из PyPI:
+```bash
+pip install pyferro-demo
+```
+
+### 2. Запуск приложения:
+```bash
+pyferro-demo run
+```
+или без предварительной установки:
+```bash
+pipx run pyferro-demo
+```
+
+Приложение запустится на Rust-сервере Granian:
+- **Админка PyFerro:** [http://localhost:8080/pyferro_admin/](http://localhost:8080/pyferro_admin/) (логин: `admin`, пароль: `admin`)
+- **JSON-RPC эндпоинт:** `ws://localhost:8080/wsrpc`
+- **Sitemap XML:** [http://localhost:8080/sitemap.xml](http://localhost:8080/sitemap.xml)
+
+---
+
+## 📂 Структура проекта
+
+```text
+pyferro_demo/
+├── cli.py             # Точка входа консольной команды pyferro-demo
+├── app.py             # Фабрика приложения PyFerroApp и регистрация модулей
+├── forum/
+│   ├── models.py      # SQLAlchemy-модели топиков и сообщений
+│   ├── rpc.py         # JSON-RPC 2.0 методы (forum.list_topics, forum.get_topic и т.д.)
+│   ├── seeder.py      # Идемпотентный сидинг демонстрационных данных
+│   └── seo.py         # Генерация JSON-LD микроразметки и хлебных крошек
+└── templates/
+    └── forum_topic.html # Шаблон Jinja2 для Dynamic Rendering
+```
+
+---
+
+## 🧪 Запуск тестов
+
+```bash
+pytest
+```

pyferro_demo-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyferro-demo"
+version = "0.1.0"
+description = "Showcase & educational demo application built on the PyFerro framework (SEO Forum, JSON-RPC, Granian RSGI)."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+    { name = "Alex Titoff", email = "a.tit.off@gmail.com" }
+]
+keywords = ["pyferro", "demo", "forum", "showcase", "rsgi", "wsrpc"]
+dependencies = [
+    "pyferro>=2.1.0",
+]
+
+[project.scripts]
+pyferro-demo = "pyferro_demo.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/atitoff-dotcom/PyFerro"
+Repository = "https://github.com/atitoff-dotcom/PyFerro.git"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["pyferro_demo*"]
+
+[tool.setuptools.package-data]
+"pyferro_demo" = [
+    "templates/*",
+]
+
+[tool.pytest.ini_options]
+pythonpath = [".", "src"]
+asyncio_mode = "auto"

pyferro_demo-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyferro_demo-0.1.0/src/pyferro_demo/__init__.py

@@ -0,0 +1,5 @@
+"""
+PyFerro Showcase & Demo Application.
+"""
+
+__version__ = "0.1.0"

pyferro_demo-0.1.0/src/pyferro_demo/__main__.py

@@ -0,0 +1,4 @@
+from pyferro_demo.cli import main
+
+if __name__ == "__main__":
+    main()

pyferro_demo-0.1.0/src/pyferro_demo/app.py

@@ -0,0 +1,44 @@
+"""
+Фабрика демонстрационного приложения PyFerro Demo.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from pyferro2.db import Database
+from pyferro2.server import PyFerroApp
+from pyferro_demo.forum.models import ForumBase
+from pyferro_demo.forum.rpc import register_forum_rpc
+from pyferro_demo.forum.seeder import seed_forum_data
+
+
+async def create_demo_app(
+    db_url: str = "sqlite+aiosqlite:///demo.db",
+    secret_key: str = "pyferro-demo-secret-key-32-chars-long!",
+) -> PyFerroApp:
+    """
+    Создает и настраивает экземпляр PyFerroApp с демонстрационным форумом.
+    """
+    db = Database(db_url)
+    # Создаем таблицы ядра PyFerro (pf_*)
+    await db.create_tables()
+
+    # Создаем таблицы демонстрационного форума в той же изолированной demo.db
+    async with db.engine.begin() as conn:
+        await conn.run_sync(ForumBase.metadata.create_all)
+
+    # Инициализируем сид-данные форума
+    async with db.session() as session:
+        await seed_forum_data(session)
+
+    # Создаем приложение PyFerro
+    app = PyFerroApp(
+        db=db,
+        secret_key=secret_key,
+    )
+
+    # Регистрируем RPC-методы форума
+    register_forum_rpc(app.router, db)
+
+    return app

pyferro_demo-0.1.0/src/pyferro_demo/cli.py

@@ -0,0 +1,52 @@
+"""
+CLI утилита запуска pyferro-demo.
+"""
+
+from __future__ import annotations
+
+import argparse
+import asyncio
+import sys
+
+from pyferro_demo.app import create_demo_app
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="pyferro-demo",
+        description="🚀 Запуск демонстрационного приложения PyFerro (Форум, JSON-RPC, Granian RSGI)",
+    )
+    parser.add_argument(
+        "command",
+        nargs="?",
+        default="run",
+        choices=["run"],
+        help="Команда (по умолчанию run)",
+    )
+    parser.add_argument(
+        "--host", default="127.0.0.1", help="Хост сервера (по умолчанию 127.0.0.1)"
+    )
+    parser.add_argument(
+        "--port", type=int, default=8080, help="Порт сервера (по умолчанию 8080)"
+    )
+    parser.add_argument(
+        "--db", default="demo.db", help="Путь к SQLite базе данных (по умолчанию demo.db)"
+    )
+
+    args = parser.parse_args()
+
+    print("=" * 60)
+    print(" 🚀 Запуск PyFerro Showcase & Demo Application")
+    print(f" 📦 База данных: {args.db}")
+    print(f" 🌐 Адрес:       http://{args.host}:{args.port}")
+    print(f" 🛡️  Админка:     http://{args.host}:{args.port}/pyferro_admin/")
+    print(" 🔑 Логин:       admin / Пароль: admin")
+    print("=" * 60)
+
+    db_url = f"sqlite+aiosqlite:///{args.db}"
+    app = asyncio.run(create_demo_app(db_url=db_url))
+    app.run(host=args.host, port=args.port)
+
+
+if __name__ == "__main__":
+    main()

pyferro_demo-0.1.0/src/pyferro_demo/forum/__init__.py

@@ -0,0 +1,15 @@
+"""
+Модуль форума: модели, RPC и генераторы SEO.
+"""
+
+from pyferro_demo.forum.models import ForumBase, Topic, Message
+from pyferro_demo.forum.rpc import register_forum_rpc
+from pyferro_demo.forum.seeder import seed_forum_data
+
+__all__ = [
+    "ForumBase",
+    "Topic",
+    "Message",
+    "register_forum_rpc",
+    "seed_forum_data",
+]

pyferro_demo-0.1.0/src/pyferro_demo/forum/models.py

@@ -0,0 +1,70 @@
+"""
+SQLAlchemy-модели демонстрационного форума.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+
+from sqlalchemy import Boolean, DateTime, ForeignKey, Integer, String, Text
+from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, relationship
+
+
+def _now_utc() -> datetime:
+    return datetime.now(timezone.utc)
+
+
+class ForumBase(DeclarativeBase):
+    """Базовый класс моделей демонстрационного форума."""
+    pass
+
+
+class Topic(ForumBase):
+    """Древовидная иерархия разделов и тем форума."""
+
+    __tablename__ = "forum_topics"
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
+    parent_id: Mapped[int | None] = mapped_column(
+        Integer,
+        ForeignKey("forum_topics.id", ondelete="CASCADE"),
+        nullable=True,
+        index=True,
+    )
+    title: Mapped[str] = mapped_column(String(200), nullable=False)
+    slug: Mapped[str] = mapped_column(String(200), unique=True, nullable=False, index=True)
+    is_category: Mapped[bool] = mapped_column(Boolean, default=False)
+    seo_title: Mapped[str | None] = mapped_column(String(250), nullable=True)
+    seo_description: Mapped[str | None] = mapped_column(Text, nullable=True)
+    created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=_now_utc)
+    updated_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), default=_now_utc, onupdate=_now_utc
+    )
+
+    # Отношение к сообщениям
+    messages: Mapped[list[Message]] = relationship(
+        "Message",
+        back_populates="topic",
+        cascade="all, delete-orphan",
+        order_by="Message.created_at",
+    )
+
+
+class Message(ForumBase):
+    """Сообщения внутри форумной ветки."""
+
+    __tablename__ = "forum_messages"
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
+    topic_id: Mapped[int] = mapped_column(
+        Integer,
+        ForeignKey("forum_topics.id", ondelete="CASCADE"),
+        nullable=False,
+        index=True,
+    )
+    author_name: Mapped[str] = mapped_column(String(120), nullable=False)
+    content: Mapped[str] = mapped_column(Text, nullable=False)
+    created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=_now_utc)
+
+    # Обратное отношение
+    topic: Mapped[Topic] = relationship("Topic", back_populates="messages")

pyferro_demo-0.1.0/src/pyferro_demo/forum/rpc.py

@@ -0,0 +1,108 @@
+"""
+JSON-RPC 2.0 интерфейс форума (forum.*).
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from sqlalchemy import select
+from sqlalchemy.orm import selectinload
+
+from pyferro2.core.session_data import SessionData
+from pyferro2.db.engine import Database
+from pyferro2.rpc.router import RpcRouter
+from pyferro_demo.forum.models import Message, Topic
+from pyferro_demo.forum.seo import get_topic_breadcrumbs, get_topic_discussion_posting
+
+
+def register_forum_rpc(router: RpcRouter, db: Database) -> None:
+    """Регистрирует методы `forum.*` в RPC-роутере PyFerro."""
+
+    class forum:
+        @router.rpc_method(public=True)
+        async def list_topics(
+            session_data: SessionData, parent_id: int | None = None
+        ) -> list[dict[str, Any]]:
+            """Возвращает список тем форума."""
+            async with db.session() as session:
+                stmt = select(Topic).where(Topic.parent_id == parent_id)
+                res = await session.execute(stmt)
+                topics = res.scalars().all()
+                return [
+                    {
+                        "id": t.id,
+                        "parent_id": t.parent_id,
+                        "title": t.title,
+                        "slug": t.slug,
+                        "is_category": t.is_category,
+                        "seo_title": t.seo_title,
+                        "seo_description": t.seo_description,
+                        "created_at": t.created_at.isoformat(),
+                    }
+                    for t in topics
+                ]
+
+        @router.rpc_method(public=True)
+        async def get_topic(
+            session_data: SessionData, slug: str
+        ) -> dict[str, Any] | None:
+            """Возвращает тему и сообщения по slug."""
+            async with db.session() as session:
+                stmt = (
+                    select(Topic)
+                    .where(Topic.slug == slug)
+                    .options(selectinload(Topic.messages))
+                )
+                res = await session.execute(stmt)
+                topic = res.scalar_one_or_none()
+                if not topic:
+                    return None
+
+                breadcrumbs = await get_topic_breadcrumbs(session, topic.id)
+                discussion_ld = await get_topic_discussion_posting(session, topic.id)
+
+                return {
+                    "id": topic.id,
+                    "title": topic.title,
+                    "slug": topic.slug,
+                    "is_category": topic.is_category,
+                    "seo_title": topic.seo_title,
+                    "seo_description": topic.seo_description,
+                    "breadcrumbs": breadcrumbs,
+                    "json_ld": discussion_ld,
+                    "messages": [
+                        {
+                            "id": m.id,
+                            "author_name": m.author_name,
+                            "content": m.content,
+                            "created_at": m.created_at.isoformat(),
+                        }
+                        for m in topic.messages
+                    ],
+                }
+
+        @router.rpc_method(role=["user", "admin"])
+        async def create_message(
+            session_data: SessionData,
+            topic_id: int,
+            content: str,
+            author_name: str | None = None,
+        ) -> dict[str, Any]:
+            """Создает новое сообщение в теме (доступно авторизованным пользователям)."""
+            name = author_name or session_data.username or "Пользователь"
+            async with db.session() as session:
+                msg = Message(
+                    topic_id=topic_id,
+                    author_name=name,
+                    content=content,
+                )
+                session.add(msg)
+                await session.commit()
+                return {
+                    "id": msg.id,
+                    "topic_id": msg.topic_id,
+                    "author_name": msg.author_name,
+                    "content": msg.content,
+                    "created_at": msg.created_at.isoformat(),
+                }

pyferro_demo-0.1.0/src/pyferro_demo/forum/seeder.py

@@ -0,0 +1,184 @@
+"""
+Демо-сидер для форума: наполнение разделами и сообщениями.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime, timedelta, timezone
+
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from pyferro_demo.forum.models import Message, Topic
+
+
+async def seed_forum_data(session: AsyncSession) -> dict[str, int]:
+    """
+    Идемпотентно заполняет базу данных темами и сообщениями, если она пуста.
+    """
+    res = await session.execute(select(Topic))
+    if res.scalars().first() is not None:
+        return {"topics": 0, "messages": 0}
+
+    now = datetime.now(timezone.utc)
+
+    # 1. Корневой раздел 1
+    t1 = Topic(
+        title="Общие дискуссии",
+        slug="general",
+        is_category=True,
+        seo_title="Общие темы и новости сообщества PyFerro",
+        seo_description="Корневой раздел общих обсуждений, анонсов и правил проекта PyFerro.",
+        created_at=now - timedelta(days=10),
+    )
+    session.add(t1)
+    await session.flush()
+
+    # 2. Подраздел новостей (внутри 1)
+    t2 = Topic(
+        parent_id=t1.id,
+        title="Новости и анонсы",
+        slug="news",
+        is_category=True,
+        seo_title="Официальные новости и релизы",
+        seo_description="Все официальные новости фреймворка, релиз-ноты и важные изменения.",
+        created_at=now - timedelta(days=9),
+    )
+    session.add(t2)
+    await session.flush()
+
+    # 3. Ветка обсуждения релиза (внутри 2)
+    t3 = Topic(
+        parent_id=t2.id,
+        title="Релиз PyFerro 2.0: архитектура и возможности",
+        slug="pyferro-2-0-release",
+        is_category=False,
+        seo_title="Обсуждение релиза PyFerro 2.0",
+        seo_description="Подробный разбор архитектуры PyFerro 2.0: Rust-сервер Granian, RSGI, JSON-RPC и Svelte 5.",
+        created_at=now - timedelta(days=8),
+    )
+    session.add(t3)
+
+    # 4. Ветка дорожной карты (внутри 2)
+    t4 = Topic(
+        parent_id=t2.id,
+        title="Дорожная карта развития на 2026 год",
+        slug="roadmap-2026",
+        is_category=False,
+        seo_title="Roadmap PyFerro 2026",
+        seo_description="Планы развития платформы: поддержка новых протоколов, плагины и масштабирование.",
+        created_at=now - timedelta(days=7),
+    )
+    session.add(t4)
+
+    # 5. Тема правил (внутри 1)
+    t5 = Topic(
+        parent_id=t1.id,
+        title="Правила форума и оформления кода",
+        slug="rules",
+        is_category=False,
+        seo_title="Правила сообщества PyFerro",
+        seo_description="Рекомендации по созданию веток, культуре общения и форматированию сниппетов кода.",
+        created_at=now - timedelta(days=6),
+    )
+    session.add(t5)
+    await session.flush()
+
+    # 6. Корневой раздел 2: Разработка
+    t6 = Topic(
+        title="Разработка и архитектура",
+        slug="development",
+        is_category=True,
+        seo_title="Разработка бэкенда и интерфейсов",
+        seo_description="Технический раздел: архитектура сервисов, базы данных, API и фронтенд.",
+        created_at=now - timedelta(days=5),
+    )
+    session.add(t6)
+    await session.flush()
+
+    # 7. Подраздел бэкенда (внутри 6)
+    t7 = Topic(
+        parent_id=t6.id,
+        title="Бэкенд и базы данных",
+        slug="backend-db",
+        is_category=True,
+        seo_title="Бэкенд на Rust RSGI и SQLAlchemy",
+        seo_description="Обсуждение асинхронного движка, моделей SQLAlchemy и производительности.",
+        created_at=now - timedelta(days=4),
+    )
+    session.add(t7)
+    await session.flush()
+
+    # 8. Топик о производительности Granian (внутри 7)
+    t8 = Topic(
+        parent_id=t7.id,
+        title="Бенчмарки Granian RSGI против Uvicorn",
+        slug="granian-vs-uvicorn",
+        is_category=False,
+        seo_title="Сравнение производительности Granian и Uvicorn",
+        seo_description="Тесты RPS и задержек: как Rust-рантайм Granian ускоряет асинхронный Python.",
+        created_at=now - timedelta(days=3),
+    )
+    session.add(t8)
+
+    # 9. Топик о сжатии Tabular RPC (внутри 7)
+    t9 = Topic(
+        parent_id=t7.id,
+        title="Сжатие данных Tabular: экономия сетевого трафика до 80%",
+        slug="tabular-compression",
+        is_category=False,
+        seo_title="Экономия трафика с Tabular RPC",
+        seo_description="Разбор протокола Tabular для передачи списков словарей через WebSocket.",
+        created_at=now - timedelta(days=2),
+    )
+    session.add(t9)
+
+    # 10. Топик о SEO и Dynamic Rendering (внутри 6)
+    t10 = Topic(
+        parent_id=t6.id,
+        title="Dynamic Rendering: идеальная индексация SPA для Google и Яндекса",
+        slug="dynamic-rendering-guide",
+        is_category=False,
+        seo_title="Руководство по Dynamic Rendering в PyFerro",
+        seo_description="Практика настройки Jinja2-шаблонов, IndexNow и карты сайта sitemap.xml для SPA.",
+        created_at=now - timedelta(days=1),
+    )
+    session.add(t10)
+    await session.flush()
+
+    # Наполняем сообщениями
+    m1 = Message(
+        topic_id=t3.id,
+        author_name="Алексей (Архитектор)",
+        content="Коллеги, рад представить PyFerro 2.0! Платформа переведена на Rust RSGI (Granian), что снизило задержки до микросекунд.",
+        created_at=now - timedelta(days=8, hours=2),
+    )
+    m2 = Message(
+        topic_id=t3.id,
+        author_name="Дмитрий (DevOps)",
+        content="Отличный релиз! Проверили сборку Docker-образов — вес минимальный, потребление памяти снизилось на 40%.",
+        created_at=now - timedelta(days=7, hours=18),
+    )
+    m3 = Message(
+        topic_id=t8.id,
+        author_name="Иван (Senior Python)",
+        content="В синтетических тестах Granian держит 45k RPS на одном ядре при нулевом дропе пакетов. Это лучший результат в Python экосистеме.",
+        created_at=now - timedelta(days=3, hours=1),
+    )
+    m4 = Message(
+        topic_id=t9.id,
+        author_name="Мария (Frontend)",
+        content="Tabular Data Compression сработал отлично в гридах админки: загрузка 10,000 строк теперь занимает миллисекунды.",
+        created_at=now - timedelta(days=2, hours=3),
+    )
+    m5 = Message(
+        topic_id=t10.id,
+        author_name="Сергей (SEO-специалист)",
+        content="Боты поисковиков видят чистый HTML с разметкой Schema.org, а живые пользователи получают реактивный SPA. Идеальный баланс!",
+        created_at=now - timedelta(days=1, hours=4),
+    )
+
+    session.add_all([m1, m2, m3, m4, m5])
+    await session.commit()
+
+    return {"topics": 10, "messages": 5}

pyferro_demo-0.1.0/src/pyferro_demo/forum/seo.py

@@ -0,0 +1,122 @@
+"""
+Генератор SEO-микроразметки Schema.org (BreadcrumbList, DiscussionForumPosting) и sitemap.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy.orm import selectinload
+
+from pyferro_demo.forum.models import Message, Topic
+
+
+async def get_topic_breadcrumbs(
+    session: AsyncSession, topic_id: int, base_url: str = "http://localhost:8080"
+) -> dict[str, Any]:
+    """Строит хлебные крошки Schema.org BreadcrumbList."""
+    base_url = base_url.rstrip("/")
+    chain: list[Topic] = []
+    curr_id: int | None = topic_id
+    visited: set[int] = set()
+
+    while curr_id is not None and curr_id not in visited:
+        visited.add(curr_id)
+        topic = await session.get(Topic, curr_id)
+        if not topic:
+            break
+        chain.append(topic)
+        curr_id = topic.parent_id
+
+    chain.reverse()
+
+    path_segments: list[str] = []
+    items: list[dict[str, Any]] = [
+        {
+            "@type": "ListItem",
+            "position": 1,
+            "name": "Форум",
+            "item": f"{base_url}/forum",
+        }
+    ]
+
+    for idx, t in enumerate(chain, start=2):
+        path_segments.append(t.slug)
+        full_url = f"{base_url}/forum/{'/'.join(path_segments)}"
+        items.append(
+            {
+                "@type": "ListItem",
+                "position": idx,
+                "name": t.title,
+                "item": full_url,
+            }
+        )
+
+    return {
+        "@context": "https://schema.org",
+        "@type": "BreadcrumbList",
+        "itemListElement": items,
+    }
+
+
+async def get_topic_discussion_posting(
+    session: AsyncSession, topic_id: int, base_url: str = "http://localhost:8080"
+) -> dict[str, Any] | None:
+    """Генерирует микроразметку DiscussionForumPosting для сниппетов поисковиков."""
+    base_url = base_url.rstrip("/")
+    stmt = (
+        select(Topic)
+        .where(Topic.id == topic_id)
+        .options(selectinload(Topic.messages))
+    )
+    result = await session.execute(stmt)
+    topic = result.scalar_one_or_none()
+
+    if not topic:
+        return None
+
+    messages = sorted(topic.messages, key=lambda m: m.created_at)
+    first_post = messages[0] if messages else None
+    replies = messages[1:] if len(messages) > 1 else []
+
+    url = f"{base_url}/forum/{topic.slug}"
+
+    ld: dict[str, Any] = {
+        "@context": "https://schema.org",
+        "@type": "DiscussionForumPosting",
+        "headline": topic.seo_title or topic.title,
+        "description": topic.seo_description or topic.title,
+        "url": url,
+        "datePublished": topic.created_at.isoformat(),
+        "dateModified": topic.updated_at.isoformat(),
+        "interactionStatistic": {
+            "@type": "InteractionCounter",
+            "interactionType": "https://schema.org/CommentAction",
+            "userInteractionCount": len(topic.messages),
+        },
+    }
+
+    if first_post:
+        ld["author"] = {
+            "@type": "Person",
+            "name": first_post.author_name,
+        }
+        ld["articleBody"] = first_post.content
+
+    if replies:
+        ld["comment"] = [
+            {
+                "@type": "Comment",
+                "text": rep.content,
+                "dateCreated": rep.created_at.isoformat(),
+                "author": {
+                    "@type": "Person",
+                    "name": rep.author_name,
+                },
+            }
+            for rep in replies
+        ]
+
+    return ld

pyferro_demo-0.1.0/src/pyferro_demo.egg-info/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: pyferro-demo
+Version: 0.1.0
+Summary: Showcase & educational demo application built on the PyFerro framework (SEO Forum, JSON-RPC, Granian RSGI).
+Author-email: Alex Titoff <a.tit.off@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/atitoff-dotcom/PyFerro
+Project-URL: Repository, https://github.com/atitoff-dotcom/PyFerro.git
+Keywords: pyferro,demo,forum,showcase,rsgi,wsrpc
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: pyferro>=2.1.0
+
+# 🚀 PyFerro Showcase & Demo Application
+
+Официальное демонстрационное и обучающее приложение на реактивном фреймворке **PyFerro**.
+Служит образцом архитектуры, живым примером использования и E2E-тестером ядра.
+
+---
+
+## 💡 Особенности
+
+- **Изолированная база данных:** Приложение по умолчанию создает и использует локальную базу данных `demo.db` (SQLite). Ваша корпоративная БД остается в полной безопасности.
+- **Полнофункциональный SEO-форум:**
+  - Древовидная структура разделов и веток (`Topic`, `Message`).
+  - Микроразметка Schema.org (`BreadcrumbList`, `DiscussionForumPosting` в JSON-LD).
+  - Динамический рендеринг страниц для поисковых ботов (Jinja2).
+- **Симметричный JSON-RPC 2.0:** Примеры декларации методов с контролем ролей (RBAC).
+- **Готовые сид-данные:** Автоматическое наполнение 10 темами и ветками обсуждений при первом запуске.
+
+---
+
+## ⚡ Быстрый старт
+
+### 1. Установка из PyPI:
+```bash
+pip install pyferro-demo
+```
+
+### 2. Запуск приложения:
+```bash
+pyferro-demo run
+```
+или без предварительной установки:
+```bash
+pipx run pyferro-demo
+```
+
+Приложение запустится на Rust-сервере Granian:
+- **Админка PyFerro:** [http://localhost:8080/pyferro_admin/](http://localhost:8080/pyferro_admin/) (логин: `admin`, пароль: `admin`)
+- **JSON-RPC эндпоинт:** `ws://localhost:8080/wsrpc`
+- **Sitemap XML:** [http://localhost:8080/sitemap.xml](http://localhost:8080/sitemap.xml)
+
+---
+
+## 📂 Структура проекта
+
+```text
+pyferro_demo/
+├── cli.py             # Точка входа консольной команды pyferro-demo
+├── app.py             # Фабрика приложения PyFerroApp и регистрация модулей
+├── forum/
+│   ├── models.py      # SQLAlchemy-модели топиков и сообщений
+│   ├── rpc.py         # JSON-RPC 2.0 методы (forum.list_topics, forum.get_topic и т.д.)
+│   ├── seeder.py      # Идемпотентный сидинг демонстрационных данных
+│   └── seo.py         # Генерация JSON-LD микроразметки и хлебных крошек
+└── templates/
+    └── forum_topic.html # Шаблон Jinja2 для Dynamic Rendering
+```
+
+---
+
+## 🧪 Запуск тестов
+
+```bash
+pytest
+```

pyferro_demo-0.1.0/src/pyferro_demo.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+README.md
+pyproject.toml
+src/pyferro_demo/__init__.py
+src/pyferro_demo/__main__.py
+src/pyferro_demo/app.py
+src/pyferro_demo/cli.py
+src/pyferro_demo.egg-info/PKG-INFO
+src/pyferro_demo.egg-info/SOURCES.txt
+src/pyferro_demo.egg-info/dependency_links.txt
+src/pyferro_demo.egg-info/entry_points.txt
+src/pyferro_demo.egg-info/requires.txt
+src/pyferro_demo.egg-info/top_level.txt
+src/pyferro_demo/forum/__init__.py
+src/pyferro_demo/forum/models.py
+src/pyferro_demo/forum/rpc.py
+src/pyferro_demo/forum/seeder.py
+src/pyferro_demo/forum/seo.py
+tests/test_forum_e2e.py

pyferro_demo-0.1.0/src/pyferro_demo.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyferro_demo-0.1.0/src/pyferro_demo.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pyferro-demo = pyferro_demo.cli:main

pyferro_demo-0.1.0/src/pyferro_demo.egg-info/requires.txt

@@ -0,0 +1 @@
+pyferro>=2.1.0

pyferro_demo-0.1.0/src/pyferro_demo.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyferro_demo

pyferro_demo-0.1.0/tests/test_forum_e2e.py

@@ -0,0 +1,60 @@
+"""
+E2E тесты демонстрационного приложения pyferro-demo.
+Проверяют интеграцию с ядром PyFerro, работу моделей, RPC и SEO.
+"""
+
+from __future__ import annotations
+
+import pytest
+
+from pyferro2.core.session import Session
+from pyferro2.core.session_data import SessionData
+from pyferro_demo.app import create_demo_app
+
+
+@pytest.fixture
+async def app():
+    """Создает тестовое демо-приложение в памяти."""
+    demo_app = await create_demo_app(db_url="sqlite+aiosqlite:///:memory:")
+    yield demo_app
+    await demo_app.db.close()
+
+
+class TestForumE2E:
+    @pytest.mark.asyncio
+    async def test_list_topics(self, app):
+        """Проверяет получение списка тем форума через RPC."""
+        session = Session(session_id="s-admin", data=SessionData(user_id=1, username="admin", roles=frozenset(["admin"])))
+        topics = await app.router.call("forum.list_topics", session)
+        assert isinstance(topics, list)
+        assert len(topics) >= 2  # Корневые темы
+
+    @pytest.mark.asyncio
+    async def test_get_topic_with_seo(self, app):
+        """Проверяет получение топика с JSON-LD разметкой."""
+        session = Session(session_id="s-admin", data=SessionData(user_id=1, username="admin", roles=frozenset(["admin"])))
+        topic = await app.router.call("forum.get_topic", session, {"slug": "pyferro-2-0-release"})
+        assert topic is not None
+        assert topic["slug"] == "pyferro-2-0-release"
+        assert len(topic["messages"]) >= 1
+
+        # Проверка хлебных крошек
+        assert "breadcrumbs" in topic
+        assert topic["breadcrumbs"]["@type"] == "BreadcrumbList"
+
+        # Проверка DiscussionForumPosting
+        assert "json_ld" in topic
+        assert topic["json_ld"]["@type"] == "DiscussionForumPosting"
+        assert "headline" in topic["json_ld"]
+
+    @pytest.mark.asyncio
+    async def test_create_message(self, app):
+        """Проверяет отправку сообщения в тему через RPC."""
+        session = Session(session_id="s-user", data=SessionData(user_id=1, username="tester", roles=frozenset(["user"])))
+        res = await app.router.call(
+            "forum.create_message",
+            session,
+            {"topic_id": 3, "content": "Тестовое сообщение из E2E теста"},
+        )
+        assert res["content"] == "Тестовое сообщение из E2E теста"
+        assert res["author_name"] == "tester"