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

2.2 KiB
Raw Blame History

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 جایگزین کنید.