oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 21 Packages Projects Releases Wiki Activity
Files
7f1eff97485099e393195b7bfdbdd881b0ddddba
aitbc/docs/project/infrastructure/PRODUCTION_ARCHITECTURE.md
aitbc 7f1eff9748
Some checks failed
Cross-Node Transaction Testing / transaction-test (push) Successful in 2s
Details
Deploy to Testnet / deploy-testnet (push) Successful in 1m7s
Details
Documentation Validation / validate-docs (push) Failing after 10s
Details
Documentation Validation / validate-policies-strict (push) Successful in 5s
Details
Multi-Node Stress Testing / stress-test (push) Successful in 4s
Details
Node Failover Simulation / failover-test (push) Has started running
Details
docs: update port 8000 references to 8011 in remaining documentation files 
- Update project/infrastructure/PRODUCTION_ARCHITECTURE.md: coordinator URL 8000 → 8011
- Update project/3_infrastructure.md: coordinator URL 8000 → 8011
- Update project/aitbc.md: coordinator URL 8000 → 8011
- Update project/aitbc1.md: coordinator URL 8000 → 8011
- Update reference/16_security-audit-2026-02-13.md: coordinator URL 8000 → 8011
- Update blockchain/cross-chain/CROSS_CHAIN_TRADING_COMPLETE.md: coordinator port 8000 → 8011
- Update blockchain/cross-chain/CROSS_CHAIN_REPUTATION_FINAL_INTEGRATION.md: coordinator URL 8000 → 8011
- Update blockchain/cross-chain/CROSS_CHAIN_REPUTATION_STAGING_DEPLOYMENT.md: coordinator URL 8000 → 8011
- Update backend/documented_AITBC_Port_Logic_Implementation_-_Implementation_C.md: coordinator port 8000 → 8011
- Update architecture/1_system-flow.md: coordinator URL 8000 → 8011
- Update architecture/3_coordinator-api.md: API port 8000 → 8011
- Update architecture/5_marketplace-web.md: API URL 18000 → 8011
- Update testing/test-integration-completed.md: coordinator URL 8000 → 8011
- Update infrastructure/migration/microservices-migration-status.md: coordinator URL 8000 → 8011
- Coordinator API is now on port 8011 (not 8000)
2026-05-08 21:52:50 +02:00

3.5 KiB
Raw Blame History

AITBC Production Environment

🏗️ Proper System Architecture

The AITBC production environment follows Linux Filesystem Hierarchy Standard (FHS) compliance:

📁 System Directory Structure

/etc/aitbc/                    # Production configurations
├── .env                       # Production environment variables
├── blockchain.env             # Blockchain service config
└── production/                # Production-specific configs

/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 logs
├── production/                # Production service logs
├── blockchain/                # Blockchain service logs
└── coordinator/               # Coordinator logs

🚀 Launching Production Services

Services are launched via systemd:

# Start blockchain node
systemctl start aitbc-blockchain-node

# 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/:

  • Environment variables in .env
  • Blockchain config in blockchain.env
  • Service-specific configs in production subdirectory

📊 Monitoring and Logs

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:8011/v1/metrics
  • Prometheus metrics endpoint: http://localhost:8011/metrics
  • Health endpoint: http://localhost:8011/v1/health
  • Web dashboard source: /opt/aitbc/website/dashboards/metrics.html

Current monitoring flow:

  • FastAPI request middleware records request counts, error counts, response time, and cache stats
  • metrics.py calculates live metric summaries and alert thresholds
  • /v1/metrics returns JSON for dashboard consumption
  • /metrics remains available for Prometheus-style scraping
  • Alert delivery uses webhook dispatch when AITBC_ALERT_WEBHOOK_URL is configured, otherwise alerts are logged locally

🔧 Maintenance

  • Backups: Stored in /var/lib/aitbc/backups/
  • Updates: Update code in /opt/aitbc/, restart services
  • Configuration: Edit files in /etc/aitbc/

🛡️ Security

  • All production files have proper permissions
  • Keystore at /var/lib/aitbc/keystore/ (secure, permissions 700)
  • Environment variables are protected
  • SSL certificates in /etc/aitbc/production/certs/ (if used)

📋 Architecture Status

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