didvan-app/BACKEND_TODO.md

کارهای سمت سرور (Backend / DevOps)

این فایل لیست کارهایی است که برای کامل شدن ریفکتور اپلیکیشن فلاتر، باید سمت بک‌اند یا زیرساخت (DevOps) انجام شوند. این موارد مستقل از کد فلاترند و کد اپ منتظر آن‌هاست.

آخرین به‌روزرسانی: ۱۴۰۵/۰۲/۳۱ (2026-05-21)

---

✅ حل‌شده (۱۴۰۵/۰۲/۳۱) — blockerهای قبلی

1. باگ Keycloak Authorization (permission ↔ scope) — ✅ حل شد

• علتِ واقعی باگ: در populateKeycloakPermissions (در apps/api-microservice/src/app.service.ts)، فیلد scopes permission با نامِ scope (مثل 'get-market') پر می‌شد، ولی Keycloak آنجا ID می‌خواهد. در نتیجه permission بدون scope ذخیره می‌شد (Scopes: -) و همیشه Deny می‌داد.
• رفع (کد): متد getScopeIds() اضافه شد که نام scope را به ID نگاشت می‌کند؛ حالا permission با scope ID ساخته/آپدیت می‌شود. (commit روی git.irfartak.com)
• رفع (تنظیم Keycloak): در didvan-api → Authorization → Settings، Decision Strategy از Unanimous به Affirmative تغییر کرد. (چون scope get-market را هم permission user و هم permission admin پوشش می‌دادند؛ با Unanimous چون admin رد می‌کرد کل Deny می‌شد.)
• نتیجه: Evaluate حالا market-user-role → Permit و GET /market → 200. endpointها کار می‌کنند.

2. Deploy کد جدید api-microservice — ✅ انجام شد

• روش (دور زدن مشکل npm/شبکه‌ی سرور): یک Dockerfile.fast ساخته شد که node_modules را از image قدیمی 0.0.59 برمی‌دارد و فقط npm run build می‌زند (بدون npm install). سریع و آفلاین.
• image جدید registry.didvan.com/api-microservice:0.0.61 ساخته شد؛ تگ در ~/microservices/didvan-iac/.env (متغیر API_MICROSERVICE_IMAGE_TAG) به‌روز شد؛ با docker compose -f compose.yml -f compose.prod.yml up -d --force-recreate api_gateway بالا آمد.
• نکته برای دیپلویِ بعدی: خط mirror (registry.npmmirror.com) را به Dockerfile اصلی اضافه نکن — cache داکر را خراب می‌کند و npm install را از صفر اجرا می‌کند. از همان روش Dockerfile.fast استفاده کن.

وضعیت enforcement (یادداشت)

• حالا که permissionها درست‌اند، می‌توان به ENFORCING برگشت. فعلا هنوز روی PERMISSIVE است (هم policyEnforcement در app.module.ts، هم Policy Enforcement Mode در didvan-api). برگشت به ENFORCING ریسک کم دارد ولی باید همه‌ی resourceها یک‌بار تست شوند.

---

🔴 باقی‌مانده‌ی زیرساخت

3. DNS ناپایدار کانتینرها (با workaround کار می‌کند)

• مشکل: سرور port 53 خروجی به DNSهای عمومی بسته دارد؛ DNS داخلی (5.200.200.200) کند/ناپایدار است → خطای getaddrinfo EAI_AGAIN auth.didvan.com.
• راه‌حل موقت اعمال‌شده (فعال): در compose.prod.yml برای سرویس api_gateway افزوده شد: extra_hosts: ["auth.didvan.com:185.143.233.235"]. الان gateway بدون خطای DNS بالا می‌آید.
• راه‌حل دائمی: یک DNS resolver محلی پایدار روی سرور راه‌اندازی شود، یا extra_hosts برای همه‌ی سرویس‌هایی که به دامنه‌های خارجی نیاز دارند اضافه شود (مثلا market_service برای call4.tgju.org, tsetmc).

---

🟡 endpointهای ناقص بک‌اند (برای کامل شدن feature های فلاتر لازم‌اند)

4. تنظیمات اعلان کاربر (User Notification Preferences)

• notification-service فقط CRUD روی notification و template دارد؛ مفهوم ترجیحات کاربر ندارد.
• نیاز به endpointهای:
  • دسته‌بندی‌های موردعلاقه برای اعلان (favorites)
  • وضعیت روشن/خاموش اعلان‌ها (notification status)
  • بازه‌ی زمانی سکوت / دریافت اعلان (silence interval / notification time)
