Files
kadastr-nalog/README.md
2026-06-01 17:04:41 +05:00

61 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ФИАС — поиск адресов и выгрузка выписок ГАР
Программа по списку кадастровых номеров (Excel) ищет объекты на
[fias.nalog.ru](https://fias.nalog.ru/Search/Extended), скачивает выписки ГАР (PDF)
и собирает результаты в таблицу.
## Для конечного пользователя
Нужно установить **только одно**:
- **КриптоПро ЭЦП Browser plug-in** + КриптоПро CSP — сайт ФИАС без них не работает.
Скачать: <https://www.cryptopro.ru/products/cades/plugin/>
Firefox, geckodriver и расширение КриптоПро для браузера **уже встроены** в `ФИАС_поиск.exe`
ставить и настраивать их не нужно.
Дальше:
1. Запустить `ФИАС_поиск.exe`.
2. Выбрать Excel со списком КН (нужна колонка «КН» или «Кадастровый номер»).
3. Выбрать папку для результатов и нажать «Запустить».
Результаты (таблица + PDF + журнал) складываются в подпапку с датой и временем запуска.
## Для сборки (разработчику)
Чтобы `.exe` был самодостаточным, перед сборкой надо один раз скачать
портативный Firefox и geckodriver в папку `vendor/`:
```bash
# нужен 7-Zip для распаковки Firefox:
# Linux: sudo apt install p7zip-full
# Windows: установить 7-Zip и добавить 7z в PATH
python fetch_vendor.py # win64 (по умолчанию)
# python fetch_vendor.py --arch win32 # для 32-битного Windows
```
После этого:
```bash
# На Windows (32-bit Python 3.8 для win32 .exe):
pip install -r requirements.txt
python build.py
# Либо кросс-сборка на Linux через wine:
./build_wine.sh
```
Готовый `dist/ФИАС_поиск.exe` уже содержит Firefox + geckodriver + расширение КриптоПро.
### Что во что встраивается
| Компонент | Источник | Где в сборке |
|---|---|---|
| Расширение КриптоПро (XPI) | `extensions/` (в репозитории) | внутри .exe |
| Портативный Firefox | `vendor/firefox/` (`fetch_vendor.py`) | внутри .exe |
| geckodriver | `vendor/geckodriver.exe` (`fetch_vendor.py`) | внутри .exe |
| КриптоПро CSP + нативный plug-in | ставит пользователь | — |
Папка `vendor/` в git не хранится (большие бинарники) — её наполняет `fetch_vendor.py`.
Если собрать без неё, программа попробует системный Firefox и скачает geckodriver из интернета.