Skip to content

Repository files navigation

Author.Today Intelligence

Локальный прототип для автора, который отвечает на простой вопрос:

Что изменилось у моих книг, где они видны в релевантных топах и на каких исходных данных основан каждый вывод?

Decision-first обзор Сергея

Мобильное состояние: sergey-decision-first-mobile.png.

Что это сейчас

Это decision-first и evidence-first локальный прототип, проверенный на публичном портфеле Сергея Насоновского. Первый экран сначала отвечает, что изменилось и что проверить, а формулы и источники раскрываются по запросу. В той же локальной базе есть отдельный контур кандидатов возможных незаконных публикаций с обязательной ручной квалификацией. Это не готовый SaaS, не замена кабинета Author.Today и не юридическое заключение.

На контрольном срезе 17 июля 2026 года он показывает:

Объект Проверенный объём
Публичные произведения Сергея 24: 19 электронных и 5 аудиокниг
Сопоставимые публичные снимки 2 × 24 = 48 точек
Отслеживаемые выдачи 4 общие + 6 жанровых
Ограниченный аудит Wayback 53 снимка для 14 из 24 произведений
Реальная ручная выборка комментариев 2 комментария, 1 ветка, 1 подтверждённый тег

Реальная выборка комментариев хранится только локально и не публикуется в репозитории. Репозиторий содержит синтетический пример для тестов.

Что увидит Сергей

  1. Короткий обзор. За первый экран видно, сколько книг изменилось и какую книгу проверить первой. Показываются максимум три приоритетных объекта без автоматических гипотез.
  2. Автор и портфель. Явно выбран профиль https://author.today/u/nasonovsky; показаны все 24 публичных произведения.
  3. Динамика. Для книги видны график, исходные значения, точное время и формула. Например: 119 527 − 119 439 = +88 просмотров.
  4. Релевантные топы. Общие выдачи не смешиваются с жанровыми. Наблюдаются Альтернативная история, Исторические приключения и Попаданцы во времени, режимы popular и trending, окно top-25.
  5. Комментарии как доказательства. Путь выглядит так: тег → наблюдение → точная цитата → полный текст → ветка → профиль → оригинал.
  6. Качество источника. Регулярный публичный снимок, ручная выборка и нерегулярная архивная точка подписаны раздельно.

Что нельзя заключать

  • Отсутствие книги в top-25 не означает отсутствие во всём рейтинге.
  • Два снимка позволяют посчитать изменение, но ещё не сезонный тренд.
  • Архивные снимки нерегулярны и не образуют непрерывную историю.
  • Наблюдаемая выборка не является «всем рынком Author.Today».
  • Корреляция не доказывает причину.
  • UI не создаёт гипотезы автоматически: по умолчанию их количество равно нулю.

Точный состав мониторинга

Действующий 14-дневный мониторинг делает публичный снимок каждые 6 часов. Статистические сутки трактуются в часовом поясе Москвы (UTC+3). Накопленные снимки дописываются, а не перезаписываются.

Общий сравнительный контекст

  • all / popular, первые 20 позиций;
  • all / trending, первые 20;
  • новые популярные книги, первые 20;
  • последние публикации, первые 20.

Жанры Сергея

  • sf-history / popular, top-25;
  • sf-history / trending, top-25;
  • historical-adventure / popular, top-25;
  • historical-adventure / trending, top-25;
  • popadantsy-vo-vremeni / popular, top-25;
  • popadantsy-vo-vremeni / trending, top-25.

Старые общие снимки не переименовываются задним числом в жанровые. Жанровый временной ряд начинается с момента добавления этих категорий.

Подробный аудит: MONITORING_AUDIT_2026-07-17.md.

Запуск в чистом clone

Docker

git clone https://github.com/Topleess/author-today-intelligence.git
cd author-today-intelligence

docker compose --profile sync run --rm public-sync
docker compose up -d controller
curl http://127.0.0.1:8787/api/health

Откройте http://127.0.0.1:8787.

Повторный разрешённый публичный снимок:

docker compose --profile sync run --rm public-sync

Остановить, сохранив SQLite volume:

docker compose down

docker compose down -v удаляет локальные данные, поэтому используйте его только намеренно.

Python

Проект не требует сторонних runtime-зависимостей:

python3 -m venv .venv
. .venv/bin/activate
pip install -e .

atintel author-add https://author.today/u/nasonovsky --name "Сергей Насоновский"
atintel bootstrap --sorting popular --output raw/popular.json --db analytics.sqlite3
atintel rights-candidate-ingest examples/rights_candidate_sergey_moreknig.json --db analytics.sqlite3
atintel rights-case-ingest examples/rights_case_sergey_moreknig.json --db analytics.sqlite3
atintel serve --db analytics.sqlite3

Комментарии и правовая граница

Оферта Author.Today ограничивает использование программ и скриптов для сбора информации. Поэтому проект не выпускает массовый или авторизованный сборщик комментариев.

Безопасный путь:

  1. владелец вручную выбирает ограниченный публичный материал в обычном браузере;
  2. сохраняет локальный JSON с веткой, датой, автором, текстом и оригинальными URL;
  3. импортирует его командой atintel ingest selected-comments.json;
  4. вручную подтверждает цитату и тег.

Пароли, cookies, OTP, Authorization-заголовки, browser profile, localStorage и session material отклоняются.

Подробнее: COMMENTS_EVIDENCE.ru.md и MANUAL_IMPORT.md.

Архивы

Ограниченный аудит 24 явных URL дал покрытие 14/24 или 58,3%. Плотность неоднородна: от 0 до 9 снимков на произведение. Поэтому массовый архивный backfill остановлен как недоказанный по полезности.

Архив используется только как отдельная evidence-точка с датой, URL и locator.

Подробнее: SERGEY_ARCHIVE_AUDIT.ru.md.

Проверка

python3 -m unittest discover -s tests -v
python3 scripts/privacy_scan.py

Responsive E2E выполняется Playwright на ширинах 1280×800 и 390×844:

npx playwright test tests/ui.e2e.spec.js --workers=1

API намеренно read-only:

curl http://127.0.0.1:8787/api/summary
curl -i -X POST http://127.0.0.1:8787/api/summary  # ожидается HTTP 405

Архитектура

Публичный разрешённый снимок ─┐
Ручная выбранная выборка ─────┼─> local SQLite -> read-only API -> evidence-first UI
Wayback/Common Crawl audit ───┘

Нет SaaS, billing, облачного хранилища или приватного Chrome-worker. Контур мониторинга прав хранит только проверяемые кандидаты и evidence; техническое совпадение не объявляется нарушением без ручной проверки.

Передача проекта

Эти два файла — рекомендуемая точка входа для Сергея или его агента. После них можно переходить к технической документации и материалам пилота.

Документы

Лицензия

MIT. Author.Today, содержимое сайта и товарные знаки принадлежат соответствующим правообладателям. Используйте проект с учётом актуальных правил платформы, приватности и разумных лимитов запросов.

About

API-first Author.Today snapshots, SQLite analytics, and reusable AI-agent workflows

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages