Files
anthropic-code-agent[bot]andArtemFilin1990 0a42fa910c Fix incomplete script path corrections across repository
- Updated all CI/CD workflow files (.github/workflows/) to use tools/scripts/ paths
- Updated CONTRIBUTING.md and all documentation in docs/ directory
- Updated data/inbox/inbox/ documentation files
- Updated tools/scripts/generate_sources_table.py self-references
- Fixed pr-checks.yml linting paths (black, ruff, mypy, coverage)
- All validations passing with new paths

Co-authored-by: ArtemFilin1990 <221041513+ArtemFilin1990@users.noreply.github.com>
2026-02-05 21:17:37 +00:00

2.5 KiB

Contributing to BearingsInfo

Спасибо за интерес к проекту BearingsInfo! Мы приветствуем вклад в развитие базы данных подшипников.

Как внести вклад

Добавление информации о подшипниках

  1. Форкните репозиторий
  2. Создайте новую ветку (git checkout -b feature/bearing-data)
  3. Добавьте данные в соответствующие файлы в data/ или документацию в docs/bearings/
  4. Убедитесь, что данные содержат ссылки на источники (ГОСТ, ISO, DIN, каталоги производителей)
  5. Запустите валидацию: python tools/scripts/validate/run_validations.py
  6. Закоммитьте изменения (git commit -m 'Add: данные по подшипнику XXX')
  7. Запушьте ветку (git push origin feature/bearing-data)
  8. Откройте Pull Request

Требования к данным

  • Все технические данные должны содержать ссылки на официальные источники
  • CSV файлы должны быть в UTF-8 кодировке
  • Названия и обозначения должны соответствовать стандартам (ГОСТ, ISO, DIN)
  • Избегайте дублирования записей

Структура репозитория

  • data/ — CSV файлы с данными подшипников
  • docs/bearings/ — документация по классификации, стандартам, аналогам
  • sources/ — скрипты для парсинга источников данных
  • tools/scripts/ — утилиты для валидации и обработки данных

Запуск тестов

python -m pip install -r requirements.txt
python tools/scripts/deduplicate_nomenclature.py
python tools/scripts/update_repo.py --no-report
python tools/scripts/validate/run_validations.py
pytest -v

Стиль кода

  • Python: PEP 8
  • Markdown: используйте заголовки, списки, таблицы для структурирования
  • CSV: разделитель — запятая, кодировка UTF-8

Вопросы

Если у вас есть вопросы, создайте Issue в репозитории.