Repo Health

Рейтинг здоровья открытых репозиториев

Оценка от 0 до 100 по данным SourceCraft.

4 категории из 6, пересчёт раз в сутки. Как считается

  1. 13456–16244ringov/turtle-rules
    25

    What are rules for the turtle in the CTF?

    400 дней назад0лайков
  2. 13456–16244ritter-vitor/gg
    25

    18.03

    244 дня назад0лайков
  3. 25

    Лендинг IT-стартапа для демонстрации SourceCraft Sites

    250 дней назад0лайков
  4. 13456–16244robomarvel/blocks
    25

    Blockly programming

    440 дней назад0лайков
  5. 25

    yandexrobotics preview repo

    177 дней назад0лайков
  6. 25

    160 дней назад0лайков
  7. 25

    364 дня назад0лайков
  8. 25

    340 дней назад0лайков
  9. 25

    Мини-игра «Угадай число» на HTML, CSS, JavaScript

    CSS52 дня назад0лайков
  10. 25

    Лендинг для ИТ-стартапа

    HTML52 дня назад0лайков
  11. 25

    273 дня назад0лайков
  12. 13456–16244rogoveo/tree
    25

    342 дня назад0лайков
  13. 25

    338 дней назад0лайков
  14. 25

    336 дней назад0лайков
  15. 25

    JavaScript530 дней назад0лайков
  16. 13456–16244roman-lab/roman-lab
    25

    Лаборатория кода: учебные проекты, автоматизация рутины, учебные материалы по программированию и наброски на Python

    133 дня назад0лайков
  17. 25

    340 дней назад0лайков
  18. 25

    Тестовый репозиторий

    HTML261 день назад0лайков
  19. 13456–16244romaobraztzov/safe
    25

    /

    400 дней назад0лайков
  20. 13456–16244romm1-rut/vpochte
    25

    Тестовый+репозиторий

    143 дня назад0лайков
  21. 25

    339 дней назад0лайков
  22. 13456–16244rossomaaha/cherep
    25

    Тестовый репозиторий

    HTML325 дней назад0лайков
  23. 25

    298 дней назад0лайков
  24. 13456–16244roz4lina1/first-rep
    25

    for cpp

    285 дней назад0лайков
  25. 25

    1. Структура репозитория Рекомендуемая структура папок: text Переносить Свернуть Копировать /src /core /calculator # чистая логика расчётов (без UI и API) - calculate.ts - types.ts - utils.ts /api - handler.ts # основной хендлер (FastAPI/Express/etc.) - routes.ts # роуты - validators.ts # валидация запросов /catalog - sync.ts # импорт/синхронизация каталога (CSV/API) - search.ts # поиск и фильтрация /tests - calculator.spec.ts - api.spec.ts /docs - architecture.md - api-spec.md - data-model.md /data - sample-catalog.json - sample-catalog.csv /scripts - sync-catalog.sh # скрипт синхронизации /docker - Dockerfile - docker-compose.yml .gitignore README.md package.json / pyproject.toml 2. Стек технологий (рекомендуемый) Язык: TypeScript (Node.js) или Python (FastAPI) — выбрать один. HTTP: Express (TS) или FastAPI (Py). Валидация: Zod (TS) / Pydantic (Py). Тестирование: Vitest (TS) / pytest (Py), плюс unit-тесты для формул. CI/CD: встроенный в SourceCraft пайплайн (lint → test → build → deploy). Контейнеризация: Docker. Хранение данных каталога: локальный JSON/SQLite для MVP; в будущем — внешняя БД. 3. Требования к функционалу 3.1. Ядро калькулятора (src/core/calculator) Должны быть чистые функции без побочных эффектов: calculateRoomMetrics(room) → периметр, площадь стен, площадь проёмов, полезная площадь. calculatePatternLength(height, rapport) → длина полотна с учётом раппорта. calculateRollsNeeded(params) → количество полотен, рулонов, стоимость, запас. Все расчёты должны быть детерминированными и покрытыми тестами. 3.2. API (src/api) Эндпоинты: POST /api/calculate — принимает параметры комнаты и рулона, возвращает расчёт. GET /api/catalog — список товаров с фильтрами (ширина, раппорт, цена, наличие). POST /api/sync-catalog — загрузка каталога из CSV/JSON или триггер синхронизации. Валидация входных данных обязательна (диапазоны, типы, обязательность полей). 3.3. Каталог (src/catalog) Поддержка двух режимов: Импорт из файла: CSV/JSON с жёсткой схемой (см. ниже). Синхронизация: скрипт, который обновляет локальные данные из внешнего источника. Поиск и фильтрация по: ширине рулона, раппорту, цене, наличию, коллекции, цвету (текстовый поиск). 4. Модель данных каталога (JSON-пример) json Переносить Свернуть Копировать [ { "article": "OB-12345", "name": "Обои Коллекция Весна", "collection": "Весна 2026", "roll_width_m": 1.06, "roll_length_m": 10, "rapport_m": 0.64, "price_rub": 2500, "stock_qty": 42, "join_type": "смещённая", "color": "бежевый", "material": "флизелин" } ] Для CSV — строго фиксированные заголовки колонок, совпадающие с JSON-ключами. 5. Формулы и правила расчёта (для реализации в коде) Периметр: P=2⋅(длина+ширина). Площадь стен: S стен ​ =P⋅высота. Площадь проёмов: S проёмов ​ =∑(ширина⋅высота) по всем окнам и дверям. Полезная площадь: S полезная ​ =S стен ​ −S проёмов ​ . Длина полотна: L полотно ​ =высота+(раппорт⋅n), где n — минимальное целое, при котором стык совпадает. Количество полотен: N полотен ​ =⌈S полезная ​ /(L полотно ​ ⋅ширина)⌉. Количество рулонов: N рулонов ​ =⌈(N полотен ​ ⋅L полотно ​ ⋅ширина)/(ширина⋅длина)⌉, округление вверх. Стоимость: Стоимость=N рулонов ​ ⋅цена. Запас: коэффициент (по умолчанию 1.10, диапазон 1.05–1.20). Округления выполнять через Math.ceil (или аналог) и проверять на граничных значениях. 6. Требования к качеству и тестированию Все формулы вынести в отдельные функции и покрыть юнит‑тестами. Добавить негативные тесты: отрицательные значения, нули, слишком большие числа. Для API — тесты валидации и проверки кодов ответов. В CI SourceCraft: lint → unit-тесты → сборка образа → (опционально) интеграционные тесты. Примеры тестовых кейсов: Комната 4×5 м, высота 2.7 м, 1 окно 1.5×1.2 м, 1 дверь 0.9×2.1 м. Рулон 1.06×10 м, раппорт 0.64 м, цена 2500 руб. Ожидаемый результат: количество рулонов и стоимость (с запасом 10 %).

    114 дней назад0лайков
Показать ещё 0

15 576–15 600 из 21 899

Выбрано 3 из 3