spacemod.io - Модульная платформа для селлеров на Wildberries, умные поставки

Spacemod

Платформа автоматизации и аналитики для продавцов Wildberries: мониторинг и бронирование слотов поставок, умное снабжение, CRM, AI-агенты и биллинг подписок.

Версия: 1.0.18 · Package manager: pnpm · Runtime: Next.js App Router

Оглавление

• Возможности
• Админ-панель
• Стек
• Требования
• Доступ к репозиторию
• Локальная разработка
• Переменные окружения
• Структура проекта
• Скрипты
• Production deploy
• Git workflow
• Troubleshooting
• Безопасность для внешних разработчиков
• Документация

Возможности

Каталог модулей продукта (синхронизирован с runtime-каталогом в MongoDB).

Основные (core)

Аналитика

AI / ML

Мониторинг и промо

Инструменты

Прочие поверхности продукта

Админ-панель

Маршрут: /admin.

Стек

Требования

• Node.js 20+ (LTS)
• pnpm 10+
• MongoDB 7+ (локально или Docker) — работа без БД не поддерживается
• Redis 7+ (очереди и кэш)
• Опционально: Docker Desktop для Mongo/Redis

Доступ к репозиторию

Клонирование по SSH (URL выдаёт владелец репозитория out-of-band):

git clone <SSH_CLONE_URL>
cd app.spacemod.io

Публичные web-URL git-хостинга в этой документации намеренно не указываются.

Локальная разработка

1. Зависимости

pnpm install

2. Окружение

cp .env.example .env.local

Заполните Required-переменные. Секреты платежей / OAuth / AI / host API — только от администратора, не из git.

3. Инфраструктура (рекомендуется Docker)

# Пример: локальный MongoDB
docker run -d --name spacemod-mongo -p 27017:27017 mongo:7

# Пример: локальный Redis
docker run -d --name spacemod-redis -p 6379:6379 redis:7

В .env.local:

MONGODB_URI=mongodb://127.0.0.1:27017/spacemod
REDIS_URL=redis://127.0.0.1:6379

Cloud Atlas / managed DB — не основной путь онбординга, если владелец явно не указал иное.

4. Dev-сервер

# Порт 3001 (типичный локальный / server-compatible)
pnpm dev:web

# Или порт 3000 + монитор
pnpm dev

Откройте http://localhost:3001 (или :3000 для pnpm dev).

5. Workers (по необходимости)

pnpm pm2:dev
# или точечно:
pnpm dev:bg-updater

Админ-доступ настраивается через переменные окружения и роль пользователя в БД — не через пароли в коде.

Переменные окружения

Полный шаблон: .env.example (source of truth).

Правила:

• не коммитить .env, .env.local, .env.production
• shop_id / токены / APP_ID выдаёт администратор out-of-band
• не публиковать секреты в NEXT_PUBLIC_*

Структура проекта

src/
├── app/                 # Next.js App Router (pages + api)
│   ├── admin/           # Админ-панель
│   ├── modules/         # Модули продукта
│   ├── api/             # Route handlers
│   └── (public)/        # Публичные страницы
├── components/          # UI и feature-компоненты
├── contexts/            # React contexts
├── hooks/
├── lib/                 # Утилиты (mongodb, pricing, auth helpers)
├── models/              # Mongoose models (также models/ в корне)
├── services/            # Бизнес-логика
└── utils/
harvester/               # Сбор данных WB
ecosystem.config.cjs     # PM2 production (читает process.env)
docs/                    # Документация и спецификации
scripts/                 # Операционные скрипты

Скрипты

Полный список — в package.json → scripts.

Production deploy

Архитектура (актуальная для host-деплоя Spacemod):

• Node-приложение под PM2 (ecosystem.config.cjs), порт приложения обычно 3001
• nginx (TLS) → reverse proxy на app
• MongoDB + Redis на доступном хосте (URI только из env)
• Фоновые процессы: telegram-bot, background-updater, harvester / workers

Критичные правила:

1. MONGODB_URI / секреты — только в EnvironmentFile / .env на сервере, не в git.
2. ecosystem.config.cjs читает process.env.MONGODB_URI — не хардкодить credentials.
3. После смены env: pm2 reload / restart соответствующего unit.
4. Не деплоить с mock/fallback данными вместо реальной БД.

Runbook и чеклисты: docs/ops/, docs/deploy/.

Git workflow

Фактические ветки репозитория (см. .gitflow):

Правила:

1. Не коммитить напрямую в main / develop.
2. Feature создаётся от develop.
3. Вливание: feature → develop → main (merge --no-ff по согласованию с владельцем).
4. Conventional commits: feat|fix|docs|refactor|chore|test|style(scope): …
5. Не использовать git add . вслепую; не коммитить .env*.

На remote также может существовать ветка master (архив/legacy). Канон для prod — main.

Troubleshooting

Безопасность для внешних разработчиков

• Секреты только в локальном .env.local / серверном .env.
• Не коммитить дампы БД, dump.rdb, .tmp/, логи.
• Не вставлять реальные shop_id, JWT, URI с паролем в issue/PR/docs.
• Host API tokens / APP_ID — выдаёт администратор out-of-band.
• Если вы получили доступ к репозиторию: предполагайте, что старые секреты из истории могли утечь — используйте только новые credentials, выданные владельцем.

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

Контакты

• Поддержка продукта: support@spacemod.io

© Spacemod. Внутренняя документация для разработчиков с доступом к приватному репозиторию.