# ФИАС — поиск адресов и выгрузка выписок ГАР

Программа по списку кадастровых номеров (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 из интернета.