Initial commit: Mana Collection NestJS backend.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-07 20:49:55 +03:30
commit fe78a99b78
87 changed files with 10557 additions and 0 deletions
@@ -0,0 +1,61 @@
+# Mana Collection API
+
+NestJS 11 + Prisma 6 + PostgreSQL multi-seller marketplace backend for **Mana Collection**.
+
+- Public site: https://manacollections.ir  
+- API prefix: `/api/v1`  
+- Default port: `3002`  
+- Postgres Docker port: `5436`  
+- S3 prefix: `mana-collection/`  
+- SMS domain: `manacollections.ir`
+
+## Quick start
+
+```bash
+cp .env.example .env
+# fill JWT secrets, S3 keys, MESHKEE_SMS_API_KEY
+
+npm install
+npm run db:up
+npx prisma migrate deploy
+npx prisma generate
+
+npm run seed:mana-store -- --phone 09120000000 --password mana1234
+# optional super admin:
+# npm run seed:mana-store -- --phone 09120000000 --password mana1234 --super-phone 09127004945 --super-password admin1234
+
+npm run start:dev
+```
+
+API: http://localhost:3002/api/v1
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `npm run db:up` | Start Postgres (port 5436) |
+| `npm run prisma:migrate` | Dev migrations |
+| `npm run prisma:deploy` | Apply migrations |
+| `npm run create-super-admin` | Create `SUPER_ADMIN` |
+| `npm run seed:mana-store` | Seed Mana Collection store + `STORE_ADMIN` |
+| `npm run send-sms` | Send Meshkee SMS |
+
+## Roles
+
+- `CUSTOMER` — public registration
+- `STORE_ADMIN` — owns one store; full catalog CRUD only when store is `active`
+- `SUPER_ADMIN` — approve stores, all orders, all customers
+
+## Key routes
+
+- Auth: `POST /auth/login`, `/auth/register/*`, `/auth/refresh`, `GET /auth/me`
+- Store register: `POST /public/stores/register/send-code`, `/verify`
+- Store me: `GET|PATCH /stores/me`
+- Admin stores: `GET /admin/stores`, `PATCH /admin/stores/:id/status`
+- Products / categories / brands / blogs / customers / orders (JWT + role)
+- Public: `GET /public/products`, `/public/products/:id`, `/public/stores`, `/public/blogs`
+- Profile: `GET|PATCH /profile`, addresses CRUD
+- Catalog: `GET /catalog` (colors / sizes / packages)
+- Media: `POST /media/upload?kind=main|gallery|blog|brand|store|avatar|temp`
+
+See `CONTEXT.md` for domain notes.