Загружайте филиалы сначала в отдельный проверяемый набор. Сопоставьте записи по постоянному ID, проверьте координаты и покажите отчёт изменений до переключения карты. Если импорт обрывается на середине, опубликованный набор должен остаться целым. Построчная замена действующих меток делает временную ошибку видимой посетителям.
Начните с согласования значения отсутствующей строки. Полный снимок справочника и файл изменений — разные форматы: в первом отсутствие филиала может означать закрытие, во втором оно ничего не означает. Не удаляйте действующие офисы только потому, что очередной файл оказался неполным.
Как выглядит договор на входной файл
| Поле | Правило проверки | Почему нужно |
|---|---|---|
| branch_id | Непустой уникальный ID | Связь с предыдущей версией |
| latitude / longitude | Числа и согласованный порядок | Правильная точка |
| address | Публичный адрес с проверенным входом | Сверка метки человеком |
| active | Явное состояние | Отличие закрытия от пропуска |
Переименование офиса не должно создавать новый ID. Не используйте номер строки: после сортировки он укажет на другой филиал. Если исходная система не выдаёт ключ, создайте таблицу соответствий и поддерживайте её отдельно. Совпадение координат само по себе не доказывает дубль — два подразделения могут работать в одном здании.
Одна точка, два порядка координат
В GeoJSON первые два числа позиции идут в порядке долгота, широта по RFC 7946. А отдельные API карт могут принимать другой порядок. Преобразование должно происходить в одном явно названном месте. Проверка диапазонов выявит часть ошибок, но перестановка двух допустимых значений может пройти её; дополнительно сверяйте точку с адресом на предварительной карте.
{
"type": "Feature",
"id": "demo-branch-a",
"geometry": {
"type": "Point",
"coordinates": [30.0, 60.0]
},
"properties": {"name": "Условный филиал"}
}Это демонстрационные координаты, не адрес настоящего офиса. Строки с пустой геометрией выделяйте в отчёте, а не переносите в нулевую точку. Если координаты получают геокодированием, сохраняйте статус проверки адреса: результат поиска по названию улицы ещё не подтверждает вход в нужное здание. Спорные адреса должен подтвердить ответственный за справочник.
Пробный прогон должен объяснять изменения
- Проверить структуру и обязательные поля без записи в рабочий набор.
- Посчитать новые, изменённые, неизменные и отклонённые ID.
- Отдельно вывести исчезнувшие ID для полного снимка.
- Сверить несколько перемещённых точек по адресам.
- Одобрить версию только после устранения блокирующих ошибок.
Счётчики должны сходиться с числом входных записей по заранее описанным категориям. Два одинаковых ID внутри файла — конфликт, который нельзя молча решить правилом «последняя строка победила». Повторная загрузка идентичного снимка не создаёт новые филиалы. Отчёт хранит номер версии и причину отклонения, без служебных секретов исходной системы.
Переключение и обратный путь
После проверки переключите указатель опубликованной версии как одну согласованную операцию. Способ зависит от хранилища; этот принцип не означает, что любой набор файлов можно заменить транзакцией базы. Запретите параллельным заданиям публиковать более старый снимок поверх нового и храните последнюю одобренную версию для возврата.
На тестовой карте сравните количество офисов в списке и уникальных ID в данных, откройте карточки новых и перемещённых точек. Прервите импорт до переключения: карта должна продолжить показывать прошлый набор. Затем повторите тот же файл и убедитесь, что появились только ожидаемые изменения, без новых дублей.
Для подготовки импорта достаточно обезличенного образца файла, описания ID и решения о полном снимке или изменениях. Добавьте перечень спорных адресов и критерий отклонения пакета. На этой основе можно сделать загрузку проверяемой и восстановимой, не используя посетителей сайта как тестировщиков нового справочника.