canina/BACKEND_INTEGRATION.md
parsa aghayi c95c9e5ce0 feat: initialize project structure
- Configure project metadata and dependencies
- Setup Vite with React and TypeScript
- Add environment configuration and .gitignore
- Implement initial application entry point and assets
2026-05-26 11:37:22 +03:30

37 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Backend Integration Map | نقشه اتصال به بک‌بند 🏗️
این سند شامل تمامی نقاط اتصال (End-points) مورد نیاز برای عملیاتی کردن پلتفرم کانی‌نا ایران است.
## لیست TODOهای تزریق شده در کد:
### ۱. سرویس محصولات (Product Service)
- **GET /api/products**: دریافت لیست محصولات با فیلتر نژاد، دسته‌بندی و جستجو.
### ۲. مدیریت کاربران (User Store)
- **POST /api/auth/login**: ورود با موبایل یا تفکیک نقش (صاحب پت/همکار).
- **POST /api/auth/logout**: خروج از حساب کاربری.
- **PATCH /api/user/profile**: بروزرسانی اطلاعات پروفایل.
- **POST /api/user/addresses**: ثبت آدرس جدید.
- **PATCH /api/user/addresses/{id}**: ویرایش آدرس موجود.
- **DELETE /api/user/addresses/{id}**: حذف آدرس.
- **POST /api/user/addresses/{id}/set-default**: انتخاب آدرس پیش‌فرض.
- **POST /api/user/wallet/top-up**: شارژ کیف پول.
### ۳. پرونده سلامت پت (Pet Store)
- **POST /api/pets**: ثبت پت جدید (صدور شناسنامه).
- **PATCH /api/pets/{id}**: ویرایش اطلاعات پت.
- **DELETE /api/pets/{id}**: حذف پروفایل پت.
- **POST /api/pets/{petId}/reminders**: افزودن یادآور جدید.
- **POST /api/pets/{petId}/reminders/{reminderId}/toggle**: ثبت انجام یادآور (کاهش موجودی انبار شخصی).
- **POST /api/pets/{petId}/health-logs**: ثبت گزارش سلامت روزانه.
### ۴. سبد خرید و پرداخت (Cart & Payment)
- **POST /api/cart/apply-coupon**: استعلام و اعمال کد تخفیف.
- **POST /api/orders**: ثبت نهایی سفارش و تولید کد رهگیری.
- **POST /api/payment/init**: اتصال به درگاه پرداخت بانکی.
---
## راهنمای پیاده‌سازی:
تمامی این نقاط در کد با کامنت `// TODO: [BACKEND_API]` مشخص شده‌اند. کافیست در هر بخش، منطق `set` یا `fetch` فعلی را با یک فراخوانی `axios` یا `fetch` جایگزین کنید.