# Установка Mercur на Oracle VM — выполнить по SSH на своей машине

Проверено: `create-mercur-app@2.2.1` на npm, реальный пакет, MIT license (mercurjs/mercur).

## Требования (подтверждено из офиц. доков mercurjs)
- Node.js v20+ LTS
- PostgreSQL (running)
- Redis
- Git
- Yarn или Bun

## Шаг 1: базовые пакеты на свежей Oracle VM (Ubuntu)
```bash
sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs postgresql postgresql-contrib redis-server git
sudo systemctl enable postgresql redis-server
sudo systemctl start postgresql redis-server
```

## Шаг 2: создать БД под Mercur
```bash
sudo -u postgres createuser --interactive   # создать юзера mercur
sudo -u postgres createdb mercur_db -O mercur
```

## Шаг 3: установить Mercur
```bash
npx create-mercur-app@latest seed-bank-hub
cd seed-bank-hub
```
CLI спросит: имя проекта, параметры подключения к БД (используй значения из Шага 2), нужен ли Storefront (Next.js) и Vendor Panel — отвечай Yes на оба.

## Шаг 4: запуск (dev-режим для проверки)
```bash
yarn dev   # или npm run dev / bun run dev
```
- Backend API: `http://localhost:9000`
- Admin Panel: `http://localhost:7000`
- Vendor Panel: `http://localhost:7001`

## Шаг 5: production-режим
- Открыть порты 9000/7000/7001 в Oracle Security List (VCN → Security Rules)
- Поставить nginx как reverse proxy + Let's Encrypt (certbot) для HTTPS
- `pm2` или systemd unit, чтобы процесс Mercur не падал при разрыве SSH-сессии:
```bash
npm install -g pm2
pm2 start "yarn start" --name mercur-hub
pm2 save
pm2 startup   # выполнить команду, которую он выведет
```

## Дальше
После того как поднимется и будет виден Admin Panel — пишешь мне, помогу с:
- импортом каталога Oreshka через Admin API / CSV
- настройкой vendor onboarding под структуру Organization (seed bank / ботсад / питомник / магазин)
- подключением Astro-фронтенда к Mercur Store API