BEXO ERP Documentation Library
Version: 1.0
Last Updated: 2026-05-30
Status: Production Ready
Welcome to BEXO ERP
BEXO is a comprehensive Enterprise Resource Planning (ERP) solution built on .NET 8 and SQL Server, designed for multi-company organizations in the UAE and broader Middle East region.
Quick Navigation
I want to...
| Goal | Read This |
|---|---|
| Start using BEXO today | → User Guide |
| Print a quick reference | → Quick Reference Card |
| Set up BEXO on new server | → Setup Guide |
| Manage/maintain BEXO | → Admin Guide |
| Troubleshoot an issue | → User Guide § Troubleshooting |
Documentation Structure
📖 User Guides (/user-guides/)
Target Audience: End users, managers, operators
- BEXO_Complete_User_Guide.md (27 KB)
- System overview & architecture
- Getting started & installation
- Authentication & login
- 8 core modules with step-by-step workflows
- Complete workflow examples (Sales-to-Cash, Inventory, Payroll)
- Best practices & checklists
- Troubleshooting guide (common issues & solutions)
Use this guide if you: - Are a new user learning BEXO - Need to create invoices, payments, or process payroll - Encounter an error and need to fix it - Want to understand how features work end-to-end
⚡ Quick Reference (/quick-reference/)
Target Audience: Experienced users, desk workers
- BEXO_Quick_Reference_Card.md (2.8 KB)
- Print-friendly quick reference
- Login flow
- Top 5-minute tasks
- Keyboard shortcuts
- Common error codes & fixes
- Account code lookup
- Month-end checklist (short version)
- Emergency contacts
Use this if you: - Need a quick lookup while working - Want to print and keep at your desk - Have used BEXO before and just need reminders - Are looking for account codes or error codes
⚙️ Admin & Operations Guide (/admin-guides/)
Target Audience: IT staff, database administrators, system managers
- BEXO_Administrator_Guide.md (9.8 KB)
- System architecture & components
- Service management (restart, status checks)
- Database administration (backup, restore, maintenance)
- User account management & RBAC
- Performance tuning & monitoring
- Security configuration (firewall, SSL, SQL logins)
- Disaster recovery procedures
- Upgrade & patch management
- Troubleshooting for IT staff
- Maintenance schedules
Use this if you: - Need to manage BEXO infrastructure - Are responsible for backups & recovery - Manage user accounts & permissions - Monitor system health & performance - Need to troubleshoot at the database/API level
🚀 Setup & Deployment Guide (/setup-guides/)
Target Audience: DevOps engineers, deployment teams
- BEXO_Complete_Setup_Deployment.md (15 KB)
- Pre-deployment checklist
- Phase-by-phase setup (10 phases)
- Server infrastructure requirements
- .NET 8 installation
- SQL Server configuration
- API deployment & configuration
- WPF client deployment
- SSL/TLS certificate setup
- Windows service installation
- Backup & recovery setup
- Health monitoring configuration
- Firewall rules
- Post-deployment verification
- Rollback procedures
- Production UAT checklist
Use this if you: - Are deploying BEXO to a new server - Setting up production environment - Configuring backups & monitoring - Need to verify a deployment is correct - Need to rollback a failed deployment
Key Features Overview
✅ What BEXO Can Do
Financial Management - Multi-company General Ledger - Accounts Receivable (Customer Invoicing) - Accounts Payable (Supplier Management) - Bank Reconciliation - Trial Balance & Financial Reporting - Profit & Loss Statements - Cash Flow Analysis
Inventory & Supply Chain - Product master data - Stock level tracking - Warehouse management - Production planning (Manufacturing Orders) - Stock receipts & issues - Goods received notes (GRN) - Stock adjustments & transfers
Human Resources & Payroll - Employee master data - Attendance tracking - Leave management - Monthly salary processing - Gratuity calculations - Tax withholding - Payslip generation
Reporting & Analysis - 21+ standard reports - Trial Balance - P&L Statements - Balance Sheet - Ratio analysis - Custom filtering & date ranges - Export to CSV/PDF/Excel
Security & Control - Role-based access control (5 roles) - JWT authentication - Encrypted HTTPS connections - Audit logs (who accessed what) - Company-scoped data isolation - Multi-company support (up to 12 companies)
System Requirements
Minimum
Hardware: Intel Core i5 (4 cores), 8 GB RAM, 50 GB disk
OS: Windows 10 / Windows Server 2016+
Software: .NET 8 ASP.NET Core Runtime, SQL Server 2016+
Network: 100 Mbps LAN connection
Recommended
Hardware: Intel Xeon (8+ cores), 16 GB RAM, 100 GB SSD
OS: Windows Server 2022 Standard or Enterprise
Software: .NET 8 ASP.NET Core Runtime, SQL Server 2019+
Network: 1 Gbps LAN (dedicated, not shared)
Backup: External drive or NAS for off-box backups
Getting Started (3 Steps)
Step 1: User Login
1. Launch BEXO.UI.exe
2. Enter Username & Password
3. Select Company from dropdown
4. Click Login
→ Dashboard appears (ready to use)
Test Credentials:
Username: designer
Password: Test@123
Step 2: Explore Dashboard
- View summary cards (cash, receivables, payables)
- See trend charts (12-month revenue, expenses)
- Check alerts (overdue invoices, low inventory)
- Use quick actions (create invoice, record payment)
Step 3: Create Your First Invoice
See User Guide § Module 2 for detailed steps.
Common Workflows (Find Yours)
| Workflow | Duration | Guide Section |
|---|---|---|
| Create customer | 5 min | User Guide § Customers |
| Create & send invoice | 10 min | User Guide § Invoicing |
| Record payment | 5 min | User Guide § Payments |
| Receive stock | 10 min | User Guide § Stock Receipt |
| Process payroll | 30 min | User Guide § Payroll |
| Close month-end | 2 hours | User Guide § Month-End Checklist |
| View Trial Balance | 2 min | User Guide § Financial Reports |
Troubleshooting Quick Links
Can't Login? → User Guide § Troubleshooting: Login Failed
Data Not Saving? → User Guide § Troubleshooting: Database Connection Error
API Won't Start? → Admin Guide § Troubleshooting: API Won't Start
Database Needs Restore? → Admin Guide § Disaster Recovery
Slow Performance? → Admin Guide § Performance Tuning
Role-Based Documentation
👤 If You Are a User/Operator
- Start with: Quick Reference Card
- Then read: User Guide
- Keep handy: Troubleshooting Section
👨💼 If You Are a Manager/Supervisor
- Start with: User Guide (especially workflow examples)
- Focus on: Best Practices & Month-End Checklist
- Reference: Quick Reference Card for daily lookups
🔧 If You Are IT / System Administrator
- Start with: Admin Guide
- Setup phase: Setup & Deployment Guide
- Operations: Admin Guide § Service Management
- Emergency: Admin Guide § Disaster Recovery
🚀 If You Are Deploying to Production
- Pre-deployment: Setup Guide § Pre-Deployment Checklist
- Deployment: Setup Guide § Phases 1-10
- Post-deployment: Setup Guide § Verification
- Verification: Setup Guide § UAT Checklist
System Administration Essentials
Daily Operations
Morning: Check health alerts (C:\Tools\logs\bexo_alerts.log)
Verify backup completed (C:\Backups\BEXO_SQL\)
Throughout: Monitor performance if slow user reports
Afternoon: Review user activity logs
Evening: Confirm next backup will run at 02:00 AM
Reference: Admin Guide § Maintenance Schedule
Critical Services
| Service | Status Check | Restart Command |
|---|---|---|
| BEXO API | Get-Service BEXO_API_Prod |
Restart-Service BEXO_API_Prod |
| SQL Server | Get-Service MSSQLSERVER |
Restart-Service MSSQLSERVER |
| Health Check | Task Scheduler → BEXO_Health_Watchdog | Manual: Start-ScheduledTask... |
| Backups | Task Scheduler → BEXO_DB_Backup | Manual: Start-ScheduledTask... |
Backup Information
Schedule: Daily at 02:00 AM
Location: C:\Backups\BEXO_SQL\ (local)
\\NAS\BEXO_Deploy\db_backups\ (off-box)
Retention: 7-day rolling window
Verify: Automated RESTORE VERIFYONLY on each backup
See: Admin Guide § Backup & Recovery
Contact & Support
Getting Help
| Question | Where to Find Answer |
|---|---|
| "How do I create an invoice?" | User Guide § Customers & Invoicing |
| "Why is my password rejected?" | User Guide § Troubleshooting |
| "How do I reset a user password?" | Admin Guide § User Management |
| "What's the backup location?" | Admin Guide § Backup Information |
| "How do I restore a database?" | Admin Guide § Disaster Recovery |
| "How do I install BEXO?" | Setup Guide § All Phases |
| "Why is the API slow?" | Admin Guide § Performance Tuning |
Internal Support
- Application Issues: Application Management Team (x2100)
- Database Issues: DBA On-Call (x2200)
- Network/Firewall: Network On-Call (x2300)
- Emergency (24/7): IT Helpdesk (x2000)
Documentation Statistics
| Document | Size | Pages | Topics |
|---|---|---|---|
| User Guide | 27 KB | 15+ | 8 modules, 3 workflows, troubleshooting |
| Quick Reference | 2.8 KB | 1 | Printable card, shortcuts, checklists |
| Admin Guide | 9.8 KB | 12+ | Services, DB admin, security, disaster recovery |
| Setup Guide | 15 KB | 18+ | 10-phase deployment, configuration, verification |
| Total | 54.6 KB | 46+ | 100+ topics |
Document Version History
| Version | Date | Changes |
|---|---|---|
| 1.0 | 2026-05-30 | Initial comprehensive documentation library |
Tips for Success
✅ Do: - Read the entire User Guide before going live - Print the Quick Reference Card for your desk - Review month-end checklist before closing month - Keep backups verified and off-site - Run disaster recovery drills quarterly
❌ Don't: - Ignore error messages (they help troubleshoot) - Skip the setup phase preparation - Delay month-end reconciliation - Overwrite production backups - Delete old users without archiving their transactions
FAQ
Q: Can I use BEXO offline?
A: The WPF client can run offline, but all data transactions sync when connection restored.
Q: How many companies can BEXO manage?
A: Up to 12 companies in a single instance, with separate financial statements per company.
Q: What if the database gets corrupted?
A: BEXO maintains daily automated backups with 7-day rolling retention. See Admin Guide § Disaster Recovery.
Q: Can I export reports to Excel?
A: Yes, all reports export to CSV/PDF/Excel with full formatting.
Q: How long does payroll processing take?
A: 30 minutes to 1 hour for 45 employees (depends on allowances/deductions complexity).
Q: Is BEXO mobile-friendly?
A: Currently Windows desktop only. Mobile app on future roadmap.
Next Steps
- Bookmark this page — You'll come back here often
- Read your role's guide — Start with the section for your job
- Try the test workflow — Use test credentials to create a sample invoice
- Save Quick Reference — Print or download for your desk
- Contact support — Save the IT helpdesk number in your phone
Questions or feedback? Contact the IT team or your application manager.
Last Updated: 2026-05-30
Documentation Version: 1.0
BEXO Version: Production-Ready (v1.0.0)
This documentation is maintained by the BEXO Development & Operations Team. Updates are posted on the NAS at: /Software/BEXO_Deploy/documentation/