Name: nuar-crm
Author: wolterGray

Imported from wolterGray/nuar-crm (AGENTS.md). Install upstream with npx skills add wolterGray/nuar-crm. Copyright stays with the author.

NUAR CRM — контекст для ИИ

Полное описание троицы (CRM + админка + сайт) — в соседнем репозитории:
../lavandi/AGENTS.md (или wolterGray/lavandi/AGENTS.md на GitHub).
Читай тот файл первым, если задача затрагивает сайт или CMS.

Что это

nuar-crm — внутренняя CRM салона NUAR (Варшава): клиенты, визиты, услуги, сотрудники, статистика, задачи.


Репозиторий	`wolterGray/nuar-crm`
Стек	React 19 + Vite, Node/Express API, Prisma + PostgreSQL
Деплой	Hetzner VPS: frontend + backend + PostgreSQL

Связь с сайтом и админкой

CRM работает через собственный backend на Hetzner. Сайт и CMS могут использовать общие таблицы сайта в PostgreSQL:

Компонент	Репо	URL
CRM	`nuar-crm`	Hetzner / `crm.nuarr.pl`
Сайт + админка	`lavandi`	https://nuarr.pl, https://nuarr.pl/admin

CRM → сайт (автоматически)

При изменении цен и длительностей услуг в CRM данные пишутся backend-роутами сайта в site_content (id = 'main', поле data.services)
Frontend не ходит напрямую в CMS-базу: синхронизация идёт через backend на Hetzner.
Задержка ~1.2 с, без кнопок «опубликовать»
Админка сайта не редактирует цены — только фото и тексты услуг

CRM → админка (SSO)

Страница «Сайт» (src/components/pages/SitePage.jsx)
Кнопка «Открыть админку» открывает админку сайта через текущий CRM auth-flow. Старый frontend SSO не возвращать без явной задачи.

Backend / база

Основной runtime:

backend/ — Node/Express API
backend/prisma/schema.prisma — PostgreSQL-модель CRM
backend/.env — секреты Hetzner (DATABASE_URL, JWT, SMS/Telegram/Gmail токены)
VITE_BACKEND_URL — frontend → backend

Общие таблицы сайта:

site_content — JSON CMS сайта (CRM пишет только services.price/time)
site_images — бинарные картинки CMS (dbimg:<id>)

Frontend не использует старый прямой SDK базы и не должен получать legacy VITE_* ключи. Новые интеграции и синхронизации веди через backend.

Структура кода

src/
  App.jsx                         # Главное приложение, роутинг через activePage
  components/pages/SitePage.jsx   # Раздел «Сайт»
  utils/openSiteAdmin.js          # Открытие админки сайта
  data/siteServicesCatalog.js     # Каталог услуг сайта для маппинга имён CRM ↔ сайт
backend/
  server.js                       # Express API
  prisma/schema.prisma            # PostgreSQL schema
  routes/                         # CRM/site/automation endpoints

Имена услуг CRM маппятся на slug сайта через backend site/CMS routes.

Два типа изменений

Тип	Пример	Нужен push?
Данные CRM (визиты, клиенты)	Работа в CRM UI	Нет (живёт в PostgreSQL на Hetzner)
Цены услуг	Изменение в каталоге CRM	Нет (backend автообновляет `site_content`)
Код CRM	Новая страница, логика	Да → push → Hetzner deploy
Контент сайта (тексты, фото)	—	Не в этом репо → `lavandi` админка

Команды

npm run dev
npm run build
npm run lint

Backend:

cd backend
npm run dev
npm run start
npm run prisma:generate

Для ИИ: частые задачи

Цены на сайте не совпадают → проверь backend site/CMS routes, маппинг имён услуг и site_content.data.services
Автоматизация шлёт ошибки → проверь настройки включения SMS/Telegram/Gmail и backend cron/PM2 на Hetzner
Админка просит пароль → проверь текущий auth-flow сайта в lavandi
Фича на сайте/в CMS → работай в репозитории lavandi, не здесь
Commit + push — пользователь обычно ожидает после изменений кода

Подробности деплоя, косметики, палитры, маршрутов — в lavandi/AGENTS.md.

Install nuar-crm and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "woltergray-nuar-crm-nuar-crm", "kind": "skill", "name": "nuar-crm", "description": "CRM работает через собственный backend на Hetzner. Сайт и CMS могут использовать общие таблицы сайта в PostgreSQL:", "publisher": "wolterGray", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "CRM работает через собственный backend на Hetzner. Сайт и CMS могут использовать общие таблицы сайта в PostgreSQL:" ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/wolterGray/nuar-crm", "path": "AGENTS.md", "ref": "e7739dccf9e35c6a13cfc54f6507982125dad1d5", "url": "https://github.com/wolterGray/nuar-crm/blob/e7739dccf9e35c6a13cfc54f6507982125dad1d5/AGENTS.md", "key": "wolterGray/nuar-crm/AGENTS.md" } }, "instructions": "# NUAR CRM — контекст для ИИ\n\n> **Полное описание троицы (CRM + админка + сайт)** — в соседнем репозитории: \n> `../lavandi/AGENTS.md` (или `wolterGray/lavandi/AGENTS.md` на GitHub). \n> **Читай тот файл первым**, если задача затрагивает сайт или CMS.\n\n---\n\n## Что это\n\n**nuar-crm** — внутренняя CRM салона NUAR (Варшава): клиенты, визиты, услуги, сотрудники, статистика, задачи.\n\n| | |\n|---|---|\n| Репозиторий | `wolterGray/nuar-crm` |\n| Стек | React 19 + Vite, Node/Express API, Prisma + PostgreSQL |\n| Деплой | Hetzner VPS: frontend + backend + PostgreSQL |\n\n---\n\n## Связь с сайтом и админкой\n\nCRM", "cost": { "context_tokens": 932 } }

nuar-crm

About