Разбор унаследованного кодаОбучение программированию

Разбор доставшегося старого кода с комментариями

Срок от 1 дняДоработки включеныКонтроль качества
Пакеты
Защита оплатыПодробнее
  • Доработки в рамках пакета бесплатны.
  • Если вы не ответите в течение 3 дней после сдачи, работа будет принята автоматически.
Заказать · 35 $

При оплате деньги резервируются и переходят сервису, только когда вы примете работу.

Разбор доставшегося старого кода с комментариями

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

Пример по пакету «Стандарт»

Разбор кода: скрипт на Python для загрузки заказов интернет-магазина

Что делает код

  1. Читает orders.csv из выгрузки магазина.
  2. Для каждой строки заказа ищет товар по артикулу в stock.xlsx и вычитает количество.
  3. Сохраняет остатки и пишет итоги в import_log.txt.

Логика понятная, функции названы удачно. Почти все проблемы связаны с данными, которые выглядят не так, как ожидает скрипт.

Ошибки и слабые места

№СтрокаВажностьПроблема
148ВысокаяОдин и тот же файл можно загрузить дважды: номера обработанных заказов нигде не хранятся. Скорее всего, отсюда минусовые остатки.
272Высокаяint(row["qty"]) падает на пустых значениях и на «2.0» у заказов с возвратом.
395СредняяПоиск по артикулу чувствителен к регистру: «pu-101» и «PU-101» считаются разными товарами.
4130СредняяФайл открывается без encoding="utf-8", в Windows кириллица в названиях превращается в «кракозябры».
5201НизкаяГолый except: прячет настоящие ошибки, лог ничего не объясняет.

Исправленные фрагменты

Проблема 1: не списывать заказ повторно

processed = load_processed_ids("processed_orders.txt")
for row in reader:
    if row["order_id"] in processed:
        continue
    # ... прежняя логика ...
    processed.add(row["order_id"])
save_processed_ids("processed_orders.txt", processed)

Зачем: каждый заказ списывается один раз, даже если запустить скрипт на том же файле.

Проблема 2: безопасно читать количество

raw = (row.get("qty") or "").strip()
try:
    qty = int(float(raw))
except ValueError:
    log.warning("Заказ %s: некорректное количество %r, пропущен", row["order_id"], raw)
    continue

Зачем: строка с ошибкой пропускается с записью в лог, а не останавливает весь импорт.

Проблема 3: привести артикулы к одному виду

sku = row["sku"].strip().upper()

То же .strip().upper() нужно применить при сборке словаря остатков.

Стиль и читаемость

  • Функция process() занимает 90 строк: разделите на read_orders, apply_to_stock, write_report.
  • Вместо номеров колонок (row[7]) обращайтесь по названиям заголовков.

Проверьте каждое исправление на копии файлов: код мы читали, но не запускали.

Заказчик: владелец небольшого интернет-магазина чая, сам написал скрипт на 310 строк: он берёт выгрузку заказов в CSV и списывает остатки в таблице склада Жалоба: «Иногда остатки уходят в минус, а на некоторых файлах скрипт падает».

Клиент и все данные вымышлены.

Об услуге

Когда вам достаётся код от ушедшего разработчика, сначала его нужно понять: что делает каждая часть, что от чего зависит и какие строки нельзя трогать без осторожности. Мы читаем вставленный код, простыми словами объясняем его по частям и пишем комментарии, которые можно добавить в файлы. Заодно отмечаем мёртвый код, скрытые побочные эффекты и опасные места, чтобы вы знали, где быть осторожнее перед любыми изменениями.

Что входит

  • Что вы получитеПисьменный разбор на странице заказа: карта основных функций и их связей, простые пояснения, готовые к вставке комментарии и список опасных мест с предложенными правками. В Premium ещё безопасный порядок пошаговой чистки кода.
  • Карта кодаОсновные функции и их связи
  • Простые поясненияЧасть за частью
  • Готовые комментарииДля вставки в файлы
  • Опасные местаПобочные эффекты, мёртвый код, магические числа
  • Предложенные правкиИсправленные фрагменты, где нужно

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

  1. 1
    БрифВы вставляете код и свою цель
  2. 2
    ЧтениеСоставляем карту и объясняем код
  3. 3
    РазборВы получаете пояснения и комментарии

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

Унаследованный код текстом или скриншотами, язык и версия, для чего используется система и что в ней скоро нужно поменять.

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

  • На каком языке и какой версии код?
  • Что система делает для вашего бизнеса?
  • Что нужно скоро изменить или добавить?
  • Есть документация или заметки прежнего разработчика?

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

ПакетыЭкономКод до 100 строк15 $СтандартКод до 400 строк35 $БизнесДо 1 000 строк с порядком чистки69 $
Срок1 день2 дня3 дня
Доработки123
Строк кодадо 100до 400до 1 000
Исправленные фрагментыДаДаДа
Порядок пошаговой чисткиНетНетДа
Заказать ЭкономЗаказать СтандартЗаказать Бизнес

Защита оплаты

Вы оплачиваете заказ сразу, но деньги переходят сервису только за принятую работу.

  • Фиксированная ценаЦена пакета не меняется после оплаты.
  • Деньги резервируютсяПри оплате сумма только резервируется. Сервису она переходит, когда вы примете работу.
  • Проверка перед сдачейКаждый результат проходит проверку качества, прежде чем попасть к вам, и вы видите его на странице заказа до приёмки.
  • Бесплатные доработкиПросите изменения в рамках брифа столько раз, сколько предусмотрено пакетом.
  • Приёмка через 3 дняЕсли в течение 3 дней после сдачи вы не примете работу и не попросите изменений, она будет принята автоматически. Если после сдачи вы напишете в чат заказа, заказ подождёт; ответив, мы можем начать отсчёт 3 дней заново и сообщим об этом в чате.
  • Переделка или полный возвратЕсли результат не соответствует брифу и доработки не помогли или срок превышен больше чем вдвое, напишите в чат заказа: мы переделаем работу или полностью вернём деньги.
Как это работает →

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

Вы запускаете мой код?

Нет. Мы внимательно читаем код и разбираем, как он себя ведёт, но не запускаем его, поэтому каждое исправление проверьте в своём проекте.

Можете переписать на современном языке?

Эта услуга объясняет и комментирует ваш код и предлагает правки. Полное переписывание — отдельный проект разработки.

Код очень старый. Это проблема?

Нет. Старый PHP, макросы VBA, классический ASP и подобный код — как раз то, для чего этот разбор.

Пакеты
Заказать · 35 $· 2 дня