docs: consolidate 53 files into 15 structured files in 3 folders

- business/ (5): club-commission, payment, ecommerce, membership, content - technical/ (5): cms-arch, ui, deployment, migration, api - overview/ (5): flowcharts, index, changelog, glossary, roadmap - Removed all old folders: backoffice, cms, deployment, docs, frontoffice, migration, ui-modernization, business (old) - Updated internal links with relative folder paths
2026-02-18 22:29:37 +03:30
parent d7c32dab2a
commit efff5e9cd5
71 changed files with 3632 additions and 32267 deletions
@@ -0,0 +1,214 @@
+# 🗺️ نقشه راه، ریسک‌ها و کارهای باقیمانده
+
+> **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
+```