# 🗺️ نقشه راه، ریسک‌ها و کارهای باقیمانده

> **Roadmap + Risk Register + Dependencies + Priorities**  
> **آخرین بروزرسانی:** اسفند ۱۴۰۴

---

## ۱. وضعیت فعلی پروژه

```
██████████████████████████████████████████████████ 95%

Core Platform     ████████████████████████████████████████████████ 98%
Club System       █████████████████████████████████████████████░░░ 95%
E-Commerce        ████████████████████████████████████████████████ 98%
Payment           ██████████████████████████████████████░░░░░░░░░ 80%
UI/UX             ████████████████████████████████████████░░░░░░░ 85%
Deployment        ████████████████████████████████████████████░░░ 90%
Documentation     ████████████████████████████████████████████████ 100%
```

---

## ۲. کارهای باقیمانده (Backlog)

### 🔴 اولویت بالا (High Priority)

| # | آیتم | حوزه | پیش‌نیاز | تخمین |
|---|------|------|---------|-------|
| H1 | Product Bundle | Business | Proto + Handler | ۳ روز |
| H2 | Mobile Responsive (Phase 7) | UI/UX | — | ۵ روز |
| H3 | API Rate Limiting | CMS | — | ۲ روز |
| H4 | Error Boundary (Global) | FO/BO | — | ۱ روز |

### 🟡 اولویت متوسط (Medium Priority)

| # | آیتم | حوزه | پیش‌نیاز | تخمین |
|---|------|------|---------|-------|
| M1 | Manual Payment System | Business | تصمیم مدیریت | ۳ روز |
| M2 | SignalR for Chatika | CMS | — | ۲ روز |
| M3 | Dark Mode | UI/UX | — | ۲ روز |
| M4 | SEO Meta Tags | FO | — | ۲ روز |
| M5 | Order Notifications (SMS) | CMS | — | ۱ روز |
| M6 | BackOffice Dashboard Charts | BO | — | ۳ روز |

### 🟢 اولویت پایین (Low Priority)

| # | آیتم | حوزه | پیش‌نیاز | تخمین |
|---|------|------|---------|-------|
| L1 | PWA Support | FO | Mobile first | ۳ روز |
| L2 | API Versioning | CMS | — | ۲ روز |
| L3 | Monitoring (Prometheus) | Infra | — | ۳ روز |
| L4 | Log Aggregation (Seq/ELK) | Infra | — | ۳ روز |
| L5 | Product Compare | FO | — | ۲ روز |
| L6 | Wishlist | FO | — | ۲ روز |
| L7 | Email Templates (HTML) | CMS | — | ۲ روز |
| L8 | Refund System | CMS/PYMS | — | ۵ روز |

### ⛔ بلاک‌شده (Blocked)

| # | آیتم | بلاکر | اقدام لازم |
|---|------|-------|-----------|
| B1 | وام دایا (Production) | API دایا تکمیل نشده | پیگیری تیم دایا |
| B2 | پرداخت دستی | تصمیم‌گیری مدیریت | جلسه با مدیر محصول |

---

## ۳. نقشه راه (Roadmap)

### Q1 1404 (فروردین-خرداد)

```
Sprint 1 (فروردین):
    ├── H2: Mobile Responsive
    ├── H1: Product Bundle
    └── M4: SEO Meta Tags

Sprint 2 (اردیبهشت):
    ├── M1: Manual Payment (if approved)
    ├── M2: SignalR Chatika
    └── M6: Dashboard Charts

Sprint 3 (خرداد):
    ├── M3: Dark Mode
    ├── H3: Rate Limiting
    └── L1: PWA
```

### Q2 1404 (تیر-شهریور)

```
Sprint 4 (تیر):
    ├── L3: Monitoring
    ├── L4: Log Aggregation
    └── L2: API Versioning

Sprint 5 (مرداد):
    ├── L5: Product Compare
    ├── L6: Wishlist
    └── L7: Email Templates

Sprint 6 (شهریور):
    ├── L8: Refund System
    ├── Performance Optimization
    └── Security Audit
```

---

## ۴. ریسک‌ها (Risk Register)

### ۴.۱ ریسک‌های فنی

