docs: update mastery plan to v2.0 with multi-chain support, hub/follower topology, and workflow integration
Some checks failed
Package Tests / test-python-packages (map[name:aitbc-agent-sdk path:packages/py/aitbc-agent-sdk]) (push) Waiting to run
Package Tests / test-python-packages (map[name:aitbc-core path:packages/py/aitbc-core]) (push) Waiting to run
Package Tests / test-python-packages (map[name:aitbc-crypto path:packages/py/aitbc-crypto]) (push) Waiting to run
Package Tests / test-python-packages (map[name:aitbc-sdk path:packages/py/aitbc-sdk]) (push) Waiting to run
Package Tests / test-javascript-packages (map[name:aitbc-sdk-js path:packages/js/aitbc-sdk]) (push) Waiting to run
Package Tests / test-javascript-packages (map[name:aitbc-token path:packages/solidity/aitbc-token]) (push) Waiting to run
Documentation Validation / validate-docs (push) Has been cancelled
Integration Tests / test-service-integration (push) Has been cancelled
Python Tests / test-python (push) Has been cancelled
Security Scanning / security-scan (push) Has been cancelled
CLI Tests / test-cli (push) Has been cancelled

- Bump version from 1.0 to 2.0 in OPENCLAW_AITBC_MASTERY_PLAN.md
- Add comprehensive workflow integration section with links to multi-node setup, operations, marketplace, and production workflows
- Document multi-chain runtime support (ait-testnet, ait-devnet) with shared database and chain-aware RPC
- Document hub/follower topology with island management and P2P network architecture
- Add new
This commit is contained in:
aitbc
2026-04-13 18:22:47 +02:00
parent bc96e47b8f
commit ecb76a0ef9
32 changed files with 1241 additions and 4835 deletions

View File

@@ -7,51 +7,62 @@ The AITBC production environment follows Linux Filesystem Hierarchy Standard (FH
### 📁 System Directory Structure
```
/etc/aitbc/production/ # Production configurations
/etc/aitbc/ # Production configurations
├── .env # Production environment variables
├── blockchain.py # Blockchain service config
── database.py # Database configuration
├── services.py # Services configuration
└── certs/ # SSL certificates
├── blockchain.env # Blockchain service config
── production/ # Production-specific configs
/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
/opt/aitbc/services/ # Production service scripts
├── blockchain_http_launcher.py
├── blockchain_simple.py
├── marketplace.py
── ... # Other service scripts
/var/lib/aitbc/ # Runtime data
├── data/ # Blockchain databases
│ ├── blockchain/ # Blockchain data
│ ├── coordinator/ # Coordinator database
│ └── marketplace/ # Marketplace data
├── keystore/ # Cryptographic keys (secure)
└── backups/ # Production backups
/var/log/aitbc/production/ # Production logs
/var/log/aitbc/ # Production logs
├── production/ # Production service logs
├── blockchain/ # Blockchain service logs
── marketplace/ # Marketplace service logs
└── unified_marketplace/ # Unified marketplace logs
── coordinator/ # Coordinator logs
```
### 🚀 Launching Production Services
Use the production launcher:
Services are launched via systemd:
```bash
# Launch all production services
/opt/aitbc/scripts/production_launcher.py
# Start blockchain node
systemctl start aitbc-blockchain-node
# Launch individual service
python3 /var/lib/aitbc/production/blockchain.py
# Start blockchain RPC
systemctl start aitbc-blockchain-rpc
# Start coordinator API
systemctl start aitbc-agent-coordinator
# Check status
systemctl status aitbc-blockchain-node
```
### ⚙️ Configuration Management
Production configurations are stored in `/etc/aitbc/production/`:
Production configurations are stored in `/etc/aitbc/`:
- Environment variables in `.env`
- Service-specific configs in Python modules
- SSL certificates in `certs/`
- Blockchain config in `blockchain.env`
- Service-specific configs in production subdirectory
### 📊 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
Production logs are centralized in `/var/log/aitbc/`:
- Each service has its own log directory
- Logs rotate automatically
- Real-time monitoring available
Coordinator observability endpoints:
- JSON metrics endpoint: `http://localhost:8000/v1/metrics`
@@ -68,22 +79,23 @@ Current monitoring flow:
### 🔧 Maintenance
- **Backups**: Stored in `/var/lib/aitbc/production/backups/`
- **Backups**: Stored in `/var/lib/aitbc/backups/`
- **Updates**: Update code in `/opt/aitbc/`, restart services
- **Configuration**: Edit files in `/etc/aitbc/production/`
- **Configuration**: Edit files in `/etc/aitbc/`
### 🛡️ Security
- All production files have proper permissions
- Keystore remains at `/var/lib/aitbc/keystore/`
- Keystore at `/var/lib/aitbc/keystore/` (secure, permissions 700)
- Environment variables are protected
- SSL certificates secured in `/etc/aitbc/production/certs/`
- SSL certificates in `/etc/aitbc/production/certs/` (if used)
## 📋 Migration Complete
## 📋 Architecture Status
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
The AITBC production environment follows FHS compliance:
- ✅ Configurations in `/etc/aitbc/`
- ✅ Service scripts in `/opt/aitbc/services/`
-Runtime data in `/var/lib/aitbc/`
-Logs centralized in `/var/log/aitbc/`
- ✅ Repository clean of runtime files
- ✅ Proper FHS compliance achieved