VIBIX store
ВойтиРегистрация
EducationПремиум

Магнитный двигатель Куценкова

Исследовательский 3D-симулятор конусного ротора с магнитами: момент, потери и энергобаланс без «вечного двигателя».

~20 минСреднийREADME
Next.jsTypeScriptThree.jsReact Three FiberTailwindVitestpnpm
Читать инструкцию Master Prompt

Ценность

Вайбкодинг

40 ч

Строк кода

3 300+

Аналог у студии

от 180 000 ₽

Экономия на токенах

≈ 45 000 ₽

Инструкция из репозитория

Магнитный двигатель Куценкова

Исследовательский 3D-симулятор конусного ротора с магнитами, механизмом погружения, генератором и нагрузкой. Физика считает момент, потери и энергобаланс; UI не утверждает «вечный двигатель».

Версия0.1.0 (package.json)
СтекNext.js 15 · React 19 · Three.js · React Three Fiber · Tailwind CSS 4 · TypeScript · Vitest
Пакетный менеджерpnpm
Порт (dev / prod)3000
Инфраструктуране требуется (без БД / Redis / S3)
Админканет

Оглавление

  1. Возможности и модули
  2. Tech stack
  3. Prerequisites
  4. Clone / доступ
  5. Local development
  6. Environment variables
  7. Структура проекта
  8. Scripts
  9. Production
  10. Git workflow
  11. Troubleshooting
  12. Security для внешних разработчиков
  13. Документация

Возможности и модули

Единственная продуктовая поверхность — страница / с симулятором.

СлойПутьНазначение
Entrysrc/app/page.tsxРендер SimulatorShell
UIsrc/modules/magnetic-cone-motor/ui/Панели: управление, телеметрия, энергобаланс, профили, стенд
Scenesrc/modules/magnetic-cone-motor/scene/R3F: конус, статоры, погружение, генератор, рама, кожух
Physicssrc/modules/magnetic-cone-motor/physics/Момент, engagement, энергия, симулятор (чистый TS)
Profilessrc/modules/magnetic-cone-motor/profiles/Конфиги current / universal / extreme
Audiosrc/modules/magnetic-cone-motor/audio/Звук стенда (Web Audio)
Module docssrc/modules/magnetic-cone-motor/docs/BOM, сборка, геометрия, безопасность, CAD ТЗ, аудиты

Физика: без внешнего момента ротор останавливается. Fallback-данные вместо расчёта не используются.

Tech stack

ТехнологияВерсия (из package.json)
Next.js^15.5.2
React / React DOM^19.1.1
three^0.185.1
@react-three/fiber^9.6.1
@react-three/drei^10.7.7
Tailwind CSS^4.1.12
TypeScript^5.9.2
Vitest^4.1.10

Prerequisites

  • Node.js 22+ (проверено на v22)
  • pnpm 10+
  • SSH-доступ к remote (выдаёт администратор репозитория)

Clone / доступ

git clone git@gitverse.ru:spacemod/magnetic-kutsenkov.git
cd magnetic-kutsenkov

Публичные web-URL git-хостинга в документации не публикуются. Доступ — только по приглашению владельца.

Local development

pnpm install
cp .env.example .env.local   # опционально; сейчас env не читается кодом
pnpm dev

Откройте http://localhost:3000.

Альтернативы
  • Сборка production-локально: pnpm build && pnpm start
  • Тесты: pnpm test / pnpm test:watch
  • Линт: pnpm lint

Инфраструктура Docker (Mongo/Redis и т.п.) не нужна — приложение клиентское + Next.js server без внешних сервисов.

Environment variables

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

КатегорияПеременныеСтатус
Required—нет обязательных
Recommended—нет
Production-onlyplaceholders в .env.exampleзаготовка под будущий деплой

Секреты и токены администратор выдаёт out-of-band, не через git.

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

.
├── README.md
├── .env.example
├── package.json
├── next.config.ts
├── vitest.config.ts
├── docs/                          # проектная документация
│   ├── README.md
│   ├── setup/
│   ├── git/
│   ├── ops/
│   ├── product/
│   ├── plans/
│   ├── security/
│   └── …
├── src/
│   ├── app/                       # Next.js App Router
│   └── modules/
│       └── magnetic-cone-motor/   # основной модуль + docs модуля
└── …

Документация кода модуля живёт в src/modules/magnetic-cone-motor/docs/ (не дублировать в корень).

Scripts

КомандаНазначение
pnpm devDev-сервер (Turbopack), порт 3000
pnpm buildProduction build
pnpm startЗапуск production-сборки
pnpm lintESLint
pnpm testVitest (однократно)
pnpm test:watchVitest watch

Git-helper скриптов (git:start и т.п.) в репозитории нет — обычный git.

Production

В репозитории нет Dockerfile / docker-compose / Vercel config / PM2.

Рекомендуемый минимальный путь:

pnpm install --frozen-lockfile
pnpm build
pnpm start

Порт по умолчанию: 3000 (или PORT окружения хоста, если настроен на стороне платформы).

Операционный runbook: docs/ops/deploy.md

Git workflow

Ветки: master (prod) · develop (integration) · feature/*

feature/<short-name>  →  develop  →  master

Прямые коммиты в master / develop запрещены. Подробности: docs/git/workflow.md.

Troubleshooting

ПроблемаЧто проверить
pnpm: command not foundУстановить pnpm (corepack enable / официальный installer)
Пустая / чёрная 3D-сценаWebGL в браузере; обновить GPU-драйверы; попробовать Chrome/Firefox
Ошибки Three / R3F после installrm -rf node_modules .next && pnpm install
Тесты падаютpnpm test из корня; Node 22+

Security для внешних разработчиков

  1. Не коммитьте .env, .env.local, бэкапы *.bak.
  2. Не вставляйте реальные ключи/токены в код, docs или .env.example.
  3. Секреты (если появятся) — только out-of-band от администратора.
  4. Перед выдачей доступа владельцу: сверить docs/security/hardening.md.

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

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

РазделСсылка
Design specdocs/product/2026-07-19-magnetic-cone-motor-design.md
Implementation plandocs/plans/2026-07-19-magnetic-cone-motor.md
Модуль: READMEsrc/modules/magnetic-cone-motor/README.md
Модуль: BOM / сборка / safetysrc/modules/magnetic-cone-motor/docs/

License / contacts

Репозиторий private. Доступ и условия использования — у владельца проекта.

Master Prompt

Скопируйте в Cursor / Claude Code. Каждый copy даёт новый токен; предыдущий действует ещё 48 часов.

v1.0.0

Master Prompt в Премиум

Скопируйте один prompt в Cursor, Claude Code или Codex — и соберите приложение end-to-end. Внутри — персональный доступ к приватному репозиторию.

Смотреть тарифы

Оплата после выбора тарифа — затем вход или регистрация.

Changelog

  • v1.0.0 · 2026-07-19

    Каталожный релиз «Магнитный двигатель Куценкова» с private repo placeholders.

Docs Prompt