docs/archive/collected-docs/root/PROTO-REMINDER.md

⚠️ یادآوری مهم - Proto Package Management

قانون طلایی (برای ALL سرویس‌ها)

هر تغییر در Proto = این 3 مرحله اجباری:

# 1️⃣ افزایش Version
<Version>X.Y.Z</Version>  →  <Version>X.Y.Z+1</Version>

# 2️⃣ Pack کردن
dotnet pack -c Release
# ✅ خودکار push می‌شه به GitLab

# 3️⃣ Update در لایه بالاتر
<PackageReference Include="PackageName" Version="NEW_VERSION" />

---

مثال عملی

تغییر در CMS Proto:

cd CMS/src/CMSMicroservice.Protobuf
# ویرایش products.proto
# افزایش <Version>0.0.142</Version> → 0.0.143
dotnet pack -c Release

Update در BackOffice.BFF:

<!-- BackOffice.BFF.Products.Protobuf.csproj -->
<PackageReference Include="Foursat.CMSMicroservice.Protobuf" Version="0.0.143" />

Pack کردن BFF:

cd BackOffice.BFF/src/Protobufs/BackOffice.BFF.Products.Protobuf
# افزایش <Version>1.0.0</Version> → 1.0.1
dotnet pack -c Release

Update در BackOffice UI:

<!-- BackOffice.csproj -->
<PackageReference Include="Foursat.BackOffice.BFF.Products.Protobuf" Version="1.0.1" />

---

این قانون برای همه است:

• ✅ CMS → BackOffice.BFF
• ✅ CMS → FrontOffice.BFF
• ✅ BackOffice.BFF → BackOffice UI
• ✅ FrontOffice.BFF → FrontOffice UI

---

⚠️ فراموش کردن = Bug

• Runtime errors بی‌دلیل
• "Method not found"
• "Type mismatch"
• ساعت‌ها Debug بیهوده

---

GitLab Registry: https://git.afrino.co/api/packages/FourSat/nuget/index.json