diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..7a550fe
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,9 @@
+# GEMINI_API_KEY: Required for Gemini AI API calls.
+# AI Studio automatically injects this at runtime from user secrets.
+# Users configure this via the Secrets panel in the AI Studio UI.
+GEMINI_API_KEY="MY_GEMINI_API_KEY"
+
+# APP_URL: The URL where this applet is hosted.
+# AI Studio automatically injects this at runtime with the Cloud Run service URL.
+# Used for self-referential links, OAuth callbacks, and API endpoints.
+APP_URL="MY_APP_URL"
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..5a86d2a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,8 @@
+node_modules/
+build/
+dist/
+coverage/
+.DS_Store
+*.log
+.env*
+!.env.example
diff --git a/BACKEND_INTEGRATION.md b/BACKEND_INTEGRATION.md
new file mode 100644
index 0000000..ff8ec32
--- /dev/null
+++ b/BACKEND_INTEGRATION.md
@@ -0,0 +1,36 @@
+# 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` جایگزین کنید.
diff --git a/README.md b/README.md
index 2241000..ff62415 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,49 @@
-
Built with AI Studio
+## 🌟 قابلیتهای کلیدی (Key Features)
-
The fastest path from prompt to production with Gemini.
+- **Smart Advisor (مشاور هوشمند)**: سیستم تحلیل بالینی مبتنی بر وضعیت سلامت، نژاد و سن پت برای پیشنهاد دقیق مکمل.
+- **Digital Health ID (شناسنامه سلامت)**: مدیریت کامل سوابق درمانی، یادآورها و موجودی انبار شخصی برای هر حیوان.
+- **Kindness Footprint (ردپای مهربانی)**: سیستم خیریه یکپارچه برای حمایت از حیوانات بیسرپرست پناهگاهی با هر خرید.
+- **PWA Support**: قابلیت نصب بر روی موبایل و پشتیبانی از حالت آفلاین برای مشاهده شناسنامهها.
+- **B2B Portal**: پورتال اختصاصی برای داروخانهها و کلینیکهای دامپزشکی.
- Start building
+## 🛠 تکنولوژیها (Tech Stack)
-