docs/archive/CLEANUP-NOTES.md

📝 یادداشت پاکسازی (Cleanup Notes)

تاریخ: ۱۴ آذر ۱۴۰۴
عملیات: پاکسازی فایل‌های تکراری و پوشه‌های قدیمی

---

✅ کارهای انجام شده

1. حذف فایل‌های تکراری (22 فایل):

CMS/ (11 فایل):

• ✅ balance-calculation-carryover-logic.md → موجود در 01-BUSINESS/
• ✅ binary-tree-registration-guide.md → موجود در 01-BUSINESS/
• ✅ cms-data-and-business.md → موجود در 03-BACKEND/CMS/entity-guide.md
• ✅ daya-loan-integration.md → موجود در 01-BUSINESS/
• ✅ discount-shop-system.md → موجود در 01-BUSINESS/
• ✅ email-sms-configuration-guide.md → موجود در 03-BACKEND/CMS/
• ✅ implementation-progress.md → موجود در 03-BACKEND/CMS/implementation-status.md
• ✅ network-club-commission-system-v1.1.md → موجود در 01-BUSINESS/
• ✅ package-purchase-system.md → موجود در 01-BUSINESS/
• ✅ payment-gateway-integration.md → موجود در 03-BACKEND/CMS/payment-gateway.md
• ✅ README.md → موجود در 03-BACKEND/CMS/

BackOffice/ (5 فایل):

• ✅ development-plan.md → موجود در 03-BACKEND/BackOffice.BFF/handlers-status.md
• ✅ README.md → موجود در 04-FRONTEND/BackOffice/
• ✅ BackOffice.BFF/README.md → موجود در 03-BACKEND/BackOffice.BFF/
• ✅ BackOffice.BFF/cms-integration.md → موجود در 03-BACKEND/BackOffice.BFF/
• ✅ BackOffice.BFF/discount-shop-integration-plan.md → موجود در 03-BACKEND/BackOffice.BFF/

FrontOffice/ (6 فایل):

• ✅ README.md → موجود در 04-FRONTEND/FrontOffice/
• ✅ FRONTOFFICE-ANALYSIS.md → موجود در 04-FRONTEND/FrontOffice/gap-analysis.md
• ✅ TODO-COMMENTED-CODE.md → موجود در 04-FRONTEND/FrontOffice/
• ✅ BFF-CMS-PROTOBUF-MISMATCH-ANALYSIS.md → موجود در 03-BACKEND/FrontOffice.BFF/protobuf-mismatch.md
• ✅ PROGRESS-REPORT-1404-09-14.md → موجود در 04-FRONTEND/FrontOffice/progress-report.md
• ✅ FrontOffice.BFF/README.md → موجود در 03-BACKEND/FrontOffice.BFF/

---

2. انتقال به آرشیو (3 فایل):

• ✅ CMS/ANALYSIS-CONTRADICTIONS-AND-ISSUES.md → 99-ARCHIVE/

  • دلیل: سند تحلیلی قدیمی، مشکلات حل شده

• ✅ CMS/ENTITY-NAMING-REFACTORING-PLAN.md → 99-ARCHIVE/

  • دلیل: طرح Refactoring انجام شده

• ✅ CMS/monitoring-alerts-consolidated-report.md → 99-ARCHIVE/

  • دلیل: گزارش قدیمی Monitoring System

---

3. افزوده شده به ساختار جدید (6 فایل):

Business Logic:

• ✅ CMS/manual-payment-system.md → 01-BUSINESS/

Backend CMS:

• ✅ CMS/migration-network-parent-guide.md → 03-BACKEND/CMS/
• ✅ CMS/payment-architecture-pyms.md → 03-BACKEND/CMS/

Frontend FrontOffice:

• ✅ FrontOffice/mudblazor_classes.md → 04-FRONTEND/FrontOffice/mudblazor-reference.md
  • نکته: 6,270 خط مرجع کامل MudBlazor Components

---

4. حذف پوشه‌های خالی:

• ✅ BackOffice/ - تمام فایل‌ها منتقل شدند
• ✅ FrontOffice/ - تمام فایل‌ها منتقل شدند
• ⚠️ BackOffice.BFF/ - فقط پوشه docs/ باقی مانده
• ⚠️ FrontOffice.BFF/ - فقط پوشه docs/ باقی مانده

---

