карьерчик.ПРОЕКТНАЯ ДОКУМЕНТАЦИЯ / V1.0.0 / 16 ОКТЯБРЯ 2026
ЕДИНАЯ ТОЧКА ВХОДА

Материалы, с которых
начинается проект.

«Карьерчик» — портал продажи нерудных материалов для частных клиентов, подрядчиков и снабженцев. Версия v1 объединяет каталог, предварительный расчёт логистики и сохранение заявки на локальном сервере.

Статус: локальный функциональный MVP. Каталог, калькулятор и заявки реализованы. Цены, плотности и тарифы — демонстрационные; реальных поставщиков и остатков нет. До публичного запуска необходимы решения из раздела приёмки.

4конкурента изучены
8материалов в каталоге
5вариантов получения
7операций API

Анализ рынка

Источники, наблюдения, сравнительная матрица и решения для общего портала.

Открыть анализ →

Бизнес-аналитика

Цели, сегменты, процессы, роли, правила, требования и показатели.

Открыть требования →

Системная аналитика

Архитектура, модель данных, контракты API, расчёт и эксплуатация.

Открыть спецификацию →

Что получает пользователь

Каталог и поиск→Выбор материала→Расчёт поставки→Заявка и секретный код

Принятые допущения

ВопросРешение v1Что подтвердить владельцу
ГеографияМосква и Московская область, до 100 км от МКАДЦелевые регионы и точки отгрузки
Бизнес-модельЕдиный продавец / оператор, без кабинетов поставщиковЮрлицо, поставщики, экономика и ответственность
АссортиментПесок, щебень, грунт, смеси и вторичный материалПрайс, плотности, фракции, паспорта партий
СделкаЗаявка без оплаты и бронированияПорядок подтверждения цены, договора и оплаты
НалогиНе рассчитываются отдельно; суммы тестовыеРежим налогообложения и правила отображения
ХранениеJSON-файл, один экземпляр APIПереход на PostgreSQL до публичной эксплуатации

Состав поставки

v1/
├─ backend/Karerchik.Api/    C# / ASP.NET Core 10
├─ frontend/                Next.js 16 / React 19 / TypeScript
│  └─ public/docs/          Копия HTML-документации для портала
├─ docs/                    Автономная HTML-документация
├─ tools/                   Генераторы оригинальных SVG и HTML
├─ scripts/                 Запуск и остановка Windows
├─ tests/                   Интеграционные проверки API
├─ README.md                Инструкция запуска
├─ CHANGELOG.md             История релиза
└─ VERSION                  1.0.0

Версии развиваются в соседних папках v1, v2 и далее. Исходный v1 сохраняется как базовая версия. Git-история и тег v1.0.0 дополняют папочное версионирование.

Приёмка

Сценарии проверки, ограничения, риски, план развития и вопросы владельцу →