· 5 min read
Что проверять, когда телефонная библиотека отклоняет новый диапазон номеров
Изучите контекст страны, установленные метаданные и официальные свидетельства нумерации, прежде чем отклонять спорный номер клиента.
Относитесь к предполагаемому отклонению нового диапазона как к расследованию. Воспроизведите результат с точным вводом и контекстом страны, сравните развернутую библиотеку с актуальными метаданными и найдите авторитетные подтверждения для диапазона, прежде чем принимать решение по записи.
Зафиксируйте отклонение до изменения номера
Клиент утверждает, что его номер указан верно, но ваш импорт отклоняет его. Неоднократное удаление первой цифры до тех пор, пока валидатор что-то не примет, — опасный способ исправления: новое значение может указывать на совершенно другой номер. Начните с сохранения исходных введенных данных и того точного значения, которое поступило в библиотеку.
Зафиксируйте страну по умолчанию, переданную для парсинга, результирующий телефонный код страны в случае успешного парсинга и операцию валидации, завершившуюся ошибкой. Отличайте ошибку парсинга от несоответствия возможной длине и от недействительности диапазона. Номер без контекста страны сам по себе еще не служит свидетельством нового плана нумерации.
Воспроизведите этот случай вне окружающей логики формы, используя тот же развернутый пакет и метаданные. Это покажет, вызвано ли отклонение библиотекой или дополнительным правилом приложения. Маска на стороне фронтенда, кэшированное регулярное выражение или ограничение по странам на стороне сервера могут отклонить ввод, даже если телефонная библиотека его принимает.
Проверьте, какая версия фактически запущена
Определите разрешенную версию зависимости в развернутом приложении, а не просто читайте диапазон версий в файле манифеста пакета. Если приложение собирает телефонные метаданные отдельно, зафиксируйте и этот ресурс. Компьютер разработчика может выдавать результат, отличный от развернутой сборки, которая все еще содержит более старый билд.
Повторите тот же ввод и контекст страны на текущей поддерживаемой версии в изолированном тесте. Сопоставьте оба результата. Если более новая версия принимает диапазон, изучите соответствующий релиз или изменение метаданных перед планированием обновления. Прогоните через обновление и репрезентативные существующие номера, особенно по странам, ключевым для вашей клиентской базы.
Если обе версии отклоняют номер, одно лишь обновление не решило вопрос. Переходите к поиску свидетельств распределения нумерации. Не отключайте проверку валидности глобально только потому, что один клиент сообщил о действительном номере: такое изменение затронет каждую последующую отправку данных, включая действительно некорректные.
Найдите подтверждения, относящиеся именно к этому диапазону
В FAQ по Google libphonenumber действительный диапазон описывается как диапазон, для которого достаточная официальная документация указывает на возможность назначения номеров. Там также объясняется, что изменения метаданных могут отставать от фактического ввода диапазона в эксплуатацию. Это повод расследовать причину отклонения, а не повод считать любой незнакомый префикс заведомо новым и действительным.
Найдите план нумерации соответствующего национального телекоммуникационного регулятора или официальное уведомление о выделении ресурса. Сопоставьте телефонный код страны, длину национального номера и границы префиксов. Проверьте дату вступления в силу: объявление о будущем диапазоне не подтверждает, что он уже доступен для выделения.
Официальное уведомление оператора может добавить контекст, если национальный план неполон. Сохраните исходный URL, дату документа и фрагмент, подтверждающий диапазон, в своих рабочих заметках по расследованию. Сообщение на форуме или другой сайт, принимающий этот ввод, могут подсказать направление, но они не заменяют таких свидетельств. Историческая копия FAQ по нумерации объясняет общую суть проблемы, однако не может подтвердить текущее выделение.
Выберите точечные меры на основе найденных свидетельств
Когда текущие метаданные принимают номер, а более старые развернутые метаданные отклоняют его, протестируйте и выпустите поддерживаемое обновление через стандартный процесс развертывания. Сохраните проблемный номер как регрессионный тест, чтобы то же самое отклонение незаметно не вернулось при последующем обновлении сборки.
Если вступившее в силу официальное выделение отсутствует в актуальных метаданных, подготовьте лаконичный отчет разработчикам апстрима с воспроизводимым вводом, контекстом страны и авторитетным источником. Удалите из отчета персональные данные клиента. Избегайте публикации полных контактных записей клиентов, когда проблему можно объяснить допустимым тестовым примером или описанием диапазона.
В своих внутренних рабочих процессах поместите затронутые записи в очередь спорных диапазонов вместо того, чтобы удалять их или негласно объявлять действительными. Любое временное исключение должно быть ограничено подтвержденным диапазоном и конкретным бизнес-решением. Например, разрешение пользователю сохранить контактную запись вовсе не означает автоматического согласия на запуск любых действий, зависящих от телефона. Зафиксируйте срок повторного рассмотрения исключения после обновления метаданных.
Добавляйте отдельную проверку только для того вопроса, на который она отвечает
Расследование плана нумерации и результаты массовой проверки — это разные наблюдения. Валидация номера телефона от CheckNumber предоставляет документированный сигнал валидности для поддерживаемых списков. Другие продукты каталога отвечают на иные вопросы, например о наличии регистрации на указанной платформе. Выбирайте продукт в соответствии с тем решением, которое предстоит принять вашей команде.
Подготовьте утвержденных кандидатов в формате CSV или TXT: одна страна на файл и один номер на строку, включая код страны. Уточните текущее покрытие стран для выбранного продукта. Сохраняйте неразрешенные исходные входные данные в собственной таблице аудита, чтобы последующий экспорт можно было сопоставить с результатами расследования, а не перезаписывать его заметки.
Положительный результат проверки не устанавливает факт владения и не компенсирует отсутствие официальной записи о выделении диапазона. Точно так же отклонение библиотекой не должно аннулировать отдельное наблюдение без дополнительного анализа. Сохраняйте источник и время каждого вывода, а затем принимайте решение: может ли запись клиента быть обработана дальше, требует ли она исправления или остается на удержании.
Начните с воспроизводимого отклонения и установленной версии. Как только вопрос с диапазоном прояснится, используйте наш проверщик номеров телефонов для последующей задачи пакетной проверки поддерживаемых списков. Это сохранит полезное различие между исправлением вашего правила валидации и анализом базы контактов.