Add initial documentation for Merchant Services API including contract status service details

04-FRONTEND/BackOffice/README.md

@@ -1,8 +1,8 @@
 # BackOffice - Network & Commission Management System
 
-**Version**: 2.1  
-**Last Updated**: 2025-12-01  
-**Status**: 🟢 **92% Complete - Production Ready**
+**Version**: 2.2  
+**Last Updated**: 2025-12-05  
+**Status**: 🟡 **Build In Progress - ~12 Errors Remaining**
 
 ---
 
@@ -14,27 +14,28 @@ BackOffice is a comprehensive Blazor WebAssembly application for managing networ
 
 ## 🎯 Current Status
 
-### **Overall Progress: 92%**
+### **Build Status: 🔴 FAILING (~12 errors)**
 
-- ✅ **23 Pages Implemented** (Commission: 4, Network: 4, Club: 3, System: 4, Dashboard: 1, Settings: 1)
-- ✅ **30 BFF Handlers** (Commission: 15, Network: 9, Club: 6)
-- ✅ **Build Status**: 0 errors
-- ✅ **Architecture**: 3-tier (Frontend → BFF → CMS)
+> See `BackOffice/docs/BUILD-FIX-STATUS.md` for detailed error list
 
-### **Completed Features**:
-- ✅ Commission Dashboard & Reports
-- ✅ User Payouts Management
-- ✅ Withdrawal Requests (Get, Approve, Reject)
-- ✅ Worker Control (Manual Trigger, Status, Logs)
-- ✅ Network Tree Viewer & History
-- ✅ Club Membership Management
-- ✅ System Monitoring Pages
+### **Recent Changes (2025-12-05)**:
+- ⚠️ Migrated from .NET 8 to .NET 9
+- ⚠️ Updated MudBlazor to 8.14.0 (requires T parameter for generics)
+- ⚠️ Multiple files excluded from build (missing proto dependencies)
+- ⚠️ Products.Protobuf switched from NuGet to ProjectReference
 
-### **Remaining Work (8%)**:
-- 🔴 Statistics APIs (Network & Club real data)
-- 🔴 Frontend Integration Testing
-- 🔴 Alert storage endpoints
-- 🔴 Configuration management API
+### **Known Issues**:
+- Missing proto projects: DiscountProduct, DiscountCategory, DiscountOrder, Tag, ProductTag
+- Some UserOrder methods missing in proto (CancelOrder, ApplyDiscount, UpdateOrderStatus)
+- PaginationState namespace conflicts
+- Int32Value/Int64Value binding issues in WithdrawalReports
+
+### **Excluded Files** (see `BackOffice/docs/EXCLUDED-FILES.md`):
+- `Pages/DiscountShop/**` - needs new proto projects
+- `Pages/Tag/**` - needs Tag.Protobuf
+- `Pages/Products/Components/*Dialog*` - needs proto updates
+- `Pages/UserOrder/Components/*Dialog*` - needs proto updates
+- Several other pages with missing dependencies
 
 ---
 
@@ -43,7 +44,10 @@ BackOffice is a comprehensive Blazor WebAssembly application for managing networ
 ```
 BackOffice/
 ├── docs/
-│   └── development-plan.md     # Detailed implementation roadmap
+│   ├── development-plan.md     # Detailed implementation roadmap
+│   ├── BUILD-FIX-STATUS.md     # Current build errors and fixes
+│   ├── EXCLUDED-FILES.md       # List of excluded files
+│   └── PROTO-DEPENDENCIES.md   # Proto requirements
 ├── src/
 │   ├── BackOffice.sln
 │   └── BackOffice/
@@ -63,7 +67,7 @@ BackOffice/
 ## 🚀 Getting Started
 
 ### Prerequisites:
-- .NET 8.0 SDK
+- .NET 9.0 SDK
 - Running CMS microservice (port 5133)
 - Running BFF service (port 5001)