# HardwareFullReport — полное описание продукта

## Назначение

HardwareFullReport — небольшая настольная утилита для Windows, написанная на
PowerShell 5.1. Она определяет основные комплектующие компьютера, формирует
локальный отчёт и создаёт поисковые ссылки Авито и Яндекс Маркета для ручного сравнения
актуальных объявлений.

Программа предназначена для владельцев домашних компьютеров, системных
администраторов, мастеров по ремонту и продавцов бывшей в употреблении
техники, которым нужно быстро:

- понять, какие основные комплектующие установлены в компьютере;
- получить перечень моделей и характеристик;
- подготовить данные для объявления;
- сравнить предложения по таким же или похожим компонентам;
- оценить разумный стартовый диапазон цены вручную.

## Что анализируется

Текущая публичная редакция получает через CIM/WMI Windows:

- производителя и модель готового компьютера или ноутбука;
- материнскую плату;
- процессор, количество ядер и логических потоков;
- модули оперативной памяти, ёмкость и частоту;
- видеокарты и доступные сведения о видеопамяти;
- физические накопители, объём, тип носителя и интерфейс.

Серийные номера в публичный отчёт намеренно не включаются.

## Что создаётся

После сканирования появляется отдельная папка:

```text
HardwareFullReport_ГГГГ-ММ-ДД_ЧЧ-мм-сс
```

В ней находятся:

- `hardware_report.html` — основной визуальный отчёт;
- `hardware_inventory.csv` — таблица для Excel и других программ;
- `hardware_inventory.json` — структурированные данные;
- `README_REPORT.txt` — краткое пояснение состава отчёта.

## Как работает оценка

HardwareFullReport не подключается к закрытому API Авито, не собирает
завершённые сделки и не обещает точную рыночную стоимость.

Вместо этого программа:

1. определяет модель комплектующей;
2. формирует поисковый запрос;
3. учитывает выбранный регион в адресе поиска;
4. добавляет ссылку в отчёт и таблицу;
5. позволяет открыть один запрос или все запросы сразу.

Пользователь самостоятельно сравнивает объявления с учётом:

- точной модели и ревизии;
- состояния;
- комплектности;
- гарантии;
- возраста;
- региона;
- стоимости доставки;
- длительности размещения объявления.

## Конфиденциальность

Сканирование и формирование файлов выполняются локально. Сведения о
компьютере не отправляются на WinsTeleCom.

Сетевой доступ появляется только после нажатия ссылки Авито: браузер
открывает обычную поисковую страницу.

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

## Системные требования

- Windows 10 или Windows 11;
- Windows PowerShell 5.1;
- включённая служба WMI/CIM;
- доступ к браузеру для открытия ссылок Авито;
- права администратора не обязательны, но могут увеличить полноту некоторых
  системных сведений.

## Формат распространения

Утилита публикуется с исходным кодом:

```text
HardwareFullReport.ps1
```

Установка не требуется. Сторонние PowerShell-модули не используются.

## Контроль качества версии 1.1.1

Встроенный параметр `-SelfTest` проверяет создание ссылок для выбранного,
неизвестного и другого региона. Полная сборка KeeneticDesktop запускает
эту проверку автоматически.


## Источники сравнения

- Авито — сравнение объявлений, преимущественно подержанного оборудования;
- Яндекс Маркет — сравнение предложений новых товаров;
- поисковая фраза выводится в таблице и может быть проверена пользователем.