Complete stage 0 source research

2026-09-02 19:52:32 +07:00
commit a6f91a1329
9 changed files with 1096 additions and 0 deletions
@@ -0,0 +1,25 @@
+# RF4 Spotter
+
+RF4 Spotter — неофициальный сервис свежих точек и статистики клёва для Russian Fishing 4. Сейчас в репозитории выполнен только этап 0: исследование публичного источника официальных рекордов. Сайт и продуктовый backend ещё не создавались.
+
+## Исследовательский парсер
+
+Требуется Python 3.11+ и `beautifulsoup4`:
+
+```bash
+python -m pip install -e .
+python -m rf4_research.records \
+  --url https://rf4game.de/records/region/RU/ \
+  --region RU \
+  --category records
+```
+
+Команда делает один HTTP-запрос и печатает типизированные записи в JSON. Это исследовательский адаптер, а не готовый импортёр: в нём пока нет повторов, кэша, транзакций и дедупликации.
+
+## Проверка
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+Подтверждённая структура источника, ограничения и риски описаны в [docs/data-sources.md](docs/data-sources.md).