# کاتالوگ دیجیتال

از 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 نوشته می‌شود. روی دامنه واقعی آن را به دامنه خودتان عوض کنید.