Add digital catalog with shareable flipbook and ktg.montzar.ir deploy files.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-19 14:37:49 +03:30
commit a8374e7d6c
54 changed files with 8462 additions and 0 deletions
@@ -0,0 +1,53 @@
+# کاتالوگ دیجیتال
+
+از PDF یا چند تصویر، یک کاتالوگ ورق‌زدنی با لینک و QR می‌سازد. ثبت‌نام ندارد. کاتالوگ‌ها در سایت لیست نمی‌شوند.
+
+جزئیات محصول: [`docs/PROJECT.md`](docs/PROJECT.md)
+
+## اجرا
+
+نیاز به Node.js ۲۰ یا جدیدتر.
+
+```bash
+copy .env.example .env
+npm install
+npm run dev
+```
+
+سپس مرورگر را روی [http://localhost:3000](http://localhost:3000) باز کنید.
+
+- فرانت روی پورت ۳۰۰۰ — فقط همین را در مرورگر باز کنید
+- API روی پورت ۳۰۱۰ (از طریق `/api` پروکسی می‌شود)
+
+اگر پورت ۳۰۰۰ اشغال باشد Vite جابه‌جا نمی‌شود. همه ترمینال‌های `npm run dev` را ببندید و یکی را دوباره اجرا کنید.
+
+## ساخت برای سرور
+
+```bash
+npm run build
+npm start
+```
+
+`npm start` هم فرانت ساخته‌شده و هم API را روی `PORT` (پیش‌فرض ۳۰۰۰) سرو می‌کند.
+
+استقرار روی سرور مشترک (`ktg.montzar.ir`): راهنمای قدم‌به‌قدم [`deploy/DEPLOY.md`](deploy/DEPLOY.md).
+
+## تست
+
+```bash
+npm test
+```
+
+## متغیرهای محیط
+
+در `.env`:
+
+```
+PORT=3000
+API_PORT=3001
+PUBLIC_BASE_URL=http://localhost:3000
+STORAGE_DIR=./storage
+DATABASE_PATH=./data/catalogs.sqlite
+```
+
+`PUBLIC_BASE_URL` همان آدرسی است که داخل QR نوشته می‌شود. روی دامنه واقعی آن را به دامنه خودتان عوض کنید.