db98311b8e
- Created a new .env backup file for the development environment, providing essential configurations for database, Redis, and application settings. - Updated .gitignore to exclude API documentation containing sensitive details. - Refactored token-blacklist service error handling to simplify catch block. - Adjusted Freebit API configuration validation to reflect updated base URL. - Enhanced email service interfaces to allow optional 'from' field. - Improved order orchestrator service to include additional fields in SOQL query. - Added new SIM order activation service and controller for managing SIM activations. - Updated subscriptions module to include new services and controllers for SIM management. - Enhanced error handling in SIM management service for better user feedback. - Refactored various components in the portal for improved user experience and consistency.
📚 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.