Active CRM
Жижиг, дунд бизнесүүдэд (авто засвар, үсчин, үйлчилгээ, худалдаа) зориулсан харилцагчийн бүртгэл,
цаг захиалга, ажлын урсгалын систем. Next.js (App Router) + PostgreSQL (Supabase).
Гол боломжууд:
- QR анкет — үйлчлүүлэгч утсаараа анкет бөглөхөд утас/имэйлээр нь тулгаж харилцагчийн бүртгэлд автоматаар нэмнэ
- Файлаас оруулах — Excel (.xlsx) / CSV-ээс харилцагчдыг бөөнөөр оруулна (Өгөгдөл → Файлаас оруулах)
- Автомат сануулга — маргаашийн цаг захиалга болон удаан ирээгүй харилцагчдад SMS / имэйл (Тохиргоо → Сануулга)
- Харилцагч, цаг захиалга, ажил, үйлчилгээ, ажилчид, тайлан шинжилгээ, CSV экспорт
- Үйлдлийн түүх — харилцагч, ажил, ажилтны өөрчлөлт, өгөгдөл татсан/оруулсныг хэн, хэзээ хийснийг харуулна (Тохиргоо → Үйлдлийн түүх)
Багц ба төлбөр
- Шинэ компани 14 хоногийн туршилт (Pro-гийн бүх боломж) авна. Дараа нь Стандарт (49,000₮: 3 хэрэглэгч, 1,000 харилцагч, имэйл сануулга) эсвэл Pro (99,000₮: хязгааргүй, SMS) багц. Үнийг платформын админ өөрчилнө; багцын агуулга
src/lib/plans.ts-д.
- Хугацаа дууссан компанид зөвхөн "Багц" болон профайл хуудас нээгдэнэ (API 402); өгөгдөл устахгүй, QR анкет хадгалагдсаар (шинэ харилцагч үүсэхгүй).
- Төлбөр: банкны шилжүүлэг (гүйлгээний утгад
ACRM-XXXXXX код → платформын админ "Орлого орсон" дарна) эсвэл QPay (төлөгдөхөд автоматаар идэвхжинэ).
Эрх
| Админ | Менежер | Ажилтан |
|---|
| Ажил | ✔ бүгдийг засна | ✔ бүгдийг засна | ✔ өөрт оноогдсоныг |
| Өөрийн профайл, багцын төлөв | ✔ | ✔ | ✔ |
| Харилцагч (нэмэх, засах), цаг захиалга, тайлан | ✔ | ✔ | — |
| Харилцагч устгах, өгөгдөл экспорт/импорт | ✔ | — | — |
| Тохиргоо, ажилчид, анкет, сануулга, үйлдлийн түүх, багц төлөх | ✔ | — | — |
Эрхийн дүрэм src/lib/roles.ts-д. Эрхэд нээлттэй бус хуудсыг src/proxy.ts тухайн эрхийн нүүр хуудас руу шилжүүлнэ; API бүр эрхээ өөрөө шалгана (requireAuth({ admin: true }), requireAuth({ roles: MANAGER_ROLES })).
Локалд ажиллуулах
npm install
cp .env.example .env.local # утгуудыг бөглөнө (доорх хүснэгтийг үзнэ үү)
npm run db:migrate # мэдээллийн сангийн хүснэгтүүдийг үүсгэнэ / шинэчилнэ
npm run dev # http://localhost:3000
Локал PostgreSQL ашиглах бол: DATABASE_URL=postgres://postgres:postgres@localhost:5432/activecrm, DATABASE_SSL=false.
Мэдээллийн сан (migration)
db/migrations/ доторх SQL файлууд нэрийн дарааллаар ажиллана. npm run db:migrate нь ажилласан файлуудыг
schema_migrations хүснэгтэд тэмдэглэж, зөвхөн шинийг нь ажиллуулна (npm run db:migrate -- --list — төлөв харах).
00000000_baseline_schema.sql — анх Supabase UI-аар үүсгэсэн үндсэн хүснэгтүүд. Аппын кодонд ашиглагдаж буй
баганаас сэргээн бичсэн тул production-той зөрүү байж болзошгүй; шалгах бол
pg_dump --schema-only --no-owner "$DATABASE_URL"-ийн гаралттай харьцуулна.- Бүх migration дахин ажиллуулахад аюулгүй (
IF NOT EXISTS) тул өмнө нь гараар ажиллуулсан production DB дээр
npm run db:migrate-ийг анх удаа ажиллуулахад өөрчлөгдсөн зүйлгүй файлууд зүгээр л тэмдэглэгдэнэ.
- Шинэ кодыг deploy хийхээс өмнө migration-аа ажиллуулна.
db/scripts/ — нэг удаагийн өгөгдөл цэвэрлэх скриптүүд (migration биш, гараар ажиллуулна).
Орчны хувьсагч (.env.local)
| Хувьсагч | Тайлбар |
|---|
DATABASE_URL | PostgreSQL (Supabase) холболт |
DATABASE_SSL | Локал / CI-ийн SSL-гүй PostgreSQL-д false. Бусад үед (Supabase) SSL-ээр холбогдоно |
DB_POOL_MAX | Нэг процессын DB холболтын дээд тоо (анхдагч 5) |
SESSION_SECRET | Session JWT болон нууц үг сэргээх кодын HMAC түлхүүр (32+ тэмдэгт санамсаргүй) |
GMAIL_USER, GMAIL_APP_PASSWORD | Имэйл илгээх (Gmail SMTP, nodemailer). GMAIL_APP_PASSWORD нь Google бүртгэлийн App Password. Тохируулаагүй бол dev-д console-д хэвлэнэ |
CRON_SECRET | Өдөр бүрийн сануулгын cron (/api/cron/reminders, vercel.json)-ийг хамгаалах нууц түлхүүр. Vercel нь Authorization: Bearer <CRON_SECRET> толгойгоор дууддаг |
SMS_API_URL, SMS_API_TOKEN, SMS_SENDER | Сануулгыг SMS-ээр илгээх gateway (заавал биш). SMS_API_URL руу {"to","text","from"} JSON POST хийнэ, токеныг Authorization: Bearer-ээр илгээнэ. Gateway өөр формат шаарддаг бол src/lib/sms.ts-ийг тохируулна. Тохируулаагүй бол зөвхөн имэйлээр илгээнэ |
APP_URL | Имэйл баталгаажуулах холбоос, QPay callback-ийн үндсэн хаяг (жнь https://activecrm.mn). Хоосон бол хүсэлтийн хаягийг ашиглана |
PLATFORM_ADMIN_EMAILS | Платформын (Active CRM-ийн өөрийн) админуудын имэйл, таслалаар. Тэд профайлын цэсний "Платформ"-оос бүх компанийн багц, банкны шилжүүлэг, нүүр хуудасны контент, багцын үнийг удирдана |
QPAY_USERNAME, QPAY_PASSWORD, QPAY_INVOICE_CODE, QPAY_BASE_URL | QPay merchant тохиргоо (заавал биш). Тохируулсан үед "QPay-ээр төлөх" идэвхжинэ; QPAY_BASE_URL анхдагч https://merchant.qpay.mn (туршилтад sandbox) |
TRUSTED_PROXY_HOPS | Апп хэдэн итгэмжлэгдсэн proxy / load balancer-ийн ард ажиллаж байгаа (анхдагч 1). Rate limit-д клиентийн IP-г X-Forwarded-For-ийн баруун талаас энэ тоогоор авна, ингэснээр IP-г хуурах боломжгүй. Proxy-гүй бол 0. Vercel дээр хамаарахгүй |
Deploy (Vercel)
- Орчны хувьсагчдыг Vercel төслийн тохиргоонд оруулна.
DATABASE_URL нь Supabase-ийн transaction pooler (порт 6543).
vercel.json дахь cron өдөр бүр 01:00 UTC (Улаанбаатарын 09:00)-д /api/cron/reminders-ийг дуудна; CRON_SECRET заавал.
