ac259ce902
- Implemented WHMCS invoice creation and payment capture in SimManagementService for top-ups. - Updated top-up logic to calculate costs based on GB input, with pricing set at 500 JPY per GB. - Simplified the Top Up Modal interface, removing unnecessary fields and improving user experience. - Added new methods in WhmcsService for invoice and payment operations. - Enhanced error handling for payment failures and added transaction logging for audit purposes. - Updated documentation to reflect changes in the SIM management flow and API interactions.
📚 Customer Portal Documentation
🚀 Quick Start
- Getting Started - Environment setup and initial configuration
- Development Commands - Daily development workflow
- Production Deployment - Docker deployment guide
🏗️ Architecture & Systems
- Address System - Complete address management documentation
- Product Catalog Architecture - SKU-based catalog system
- Portal Data Model - Database schema and relationships
- Ordering & Provisioning - Order processing flow
- System Structure - Overall system architecture
🔧 Technical References
- Logging - Logging standards and practices
- Salesforce Products - Product configuration in Salesforce
- Portal Roadmap - Future development plans
📋 Documentation Standards
When to Update Documentation
- New Features: Update relevant architecture docs
- API Changes: Update technical references
- Configuration Changes: Update getting started guide
- Deployment Changes: Update deployment guide
Documentation Structure
docs/
├── README.md # This index
├── GETTING_STARTED.md # Setup & configuration
├── RUN.md # Development commands
├── DEPLOY.md # Production deployment
├── ADDRESS_SYSTEM.md # Address management
├── PRODUCT-CATALOG-ARCHITECTURE.md # Catalog system
├── PORTAL-DATA-MODEL.md # Database schema
├── PORTAL-ORDERING-PROVISIONING.md # Order processing
├── STRUCTURE.md # System architecture
├── LOGGING.md # Logging practices
├── SALESFORCE-PRODUCTS.md # SF configuration
└── PORTAL-ROADMAP.md # Future plans
🎯 Key Principles
Clean Documentation
- ✅ Single source of truth - No redundant docs
- ✅ Up-to-date - Reflects current implementation
- ✅ Practical - Includes real code examples
- ✅ Organized - Clear structure and navigation
Developer Experience
- ✅ Quick reference - Essential info easily accessible
- ✅ Complete examples - Working code snippets
- ✅ Troubleshooting - Common issues and solutions
- ✅ Testing guidance - How to verify implementations
This documentation reflects the current clean, modern implementation of the Customer Portal system.