Mock Data in Examples fix

[guitaroff]

No description provided.

[madmatvey]

0. Общее описание изменений

Ценность для продукта:
В примере examples/basic_usage.rb улучшена документация и форматирование данных для TRON-адресов и подписей. Теперь используются валидные TRON-адреса, добавлены пояснения по формату адресов и полей, а также уточнено, что подпись в примере — моковая. Это снижает риск ошибок у пользователей SDK и делает пример ближе к реальному использованию, повышая доверие и удобство интеграции.

Инженерный подход:
Внесены правки в комментарии и структуру примера, чтобы явно отделить демонстрационные данные от боевых, а также дать чёткие инструкции по формату адресов и необходимости замены моковых данных на реальные в production. Использованы лучшие практики по self-documented code и минимизации риска неправильного копирования примеров.

---

1. Получение изменений и область анализа

Изменённый файл:

• examples/basic_usage.rb (единственный реально изменённый файл)

Результаты тестов и линтера:

• bundle exec rake (RSpec + RuboCop):
  • 74 теста, 0 ошибок
  • RuboCop: 27 файлов, 0 offense

---

2. Критерии оценки изменений

Файл: examples/basic_usage.rb

Проектирование и архитектура:

• Изменения касаются только примера, не затрагивают архитектуру SDK.
• Пример стал более модульным: чётко отделены mock-данные, добавлены пояснения по форматам.

Сложность и сопровождение:

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

Работоспособность и корректность:

• Используются валидные TRON-адреса (начинаются с 'T', 34 символа, base58).
• Моковая подпись явно помечена как не для production.
• Нет изменений, влияющих на обработку ошибок или идемпотентность.

Читаемость и нейминг:

• Комментарии стали более подробными и полезными.
• Пояснены форматы адресов и полей.
• Названия переменных и структура кода остались интуитивно понятными.

Лучшие практики:

• Следование принципу "документируй, почему, а не только что".
• Явное отделение демонстрационных данных от production.

Тестирование:

• Пример не требует тестов, но вся основная логика SDK покрыта тестами (см. вывод RSpec).

Стиль и стандарты:

• Нет новых предупреждений RuboCop.
• Отступы, порядок кода и стиль соответствуют гайдлайнам.

Документация:

• README и CHANGELOG уже содержат актуальные сведения о форматах адресов и использовании SDK.
• В самом примере добавлены исчерпывающие комментарии.

Безопасность:

• Нет работы с секретами или пользовательскими данными в изменённых строках.
• Моковые подписи явно отделены от production.

Производительность:

• Не затрагивается.

Наблюдаемость:

• Не затрагивается.

Доступность и интернационализация:

• Не затрагивается.

CI/CD и DevOps:

• Пайплайн надёжен, тесты и линтер проходят.

AI-помощь:

• Нет признаков некачественной автогенерации или скрытых зависимостей.

---

3. Сообщение об ошибках (nested bullets)

Нет критичных или даже минорных проблем в изменённых строках.

---

Prioritized Issues

Critical

Нет

Major

Нет

Minor

Нет

Enhancement

Нет

---

5. Положительные моменты

• Улучшена документация и читаемость примера.
• Явно отделены демонстрационные и production-данные.
• Пример стал более безопасным для копирования и использования новичками.
• Все тесты и линтер проходят без ошибок.

Рекомендация:
PR можно смело мержить. Улучшения делают пример более полезным и безопасным для пользователей SDK.