docs/final-docs/00-INDEX.md

📚 FourSat Project Documentation

آخرین بروزرسانی: January 3, 2026
وضعیت: ✅ Production Ready
Domain: *.se.kbs1.ir

---

⚡ Quick Reference (نکات مهم)

🌐 آدرس‌های Stage

سرویس	آدرس
BackOffice	https://backoffice.se.kbs1.ir
BackOffice BFF	https://backoffice-bff.se.kbs1.ir
FrontOffice	https://frontoffice.se.kbs1.ir
FrontOffice BFF	https://frontoffice-bff.se.kbs1.ir
CMS	https://cms.se.kbs1.ir
Git	git.se.kbs1.ir

📦 Git Repositories

# BackOffice
git remote -v  # kub-stage → https://git.se.kbs1.ir/admin/BackOffice.git

# BackOffice.BFF
git remote -v  # kub-stage → https://git.se.kbs1.ir/admin/BackOffice.BFF.git

# CMS
git remote -v  # gitea → https://git.se.kbs1.ir/admin/CMS.git

🔧 Build Commands

# BackOffice (Proto DLLs required)
cd BackOffice && ./build-deps.sh
cd src && dotnet build BackOffice.sln

# BFF/CMS
cd [Project]/src && dotnet build

# Deploy
git push kub-stage main

---

🏗️ معماری پروژه

┌───────────────────────────────────────────────────────────────┐
│                    FRONTEND (Blazor WASM)                      │
│         BackOffice (Admin) │ FrontOffice (User)                │
└───────────────────────────────────────────────────────────────┘
                              │
                        gRPC-Web + JWT
                              ▼
┌───────────────────────────────────────────────────────────────┐
│                    BFF (Backend For Frontend)                  │
│       BackOffice.BFF │ FrontOffice.BFF                         │
│       CQRS + MediatR + Proto Contracts                         │
└───────────────────────────────────────────────────────────────┘
                              │
                          gRPC
                              ▼
┌───────────────────────────────────────────────────────────────┐
│                    CMS Microservice                            │
│       Clean Architecture + PostgreSQL                          │
│       Commission │ Network │ Club │ Inventory                  │
└───────────────────────────────────────────────────────────────┘

---

📂 ساختار پروژه

FourSat/
├── BackOffice/              # Admin Panel (Blazor WASM)
│   ├── src/BackOffice/      # UI - 96 pages, 21 modules
│   ├── libs/                # Pre-built Proto DLLs (24)
│   └── build-deps.sh        # Build proto dependencies
│
├── BackOffice.BFF/          # Backend For Frontend
│   └── src/Protobufs/       # 24 Proto projects
│
├── FrontOffice/             # User Frontend (Blazor WASM)
├── FrontOffice.BFF/         # Backend For Frontend
│
├── CMS/                     # Core Microservice
│   └── src/
│       ├── CMSMicroservice.Domain/
│       ├── CMSMicroservice.Application/
│       ├── CMSMicroservice.Infrastructure/
│       └── CMSMicroservice.WebApi/
│
├── DataMigration/           # One-time Migration Tool
│
└── totalDoc/                # Documentation
    └── final-docs/          # ← این پوشه

---

🔄 مدل کاری (Workflow)

توسعه Local:

# 1. تغییرات در کد
# 2. Build و تست
dotnet build && dotnet run

# 3. Commit
git add . && git commit -m "feat: description"

Deploy به Stage:

# Push به remote → Gitea Actions → Docker → K8s
git push kub-stage main

تغییر Proto:

# 1. تغییر در CMS/BackOffice.BFF
# 2. Rebuild DLLs
cd BackOffice && ./build-deps.sh
# 3. Build UI
cd src && dotnet build

---

📊 وضعیت سیستم‌ها

سیستم	ماژول‌ها	وضعیت
BackOffice	21 ماژول, 96 صفحه	✅ Ready
BackOffice.BFF	24 Proto	✅ Ready
CMS	Commission, Network, Club, Inventory	✅ Ready
FrontOffice	User UI	⏳ Active

---

🛠️ Tech Stack

Layer	Technology
Frontend	Blazor WebAssembly, MudBlazor, .NET 9.0
BFF	ASP.NET Core, gRPC, MediatR, Mapster
Backend	Clean Architecture, EF Core, PostgreSQL
Communication	gRPC, gRPC-Web, Protobuf
CI/CD	Gitea Actions, Docker, Kubernetes
Auth	JWT

---

⚠️ نکات مهم

1. Proto DLLs: قبل از build کردن BackOffice، حتماً ./build-deps.sh اجرا شود
2. Domain: همه آدرس‌ها به *.se.kbs1.ir تغییر کرده
3. PublicMessage.Protobuf: تنها proto با net8.0 (بقیه net9.0)
4. Package Versions: Google.Protobuf: 3.28.3, Grpc.Core.Api: 2.71.0

---

📋 فهرست مستندات

#	فایل	موضوع
1	01-BACKOFFICE.md	Admin Panel - ماژول‌ها و صفحات
2	02-PROTO-GUIDE.md	Proto & gRPC - راهنمای packaging
3	03-DATA-MIGRATION.md	Data Migration - 33 جدول
4	04-CMS.md	CMS Microservice
5	05-DEPLOYMENT.md	Deployment & CI/CD

---

📁 آرشیو

مستندات قدیمی در totalDoc/archive/ نگهداری می‌شوند