🔮 Arcanum - Матрица Судьбы

Web-приложение для нумерологического анализа личности на основе методики Натальи Ладини

📋 О проекте

Arcanum — это современное web-приложение (PWA) для расчета и анализа:

🌟 Матрица Судьбы (22 аркана Таро)
🔢 Психоматрица Пифагора (квадрат 3x3)
💑 Совместимость пар (расширенный алгоритм)
👶 Роль ребенка в роду (кармические задачи)

🛠️ Технологический стек

Frontend

React 18.2+ с TypeScript 5.x
Vite 6.x — быстрая сборка
Tailwind CSS 4.x — стилизация
Zustand — state management
React Router 6 — маршрутизация
React Hook Form + Zod — формы и валидация

Backend ✅

Golang 1.21+ — основной язык
Gin — веб-фреймворк
PostgreSQL 15+ — основная БД
Redis 7+ — кэш и rate limiting
JWT — аутентификация

DevOps

Turborepo — управление monorepo
Docker Compose — локальная разработка
GitHub Actions — CI/CD
Vercel — хостинг frontend

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

arcanum/
├── apps/
│   ├── web/              # React приложение (frontend) ✅
│   └── api/              # Golang backend API ✅
│       ├── cmd/server/   # Точка входа
│       ├── internal/     # Внутренние пакеты
│       │   ├── config/   # Конфигурация
│       │   ├── database/ # PostgreSQL & Redis
│       │   ├── handlers/ # HTTP handlers
│       │   ├── middleware/ # Auth, CORS, rate limiting
│       │   ├── models/   # Модели данных
│       │   └── services/ # Бизнес-логика
│       └── migrations/   # SQL миграции
├── packages/
│   └── shared/           # Общие типы и утилиты (планируется)
├── docs/                 # Техническая документация
│   ├── TZ_MatrixSudby_Web_v6.0.md
│   └── APPENDIX_C_Full_Interpretations.md
├── docker-compose.yml    # PostgreSQL + Redis для разработки
├── package.json          # Root package.json (monorepo)
├── turbo.json            # Turborepo конфигурация
└── README.md

🚀 Быстрый старт

Требования

Node.js >= 18.0.0
npm >= 9.0.0
Go >= 1.21 (для backend)
Docker + Docker Compose (для БД)

Установка

# Клонировать репозиторий
git clone https://github.com/akhludeyev/arcanum_web.git
cd arcanum_web

# Установить зависимости
npm install

Запуск Frontend

# Запустить dev сервер
npm run dev

Приложение откроется на http://localhost:5173

Запуск Backend

# 1. Запустить PostgreSQL и Redis
docker-compose up -d postgres redis

# 2. Применить миграции
psql postgresql://arcanum_user:arcanum_password@localhost:5432/arcanum_db \
  -f apps/api/migrations/001_initial_schema.sql

# 3. Запустить API сервер
cd apps/api
cp .env.example .env
go run cmd/server/main.go

API будет доступен на http://localhost:3001

📦 Доступные команды

Monorepo (Root)

npm run dev      # Запустить все dev серверы
npm run build    # Собрать все приложения
npm run lint     # Проверить код линтером
npm run test     # Запустить тесты
npm run clean    # Очистить build артефакты

Frontend (apps/web)

cd apps/web
npm run dev      # Vite dev сервер
npm run build    # Production build
npm run preview  # Предпросмотр build

Backend (apps/api)

cd apps/api
go run cmd/server/main.go  # Запустить сервер
go test ./...              # Запустить тесты
go build -o server cmd/server/main.go  # Собрать бинарник

Docker

docker-compose up -d          # Запустить все сервисы
docker-compose up -d postgres # Только PostgreSQL
docker-compose up -d redis    # Только Redis
docker-compose down           # Остановить все

🎯 Roadmap

✅ Этап 1: Инфраструктура

Настройка monorepo (Turborepo)
Инициализация React проекта
Настройка Tailwind CSS 4.x
Настройка ESLint + TypeScript
Деплой на Vercel

✅ Этап 2: Frontend MVP

