masoodafar-web
148 lines
3.9 KiB
Markdown
148 lines
3.9 KiB
Markdown
# BackOffice - Network & Commission Management System
|
|
|
|
**Version**: 2.3
|
|
**Last Updated**: 2025-12-26
|
|
**Status**: ✅ **Build Successful - Production Ready**
|
|
|
|
---
|
|
|
|
## 📋 Overview
|
|
|
|
BackOffice is a comprehensive Blazor WebAssembly application for managing network marketing operations, commission calculations, club memberships, and system administration.
|
|
|
|
---
|
|
|
|
## 🎯 Current Status
|
|
|
|
### **Build Status: ✅ SUCCESSFUL (0 Errors, ~246 Warnings)**
|
|
|
|
### **Recent Changes (2025-12-26)**:
|
|
- ✅ **NEW**: App Version Management page (`/settings/app-versions`)
|
|
- ✅ Network Tree rewritten with d3-org-chart
|
|
- ✅ All proto dependencies resolved
|
|
- ✅ MudBlazor upgraded to 8.x with proper T parameter
|
|
|
|
### **Recent Changes (2025-12-25)**:
|
|
- ✅ Network Tree Viewer complete rewrite with d3-org-chart
|
|
- ✅ Tooltip on hover for node details
|
|
- ✅ Week filter visual distinction
|
|
- ✅ Search and navigation features
|
|
|
|
### **Previous Known Issues (Now Resolved)**:
|
|
- ~~Missing proto projects~~ ✅ Fixed
|
|
- ~~UserOrder methods missing~~ ✅ Fixed
|
|
- ~~PaginationState conflicts~~ ✅ Fixed
|
|
|
|
---
|
|
|
|
## 📁 Project Structure
|
|
|
|
```
|
|
BackOffice/
|
|
├── docs/
|
|
│ ├── 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/
|
|
│ ├── Pages/
|
|
│ │ ├── Commission/ # 4 pages (Dashboard, Reports, Payouts, Withdrawals)
|
|
│ │ ├── Network/ # 4 pages (Tree, History, Balances, Info)
|
|
│ │ ├── Club/ # 3 pages (Members, Statistics)
|
|
│ │ ├── SystemManagement/ # 4 pages (Worker, Alerts, Health, Config)
|
|
│ │ ├── Dashboard/ # 1 page (SystemOverview)
|
|
│ │ └── Settings/ # 2 pages (UserSettings, AppVersions)
|
|
│ ├── Services/
|
|
│ │ ├── AppVersion/ # App version management
|
|
│ │ └── ...
|
|
│ └── Components/ # Reusable dialogs
|
|
└── README.md
|
|
```
|
|
|
|
---
|
|
|
|
## 🚀 Getting Started
|
|
|
|
### Prerequisites:
|
|
- .NET 9.0 SDK
|
|
- Running CMS microservice (port 5133)
|
|
- Running BFF service (port 5001)
|
|
|
|
### Run BackOffice:
|
|
```bash
|
|
cd src/BackOffice
|
|
dotnet run
|
|
```
|
|
|
|
Access at: `https://localhost:7001`
|
|
|
|
---
|
|
|
|
## 📊 Features
|
|
|
|
### **1. Commission Management** 💰
|
|
- Weekly pool dashboard with statistics
|
|
- Commission reports with filtering
|
|
- User payouts tracking
|
|
- Withdrawal approval/rejection
|
|
- Manual calculation trigger
|
|
|
|
### **2. Network Management** 🌳
|
|
- Binary tree visualization (table-based)
|
|
- User network information
|
|
- Network history tracking
|
|
- Weekly balance reports
|
|
|
|
### **3. Club Management** 🏆
|
|
- Active/Inactive club members
|
|
- Activation/Deactivation workflows
|
|
- Member statistics (mock data)
|
|
|
|
### **4. System Management** ⚙️
|
|
- Worker control panel
|
|
- System alerts monitoring
|
|
- Health dashboard
|
|
- Configuration editor
|
|
|
|
### **5. App Version Management** 📱 (NEW)
|
|
- Mobile app version control
|
|
- Force update configuration
|
|
- Min required version setting
|
|
- Cache clear requirements
|
|
- Update messages & release notes
|
|
|
|
---
|
|
|
|
## 🔧 Technical Stack
|
|
|
|
- **Framework**: Blazor WebAssembly
|
|
- **UI Library**: MudBlazor
|
|
- **Communication**: gRPC-Web
|
|
- **Authentication**: JWT Bearer
|
|
- **Build Status**: ✅ 0 errors
|
|
|
|
---
|
|
|
|
## 📖 Documentation
|
|
|
|
See `docs/development-plan.md` for:
|
|
- Detailed feature specifications
|
|
- Implementation status
|
|
- API documentation
|
|
- Architecture diagrams
|
|
- Testing guidelines
|
|
|
|
---
|
|
|
|
## 🎯 Next Steps
|
|
|
|
1. Implement Statistics APIs with real database queries
|
|
2. Frontend integration testing
|
|
3. Add audit logging for critical operations
|
|
4. Implement caching for performance optimization
|
|
|
|
---
|
|
|
|
**For detailed implementation status, see**: [development-plan.md](docs/development-plan.md) |