docs/overview/OVERVIEW-05-ROADMAP.md

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

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