| # | ریسک | احتمال | تأثیر | شدت | اقدام |
|---|------|--------|------|-----|--------|
| R1 | MSSQL 2022 عدم scalability | Medium | High | 🟡 | مانیتورینگ + index optimization |
| R2 | gRPC breaking changes هنگام ارتقا proto | Low | High | 🟡 | Backward compatible changes |
| R3 | Hangfire job failure (commission) | Low | Critical | 🔴 | Polly retry + alerting + manual trigger |
| R4 | ZarinPal downtime | Medium | High | 🟡 | Fallback queue + manual payment |
| R5 | Ingress-nginx CVE | Low | Critical | 🔴 | Regular updates + WAF |
| R6 | Disk space (SQL backups) | Medium | Medium | 🟡 | Auto cleanup + offsite backup |

### ۴.۲ ریسک‌های بیزینسی

| # | ریسک | احتمال | تأثیر | شدت | اقدام |
|---|------|--------|------|-----|--------|
| R7 | دایا Loan API تغییر | High | Medium | 🟡 | Mock mode + adapter pattern |
| R8 | تغییر درصد تخفیف باشگاه | Low | Low | 🟢 | SystemConstants قابل‌تنظیم |
| R9 | رشد سریع کاربران (>10K) | Low | High | 🟡 | Load test + horizontal scale |
| R10 | تغییر قوانین مالیاتی | Medium | Medium | 🟡 | VAT configurable |

---

## ۵. وابستگی‌های خارجی (External Dependencies)

| سرویس | وابستگی | وضعیت | SLA |
|--------|---------|--------|-----|
| **ZarinPal** | درگاه پرداخت IPG | ✅ فعال | 99.5% |
| **Kavenegar** | ارسال SMS (OTP) | ✅ فعال | 99% |
| **Daya Loan** | API وام | ⚠️ Mock mode | نامشخص |
| **Chatika** | AI Chat | ✅ فعال | 95% |
| **Docker Hub** | Base images | ✅ با mirror | — |
| **NuGet.org** | .NET packages | ✅ با Nexus cache | — |
| **Gitea** | Source control | ✅ Self-hosted | 99% |

---

## ۶. معیارهای کیفیت (Quality Metrics)

### ۶.۱ فعلی

| معیار | مقدار فعلی | هدف |
|-------|-----------|------|
| Build Success Rate | ~95% | 99% |
| Average Response Time | ~200ms | <150ms |
| gRPC Error Rate | ~2% | <1% |
| Test Coverage | ~0% | >60% |
| Uptime (Staging) | ~98% | 99% |
| Documentation Coverage | 100% | 100% ✅ |

### ۶.۲ اقدامات بهبود

| اقدام | اولویت | تأثیر |
|-------|---------|-------|
| Unit Tests اضافه شود | High | Test Coverage +40% |
| Integration Tests | Medium | Reliability +20% |
| Load Testing (k6/JMeter) | Medium | Performance insight |
| Structured Logging (Serilog) | Medium | Debug time -50% |
| Health check endpoints | Done ✅ | Uptime monitoring |

---

## ۷. Definition of Done — Release Checklist

### Pre-Release (Staging)

- [ ] همه تست‌ها پاس شوند
- [ ] Review توسط حداقل ۱ نفر
- [ ] Migration scripts اجرا شوند
- [ ] Smoke test روی staging
- [ ] مستندات بروز باشد

### Production Release

- [ ] Staging sign-off
- [ ] Database backup
- [ ] Docker images tagged
- [ ] K8s rollout
- [ ] Health check green
- [ ] Post-deploy smoke test
- [ ] Rollback plan ready

---

## ۸. خلاصه اولویت‌بندی

```
NOW (این ماه):
    → Documentation consolidation ✅ DONE
    
NEXT (فروردین):
    → Mobile Responsive (H2)
    → Product Bundle (H1)
    → SEO (M4)

LATER (Q2):
    → Monitoring + Logging (L3, L4)
    → PWA (L1)
    → Refund (L8)

BLOCKED:
    → Daya Loan Production (B1) — waiting on Daya
    → Manual Payment (B2) — waiting on decision
```