Скрипт на Python, который приведёт в порядок вашу базу контактов: единый вид имён, телефонов и почты и никаких дублей

Пример результата

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Папка: sales/2026-10, найдено файлов: 9
2026-11-02 09:14:03 INFO  shop-01.csv: 1284 строки
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 строк
2026-11-02 09:14:04 WARN  shop-07.csv: пропущены 3 строки без цены (строки 88, 412, 913)
2026-11-02 09:14:05 INFO  Готово: 10 412 строк -> report-2026-10.xlsx (листы «Продажи» и «Итоги»)

[columns]
date = Дата, Дата продажи, День
product = Товар, Наименование, Название
quantity = Кол-во, Количество, Шт
price = Цена, Цена за шт

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Читает файл одного магазина и даёт столбцам названия из отчёта."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: нет столбца «{name}» (искали: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Об услуге

База контактов, собранная за годы из магазина, CRM и таблиц, в итоге содержит одного человека трижды, телефоны, записанные пятью способами, и адреса с пробелами или опечатками. Этот скрипт на Python чистит вашу собственную базу на вашем компьютере: убирает лишние пробелы, исправляет заглавные буквы, приводит телефоны к одному формату, отмечает адреса с ошибкой в записи и находит дубли по почте или телефону, а потом сохраняет чистый файл и отдельный файл с тем, что убрал, чтобы вы могли проверить. Пришлите несколько строк с выдуманными именами, телефонами и адресами, похожими на ваши, и свои правила. Сама база к нам не попадает, и скрипт ничего никуда не отправляет. Он проверяет вид адреса, а не то, существует ли ящик.

Что входит

• Что вы получитеАрхив ZIP со скриптом на Python, README с пошаговой инструкцией и, начиная со «Стандарта», файл настроек с правилами чистки; код также виден на странице заказа.
• Поиск дублейПо почте, телефону или по тому и другому, как решите
• Один формат телефоновС кодом страны, который вы задали для номеров без него
• Убранное сохраняетсяОтдельный файл со всеми убранными и объединёнными строками
• Остаётся на вашем компьютереБаза никуда не загружается и не отправляется
• Понятный кодС комментариями, правило легко поменять потом

Порядок работы

1. 1
   ПравилаВы присылаете выдуманные строки-примеры и правила для дублей
2. 2
   КодМы пишем скрипт и инструкцию по запуску
3. 3
   ПроверкаВы запускаете его на копии базы и просматриваете убранные строки
4. 4
   ПравкиВы просите правки в рамках пакета и присылаете текст ошибки, если она есть

Что нужно от вас

Названия столбцов вашей базы и 10-20 строк с выдуманными именами, телефонами и адресами, записанными так же, как в настоящих данных (с теми же ошибками). Ваши правила: что считать дублем, какую строку оставлять (самую новую, самую полную), код страны для местных номеров и как писать телефоны. CSV или Excel и ваша система: Windows, macOS или Linux. Настоящую базу не присылайте.

В брифе мы спросим:

• Откуда эта база?
• Что считать дублем?
• Какую строку оставлять?
• Как писать телефоны?

Сравнение пакетов

Вопросы и ответы

Не нашли ответ? Спросите