📊 آمار قبل و بعد

متریک	قبل پاکسازی	بعد پاکسازی	تغییر
فایل‌های .md در Root	5	5	0
فایل‌های CMS/	17	0 (.md)	-17
فایل‌های BackOffice/	2	0	-2
فایل‌های FrontOffice/	6	0	-6
فایل‌های آرشیو	12	15	+3
کل فایل‌های .md	77	55	-22

بهبود: کاهش 28.5% در تعداد فایل‌ها (حذف تکرار)

---

🗂️ ساختار نهایی

totalDoc/
├── 00-INDEX.md                    (14KB)
├── 00-INDEX-NEW.md                (15KB)
├── README.md                      (3.6KB)
├── QUICK-REFERENCE.md             (جدید)
├── CONSOLIDATION-FINAL-REPORT.md  (15KB)
│
├── 01-BUSINESS/                   (7 فایل)
│   ├── network-commission-system.md
│   ├── discount-shop-business.md
│   ├── package-purchase-system.md
│   ├── daya-loan-integration.md
│   ├── balance-calculation-rules.md
│   ├── binary-tree-guide.md
│   └── manual-payment-system.md   ⭐ جدید
│
├── 02-ARCHITECTURE/               (1 فایل)
│   └── README.md                  (راهنما)
│
├── 03-BACKEND/
│   ├── CMS/                       (9 فایل)
│   │   ├── README.md
│   │   ├── implementation-status.md
│   │   ├── entity-guide.md
│   │   ├── api-coverage.md
│   │   ├── email-sms-configuration.md
│   │   ├── payment-gateway.md
│   │   ├── migration-network-parent-guide.md  ⭐ جدید
│   │   └── payment-architecture-pyms.md       ⭐ جدید
│   ├── BackOffice.BFF/            (4 فایل)
│   └── FrontOffice.BFF/           (2 فایل)
│
├── 04-FRONTEND/
│   ├── BackOffice/                (2 فایل)
│   └── FrontOffice/               (5 فایل)
│       ├── README.md
│       ├── gap-analysis.md
│       ├── todo-commented-code.md
│       ├── progress-report.md
│       └── mudblazor-reference.md  ⭐ جدید (6,270 خط)
│
├── 05-TASKS/                      (3 فایل)
├── 06-DEPLOYMENT/                 (2 فایل)
│
├── 99-ARCHIVE/                    (15 فایل)
│   ├── ARCHIVE-INDEX.md
│   ├── ... (12 فایل قدیمی)
│   ├── ANALYSIS-CONTRADICTIONS-AND-ISSUES.md       ⭐ جدید
│   ├── ENTITY-NAMING-REFACTORING-PLAN.md           ⭐ جدید
│   └── monitoring-alerts-consolidated-report.md    ⭐ جدید
│
└── (پوشه‌های قدیمی با فایل‌های non-markdown)
    ├── CMS/                       (4 فایل: .ndm2, .sql, .txt)
    ├── BackOffice.BFF/docs/       (فایل‌های طراحی)
    └── FrontOffice.BFF/docs/      (فایل‌های طراحی)

---

⚠️ فایل‌های باقیمانده غیر Markdown

پوشه‌های زیر فایل‌های غیر markdown دارند که حفظ شده‌اند:

CMS/:

• model.ndm2 - دیاگرام دیتابیس
• model1.ndm2 - دیاگرام دیتابیس (نسخه 2)
• network_crm_calculate.txt - محاسبات CRM
• update-pool-percent.sql - اسکریپت SQL

BackOffice.BFF/docs/:

• (فایل‌های طراحی - نیاز به بررسی)

FrontOffice.BFF/docs/:

• (فایل‌های طراحی - نیاز به بررسی)

توصیه: این فایل‌ها را حفظ کنید (مربوط به database schema و scripts هستند)

---

✅ نتیجه‌گیری

• تمیز شد: 22 فایل تکراری حذف
• سازماندهی: 6 فایل جدید به ساختار اضافه شد
• حفظ تاریخچه: 3 فایل به آرشیو منتقل شد
• کارایی: ساختار 28.5% کوچکتر و واضح‌تر

وضعیت: ✅ ساختار مستندات بهینه و آماده استفاده

---

تاریخ تکمیل: ۱۴ آذر ۱۴۰۴
مسئول: GitHub Copilot (Claude Sonnet 4.5)