Дизайн-система (компоненты UI)
Калькулятор Матрицы Судьбы
Психоматрица Пифагора
Визуализация (диаграммы)
Адаптивная верстка (mobile-first)
Страницы: Landing, Dashboard, Compatibility, Child Role, Subscription

✅ Этап 3: Backend MVP (Golang)

REST API (Golang + Gin)
PostgreSQL 15 + Redis 7
JWT аутентификация (middleware)
Сервисы расчетов:
- Матрица Судьбы
- Психоматрица Пифагора
- Совместимость пар
Docker Compose для разработки
Rate limiting и CORS

✅ Этап 4: Backend Integration

Auth API (регистрация, вход, выход, обновление токена)
User API (профиль, настройки)
Сохранение расчетов в БД
Интеграция frontend с backend API
Axios клиент и interceptors

⏳ Этап 5: Новые функции v6.1 (Backend) ✅

Роль Администратора: Управление пользователями, настройки системы (Backend ✅)
Реферальная программа: Генерация кодов, начисления, выплаты (Backend ✅)
Личный кабинет: Профиль, настройки уведомлений, безопасность (Backend ✅)
Сохранение расчетов: История, избранное, экспорт (Backend ✅)

⏳ Этап 6: Новые функции v6.1 (Frontend)

Админ-панель: Dashboard, управление пользователями, настройки
Личный кабинет: UI профиля, загрузка аватара, настройки
Реферальная программа: Статистика, реферальные ссылки, вывод средств
Сохраненные расчеты: Интерфейс списка и просмотра

⏳ Этап 7: Платежная система (Финальный этап)

Backend: Сервис платежей, Webhooks (Stripe/ЮKassa)
Frontend: Страницы оплаты, управление подпиской
Интеграция: Автоматическое продление, реферальные начисления

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

Техническая документация

Backend API

API README - Полная документация backend

API Endpoints

Public endpoints:

GET /health - Health check
POST /api/v1/calculate/matrix - Расчет Матрицы Судьбы
POST /api/v1/calculate/pythagoras - Расчет Психоматрицы Пифагора
POST /api/v1/auth/register - Регистрация
POST /api/v1/auth/login - Вход
POST /api/v1/auth/refresh - Обновление токена

Premium/Protected endpoints (требуется JWT):

POST /api/v1/calculate/compatibility - Совместимость пар
GET /api/v1/users/me - Профиль пользователя
PUT /api/v1/users/me - Обновление профиля
POST /api/v1/calculations - Сохранить расчет
GET /api/v1/calculations - Получить список расчетов

Admin endpoints (требуется роль Admin):

GET /api/v1/admin/users - Список пользователей
GET /api/v1/admin/referral/settings/global - Глобальные настройки реферальной программы
GET /api/v1/admin/referral/withdrawals - Запросы на выплату

🤝 Вклад в проект

Проект находится в активной разработке. Если вы хотите внести вклад:

Fork репозитория
Создайте feature branch (git checkout -b feature/amazing-feature)
Commit изменения (git commit -m 'Add amazing feature')
Push в branch (git push origin feature/amazing-feature)
Откройте Pull Request

📄 Лицензия

Этот проект лицензирован под MIT License - см. файл LICENSE

👤 Автор

akhludeyev

GitHub: @akhludeyev

🙏 Благодарности

Методика Натальи Ладини — основа расчетов Матрицы Судьбы
22 аркана Таро — символическая система
Пифагор — основатель нумерологии

🔧 Технологии и инструменты

Golang - Backend язык программирования
Gin - HTTP веб-фреймворк
PostgreSQL - Реляционная база данных
Redis - In-memory хранилище
React - UI библиотека
Vite - Frontend build tool
Tailwind CSS - CSS фреймворк
Docker - Контейнеризация

⭐ Если проект вам понравился, поставьте звезду!

Name		Name	Last commit message	Last commit date
.turbo/daemon		.turbo/daemon
apps		apps
docs		docs
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
create_test_users.ps1		create_test_users.ps1
docker-compose.yml		docker-compose.yml
package-lock.json		package-lock.json
package.json		package.json
turbo.json		turbo.json
vercel.json		vercel.json

Latest commit

History

Folders and files

Repository files navigation