• پیشنهاد: یا یک سرویس/endpoint جدید (مثل GET/PUT /user/preferences)، یا ذخیره به‌صورت Keycloak user attributes.
• در فلاتر: صفحه‌ی تنظیمات اعلان فعلا ایمن‌سازی شده (با AuthConfig.useLegacyApi=false پیام «به‌زودی» نشان می‌دهد).

5. Aggregator صفحه‌ی اصلی (Home)

• content-service endpoint یکپارچه برای صفحه‌ی اصلی ندارد (مثل /home قدیمی که banners + lists می‌داد).
• بخش‌های زیر در فلاتر فعلا منبع ندارند: topBanner, didvanPlus, didvanVoice, و ساختار lists صفحه‌ی اصلی.
• پیشنهاد: یک endpoint مرکب (مثلا GET /home یا /main-page) که این داده‌ها را برگرداند.

5.1 اسلایدر «تازه‌ترین کاوش‌ها»

• «کاوش» = ترکیب چند نوع: swot + خبر + رادار + ماهنامه + دلفی + پویش‌افق. endpoint واحدی برای گرفتن آخرین کاوش‌ها وجود ندارد.
• در فلاتر فعلا: اسلایدر فقط swot را نشان می‌دهد (تنها منبعی که قطعا کاوش است و در دسترس داریم). lib/views/home/main/main_page.dart → شاخه‌ی _ExploreLatestSliderNew با items: [].
• برای کامل شدن لازم است یکی از این‌ها:
  • یک endpoint مرکب «latest کاوش» که آخرین آیتم هر نوع را برگرداند، یا
  • مشخص شدن شناسه/نام category خبر/رادار/ماهنامه در content-service (تا بتوان با filter گرفت)، به‌علاوه‌ی اتصال delphi-service و منبعِ «پویش افق».

6. دسته‌بندی در market-service (نبض صنعت)

• GET /market فقط لیست تخت symbolها را می‌دهد (بدون دسته‌بندی).
• صفحه‌ی آمار فلاتر برای ۶ دسته (ارز/طلا، کریپتو، فلزات، کامودیتی، فولاد، سرمایه) طراحی شده.
• نیاز: افزودن فیلد category به market data یا یک endpoint گروه‌بندی‌شده.

7. عضویت خودکار کاربران در گروه‌های دسترسی

• کاربران جدید باید خودکار در گروه‌های content-users-group, market-users-group (و سایر گروه‌های لازم) قرار بگیرند.
• اقدام: این گروه‌ها در Keycloak → Realm Settings → User registration → Default Groups اضافه شوند (برای کاربران جدید). کاربران موجود باید دستی اضافه شوند.

8. آپلود عکس پروفایل (S3)

• مسیر جدید دومرحله‌ای است: آپلود فایل به s3-service و گرفتن key، سپس PATCH /auth/users/:id/profile-picture با آن key.
• در فلاتر: UserProvider.setProfilePhoto فعلا فقط false برمی‌گرداند (TODO). نیاز به مشخص شدن endpoint آپلود s3 (presigned URL یا multipart).

---

🟢 سرویس‌هایی که آماده‌اند و فلاتر باید بهشان migrate شود

این‌ها سمت بک‌اند موجودند؛ فقط کد فلاتر باید بهشان وصل شود (مورد ۱ حل شد، پس حالا قابل تست‌اند):

• ai-service — هوشان / دستیار هوش مصنوعی
• comments-service — کامنت‌ها
• swot-service — بایدها و نبایدها (از طریق opportunity-threat.didvan.com که الان هم کار می‌کند)
• delphi-service — سها / نظرسنجی
• ticketing-service — احتمالا معادل دایرکت/پیام
• activity-service — فعالیت‌ها
• content-service — اخبار، رادار، اینفوگرافی، ماهنامه، پادکست (همه به‌صورت Content با category/tag)

---

ℹ️ نکات

• دامنه‌ی قدیمی https://api.didvan.app کاملا down / SSL fail است؛ هیچ endpoint قدیمی‌ای از آن جواب نمی‌دهد.
• دامنه‌ی https://opportunity-threat.didvan.com (swot + stories) فعال و در دسترس است.
• دامنه‌ی جدید API gateway: https://api2.didvan.com (در lib/config/auth_config.dart).
• Keycloak: https://auth.didvan.com، realm didvan، client اپ didvan-app (public)، client بک‌اند didvan-api (confidential, authorization).