Сайт IT/ Digital агентства

SpaceMod

Цифровой контур бизнеса: лендинги услуг, SEO/GEO, инструменты, админка лидов и клиентский кабинет CRM на Next.js + MongoDB.

Навигация · Возможности · Админка · Стек · Установка · Env · Структура · Деплой · Git · Docs

Возможности

Модули кода

Заявки с форм: POST /api/submit-form → MongoDB (spacemod_ru_leads) + Telegram. Отправка в Bitrix отключена.

Админка /admin

Вход: пароль из ADMIN_PASSWORD (без дефолта в коде). Сессия в sessionStorage.

Клиентский кабинет (/cabinet): дашборд, чат, задачи, счета, загрузка платёжек. Файлы — локально в CRM_FILES_DIR (не Vercel Blob).

Tech stack

Версия пакета: 0.1.0 (package.json).

Prerequisites

• Node.js 18+ (рекомендуется 20/22)
• pnpm 8+
• MongoDB 7 (локально или Docker)
• Git + SSH-доступ к remote

Clone / доступ

git clone git@gitverse.ru:spacemod/spacemod.ru.git
cd spacemod.ru

Доступ к remote выдаёт владелец репозитория out-of-band.

Local development

pnpm install
cp .env.example .env.local
# заполните MONGODB_URI, ADMIN_PASSWORD, TELEGRAM_* и при необходимости SMTP

MongoDB (рекомендуется Docker)

docker run -d --name spacemod-mongo \
  -p 27017:27017 \
  mongo:7

В .env.local:

MONGODB_URI=mongodb://127.0.0.1:27017/spacemod_ai?directConnection=true
MONGODB_DB=spacemod_ai

Cloud Atlas / managed DB — только если владелец явно выдал URI. Не коммитьте credentials.

Dev server

pnpm dev
# http://localhost:3000

Production-сборка локально:

pnpm build && pnpm start

Каталог загрузок CRM создаётся автоматически (storage/crm или CRM_FILES_DIR).

Environment variables

Источник правды: .env.example.

Required

Recommended (кабинет / CRM)

Optional

Секреты передаются разработчикам только out-of-band, не через git.

Project structure

app/                 # Next.js App Router (site, admin, cabinet, api)
components/          # UI, лендинги v4, формы
modules/             # admin, cabinet, crm, cases, yandex-direct
lib/                 # mongodb, telegram, seo, mail helpers
public/              # статика
scripts/             # утилиты (+ scripts/scratch)
docs/                # документация и рабочие артефакты
ecosystem.config.js  # PM2
.env.example         # шаблон env (tracked)

Вложенный каталог landingSpacemod/ — legacy-лендинг; основной продукт — корневое Next.js-приложение. Не трогать без задачи.

Common scripts

Диагностика форм (scratch):

node scripts/scratch/test-form-deps.mjs

Production deploy

Целевая схема: VPS + Nginx reverse proxy → Next.js на порту 3000 → PM2.

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

1. Env только в .env.local на сервере (не в git).
2. После деплоя: pnpm install → pnpm build → pm2 restart <app> --update-env.
3. Файлы CRM: каталог CRM_FILES_DIR с правами записи у пользователя PM2.
4. Не использовать git push --force в master / develop.

Краткий цикл на сервере (путь адаптируйте под хост):

cd /var/www/spacemod.ru
# синхронизация кода (rsync / git pull — по договорённости с владельцем)
pnpm install
pnpm build
pm2 restart spacemod-ru --update-env

Подробные runbook-и и nginx — в docs/ops/.

PM2: ecosystem.config.js (PORT=3000).

Git workflow

Ветки:

Правила:

1. Не коммитить напрямую в master / develop.
2. Порядок: feature/<name> → merge --no-ff в develop → merge --no-ff в master.
3. Conventional commits: feat|fix|docs|refactor|chore(scope): …
4. Не коммитить .env, .env.local, секреты, storage/.

Если ветки develop ещё нет — создать от master перед первой feature-веткой (делает владелец / агент по запросу «запуши»).

Troubleshooting

Security for external developers

• Не коммитьте секреты; используйте .env.example только как шаблон.
• Секреты (Mongo, Telegram, SMTP, Admin, Kie.ai) — ротация перед выдачей доступа, если они когда-либо светились в истории/чатах.
• Admin auth — shared password header; не храните его в клиентских репозиториях.
• landingSpacemod/ и legacy-скрипты в docs/ / scripts/scratch/ не считать SoT по безопасности.

Чеклист владельца: ротация ключей, выдача env out-of-band, SSH-доступ к remote.

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

Индекс: docs/README.md

License / contacts

Private repository. Публичная площадка: spacemod.ru.
Поддержка продукта: support@spacemod.ru (операционный контакт, не git-хостинг).