Карта файлов проекта
English · Справочник · Установка
Где что лежит. Документ для того, кто будет сопровождать проект: пользователю он не нужен.
Рабочие папки (input, output, logs, report, release, workspace, runtime, wheelhouse) описаны по роли, а не пофайлово — их содержимое порождается прогонами и пересобирается.
Корень
| Файл | Что это |
|---|
Start.exe | Скомпилированный запуск окна: открывает App\AudionAddressProcessor.exe |
address_cli.cmd | Консольная команда: те же операции без окна; на ней стоит само окно |
builder_main.cmd | Сборка portable-окружения |
cleanup_project.cmd | Очистка наработанных артефактов |
pytest.ini | Настройки тестов |
release_manifest.json | Манифест последней сборки релиза |
README.md | Публичное описание проекта |
CMD-файлы должны оставаться UTF-8 без BOM с переносами CRLF. После правки — install\Check-CmdEncoding.cmd.
App и Source — окно
| Путь | Что это |
|---|
Source/ | Исходники окна: Avalonia 12 / .NET 10. Core/ — запуск команды, манифест, значения полей, журнал, настройки; Views/ — форма, панели, диалоги; MainWindow.*.cs — разделы, рабочая зона, запуск, ОКТМО; Ps/ — исходник собственного PowerShell программы; Tools/ — значки и проверка без мыши |
Source/config/i18n.json | Английские пары всех русских текстов окна |
App/ | Собранное окно (AudionAddressProcessor.exe) и свой PowerShell AudionPs.exe для сценариев сборки; собирается install\Build-App.cmd, в выпуск едет готовым |
config — настройки
| Файл | Что это |
|---|
project.yaml | Настройки движка: город, эталонная колонка, целевые колонки, связанные колонки, ограничения безопасности |
window_layout.yaml | Раскладка окна: разделы, операции в них, кнопки рабочей зоны и панели результата, значки |
tool_manifest.yaml | Описание всех операций и полей окна; из него строится интерфейс |
version.json | Версия и язык корневого README |
path_history.json | История и закрепления путей источника и назначения |
window_settings.json | Настройки окна: размер, язык, тема, шрифт (создаёт само окно) |
oktmo_current_keys.txt | Текущие ключи поиска ОКТМО |
oktmo_region_pins.json | Закреплённые регионы |
oktmo_municipality_pins.json | Закреплённые муниципалитеты |
oktmo_pins_bundle.json | Общий набор пинов |
system_core — код
Верхний уровень
| Файл | Что делает |
|---|
Ultimate_GT_Aligner.py | Движок сопоставления: разбор адреса, проходы, перенос связанных колонок |
safe_table_join.py | Сравнение двух книг и перенос колонок через Excel |
excel_layout.py | Оформление книг результата: ширина колонок, перенос текста, заливка |
remove_empty_rows.py | Удаление полностью пустых строк |
Parser_Diagnostic.py | Диагностика разбора адреса |
inspect_md_tables.py | Разбор таблиц в Markdown |
doctor.py | Проверка окружения и импортов |
main.py | Прямой запуск сопоставления без окна |
cli.py | Консольная команда: describe, run, options, oktmo, serve, stop-office, version |
office_session.py | Учёт своих Excel и Word операции, чтобы остановка закрывала только их |
address_engine — адресный движок
| Файл | Что делает |
|---|
audion_address_core.py | Разбор адреса на составляющие, распознавание адресоподобного текста |
address_slots.py | Слоты: определение, заполнение, сборка адресной строки |
slot_fill.py | Заполнение слотов из свидетельств |
models.py | Структуры данных: наблюдение, составляющие адреса, отпечаток, кластер |
source_intake.py | Чтение источников всех поддерживаемых форматов |
source_table_assembly.py | Сбор адресов из источников в книгу |
source_cleanup.py | Отсев временных файлов Office |
reference_builder.py | Построение эталонного справочника, определение слотов и колонок |
reference_processor.py | Сортировка и разложение справочника по слотам |
oktmo_lookup.py | Индекс ОКТМО, дисковый кэш, поиск региона, МО и населённого пункта |
oktmo_user_keys.py | Файл ключей проекта и пины |
rosstat_update.py | Скачивание и обновление реестра Росстата |
region_reference.py | Справочник регионов |
russian_morphology.py | Падежные формы названий |
universal_address.py | Общий нормализатор адреса |
normalizer_runtime.py | Настройка нормализатора под прогон |
address_diagnostics.py | Диагностические выборки |
legacy_office_converter.py | Конвертация DOC/XLS |
services — сервисный слой
address_aligner_service.py — единственный файл. Каждая команда окна ссылается на функцию отсюда: сервис принимает параметры, вызывает движок, пишет журнал, отчёт и список артефактов.
core — ядро
| Файл | Что делает |
|---|
jobs.py | Запуск операций, отмена, прогресс, живая строка хода |
operation_model.py | Правила, по которым собираются параметры запуска: умолчания, условия показа полей, порядок слотов; манифест в виде для окна |
window_layout.py | Чтение window_layout.yaml и проверка, что каждая операция стоит в окне |
manifest.py | Разбор tool_manifest.yaml |
paths.py | Управляемые папки проекта |
config.py | Чтение настроек |
ansi_terminal.py | Очистка вывода программ от управляющих кодов цвета |
cmd_encoding.py | Проверка кодировок CMD |
output_decode.py | Декодирование вывода подпроцессов |
logging_utils.py | Журналирование |
Прочее
| Путь | Что это |
|---|
icons/ | Значок программы |
start_launcher/ | Исходник Start.exe |
install — установка и сборка
| Файл | Что делает |
|---|
Build_Portable_Env.cmd / .ps1 | Сборка portable-окружения |
install_portable_offline.cmd | Установка из локального wheelhouse |
verify_portable_env.cmd | Проверка собранного окружения |
init_folders.cmd | Создание рабочих папок |
Check-CmdEncoding.cmd | Проверка кодировок CMD |
Clean-Install-Cache.cmd / .ps1 | Очистка кэша сборки |
Update-Requirements-Lock.cmd | Обновление lock-файла зависимостей |
Build-StartLauncher.cmd / .ps1 | Сборка Start.exe |
Build-App.cmd | Сборка окна App\ из Source\ |
requirements_full.in | Список зависимостей |
README_INSTALL.md | Заметки по установке |
data — данные
| Путь | Что это |
|---|
regions_reference.yaml | Справочник регионов |
rosstat/data-*.csv | Реестр ОКТМО, скачивается кнопкой в окне |
rosstat/oktmo_lookup_cache.json | Разобранный индекс ОКТМО |
docs — документация
| Файл | Что это |
|---|
README_RU.md, README_EN.md | Описание проекта, точка входа |
USER_GUIDE_RU.md, USER_GUIDE_EN.md | Руководство пользователя |
OKTMO_RU.md, OKTMO_EN.md | Реестр ОКТМО, ключи и пины |
REFERENCE_RU.md, REFERENCE_EN.md | Технический справочник |
INSTALL_RU.md, INSTALL_EN.md | Установка и запуск |
tools/PROJECT_FILES_GUIDE_*.md | Этот документ |
tools/WINDOW_INVENTORY.md | Опись прежнего окна (NiceGUI) и сверка с новым: что где закрыто |
PDF/ | Отрендеренные PDF всех документов в двух темах |
PDF собираются отдельным инструментом из всех .md в docs, включая вложенные папки. Структура папок сохраняется.
tests — тесты
| Файл | Что проверяет |
|---|
test_address_aligner_regression.py | Проходы сопоставления |
test_safe_table_join.py | Перенос колонок по адресу |
test_excel_layout.py | Оформление книг результата |
test_console_output.py | Очистка вывода от кодов цвета, кодировки вывода подпроцессов |
test_cli_door.py | Консольная команда: параметры запуска те же, что у прежнего окна, остановка, Excel и Word |
test_window_avalonia.py | Окно и команда читают одни и те же ключи; английские пары; самопроверка собранного окна |
former_window_parameters.json | Параметры 14 операций, снятые с прежнего окна 11.10.2026: по ним проверяется команда |
Окно проверяется не страницей в браузере, а самим собой: App\AudionAddressProcessor.exe --self-check строит все разделы и сверяет их с манифестом.
licenses — лицензии
Тексты лицензий сторонних компонентов, THIRD_PARTY_NOTICES.txt, COMPONENTS.json, отчёт сканирования и манифест пакета. Собираются инструментом Audion Build Licenses по готовому составу проекта, руками не правятся.