feat: organize documentation into logical subdirectories
✅ Created organized project documentation structure - project/ai-economics/: AI Economics Masters documentation - project/cli/: Command-line interface documentation - project/infrastructure/: System infrastructure and deployment docs - project/requirements/: Project requirements and migration docs - project/completion/: 100% project completion summary - project/workspace/: Workspace strategy and organization ✅ Updated MASTER_INDEX.md to reflect new organization - Added project documentation section with detailed breakdown - Updated navigation to include new subdirectory structure - Maintained existing documentation hierarchy ✅ Updated project/README.md for new organization - Complete project documentation overview - Directory structure explanation - Quick access guide for each subdirectory - Links to related documentation 📊 Documentation Organization Results: - 10 files moved into 6 logical subdirectories - Improved navigation and discoverability - Maintained all existing content and links - Enhanced project documentation structure 🎯 Documentation Status: 100% Organized and Complete
This commit is contained in:
76
docs/project/infrastructure/PRODUCTION_ARCHITECTURE.md
Normal file
76
docs/project/infrastructure/PRODUCTION_ARCHITECTURE.md
Normal file
@@ -0,0 +1,76 @@
|
||||
# AITBC Production Environment
|
||||
|
||||
## 🏗️ Proper System Architecture
|
||||
|
||||
The AITBC production environment follows Linux Filesystem Hierarchy Standard (FHS) compliance:
|
||||
|
||||
### 📁 System Directory Structure
|
||||
|
||||
```
|
||||
/etc/aitbc/production/ # Production configurations
|
||||
├── .env # Production environment variables
|
||||
├── blockchain.py # Blockchain service config
|
||||
├── database.py # Database configuration
|
||||
├── services.py # Services configuration
|
||||
└── certs/ # SSL certificates
|
||||
|
||||
/var/lib/aitbc/production/ # Production services and data
|
||||
├── blockchain.py # Production blockchain service
|
||||
├── marketplace.py # Production marketplace service
|
||||
├── unified_marketplace.py # Unified marketplace service
|
||||
├── openclaw_ai.py # OpenClaw AI service
|
||||
└── backups/ # Production backups
|
||||
|
||||
/var/log/aitbc/production/ # Production logs
|
||||
├── blockchain/ # Blockchain service logs
|
||||
├── marketplace/ # Marketplace service logs
|
||||
└── unified_marketplace/ # Unified marketplace logs
|
||||
```
|
||||
|
||||
### 🚀 Launching Production Services
|
||||
|
||||
Use the production launcher:
|
||||
|
||||
```bash
|
||||
# Launch all production services
|
||||
/opt/aitbc/scripts/production_launcher.py
|
||||
|
||||
# Launch individual service
|
||||
python3 /var/lib/aitbc/production/blockchain.py
|
||||
```
|
||||
|
||||
### ⚙️ Configuration Management
|
||||
|
||||
Production configurations are stored in `/etc/aitbc/production/`:
|
||||
- Environment variables in `.env`
|
||||
- Service-specific configs in Python modules
|
||||
- SSL certificates in `certs/`
|
||||
|
||||
### 📊 Monitoring and Logs
|
||||
|
||||
Production logs are centralized in `/var/log/aitbc/production/`:
|
||||
- Each service has its own log directory
|
||||
- Logs rotate automatically
|
||||
- Real-time monitoring available
|
||||
|
||||
### 🔧 Maintenance
|
||||
|
||||
- **Backups**: Stored in `/var/lib/aitbc/production/backups/`
|
||||
- **Updates**: Update code in `/opt/aitbc/`, restart services
|
||||
- **Configuration**: Edit files in `/etc/aitbc/production/`
|
||||
|
||||
### 🛡️ Security
|
||||
|
||||
- All production files have proper permissions
|
||||
- Keystore remains at `/var/lib/aitbc/keystore/`
|
||||
- Environment variables are protected
|
||||
- SSL certificates secured in `/etc/aitbc/production/certs/`
|
||||
|
||||
## 📋 Migration Complete
|
||||
|
||||
The "box in box" structure has been eliminated:
|
||||
- ✅ Configurations moved to `/etc/aitbc/production/`
|
||||
- ✅ Services moved to `/var/lib/aitbc/production/`
|
||||
- ✅ Logs centralized in `/var/log/aitbc/production/`
|
||||
- ✅ Repository cleaned of production runtime files
|
||||
- ✅ Proper FHS compliance achieved
|
||||
Reference in New Issue
Block a user