oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 7 Packages Projects Releases Wiki Activity
Files
d0d7e8fd5f01ae027dba573252983258171da85b
aitbc/docs/RUNTIME_DIRECTORIES.md
aitbc1 3352d63f36
All checks were successful
AITBC CLI Level 1 Commands Test / test-cli-level1 (push) Successful in 16s
Details
api-endpoint-tests / test-api-endpoints (push) Successful in 35s
Details
integration-tests / test-service-integration (push) Successful in 1m25s
Details
package-tests / test-python-packages (map[name:aitbc-agent-sdk path:packages/py/aitbc-agent-sdk python_version:3.13]) (push) Successful in 16s
Details
package-tests / test-python-packages (map[name:aitbc-cli path:. python_version:3.13]) (push) Successful in 14s
Details
package-tests / test-python-packages (map[name:aitbc-core path:packages/py/aitbc-core python_version:3.13]) (push) Successful in 13s
Details
package-tests / test-python-packages (map[name:aitbc-crypto path:packages/py/aitbc-crypto python_version:3.13]) (push) Successful in 10s
Details
package-tests / test-python-packages (map[name:aitbc-sdk path:packages/py/aitbc-sdk python_version:3.13]) (push) Successful in 12s
Details
package-tests / test-javascript-packages (map[name:aitbc-sdk node_version:24 path:packages/js/aitbc-sdk]) (push) Successful in 18s
Details
python-tests / test-specific (push) Has been skipped
Details
security-scanning / audit (push) Successful in 14s
Details
systemd-sync / sync-systemd (push) Successful in 4s
Details
package-tests / cross-language-compatibility (push) Successful in 2s
Details
package-tests / package-integration-tests (push) Successful in 3s
Details
Documentation Validation / validate-docs (push) Successful in 6m13s
Details
python-tests / test (push) Successful in 14s
Details
feat: major infrastructure refactoring and optimization 
## 🚀 Central Virtual Environment Implementation
- Created central venv at /opt/aitbc/venv for all services
- Updated 34+ systemd services to use central python interpreter
- Fixed PYTHONPATH configurations for proper module imports
- Created aitbc-env wrapper script for environment management

## 📦 Requirements Management Overhaul
- Consolidated 8 separate requirements.txt files into central requirements.txt
- Added web3>=6.11.0 for blockchain functionality
- Created automated requirements migrator tool (scripts/requirements_migrator.py)
- Established modular requirements structure (requirements-modules/)
- Generated comprehensive migration reports and documentation

## 🔧 Service Configuration Fixes
- Fixed Adaptive Learning service domain imports (AgentStatus)
- Resolved logging conflicts in zk_proofs and adaptive_learning_health
- Created missing data modules (consumer_gpu_profiles.py)
- Updated CLI to version 0.2.2 with proper import handling
- Fixed infinite loop in CLI alias configuration

## 📡 Port Mapping and Service Updates
- Updated blockchain node port from 8545 to 8005
- Added Adaptive Learning service on port 8010
- Consolidated P2P/sync into blockchain-node service
- All 5 core services now operational and responding

## 📚 Documentation Enhancements
- Updated SYSTEMD_SERVICES.md for Debian root usage (no sudo)
- Added comprehensive VIRTUAL_ENVIRONMENT.md guide
- Created REQUIREMENTS_MERGE_SUMMARY.md with migration details
- Updated RUNTIME_DIRECTORIES.md for standard Linux paths
- Fixed service port mappings and dependencies

## 🛠️ CLI Improvements
- Fixed import errors and version display (0.2.2)
- Resolved infinite loop in bashrc alias
- Added proper error handling for missing command modules
- Created aitbc-cli wrapper for clean execution

## ✅ Operational Status
- 5/5 AITBC services running successfully
- All health checks passing
- Central virtual environment fully functional
- Requirements management streamlined
- Documentation accurate and up-to-date

## 🎯 Technical Achievements
- Eliminated 7 redundant requirements.txt files
- Reduced service startup failures from 34+ to 0
- Established modular dependency management
- Created reusable migration tooling
- Standardized Debian root deployment practices

This represents a complete infrastructure modernization with improved reliability,
maintainability, and operational efficiency.
2026-03-29 11:52:37 +02:00

1.2 KiB
Raw Blame History

AITBC Runtime Directory Structure

This document outlines the standard Linux system directories used by AITBC for runtime data.

Standard System Directories

/var/lib/aitbc/

Purpose: Application data and databases

  • keystore/ - Blockchain private keys and certificates
  • data/ - Application databases (.db, .sqlite files)
  • logs/ - Application log files

/etc/aitbc/

Purpose: Configuration files

  • Environment files (.env)
  • Service configuration
  • Network settings

/var/log/aitbc/

Purpose: System logging (symlinked from /var/lib/aitbc/logs/)

Security & Permissions

  • Keystore: Restricted permissions (600/700)
  • Config: Read-only for services, writable for admin
  • Logs: Writable by services, readable by admin

Migration from Repo

Runtime data has been moved from /opt/aitbc/data/ to system standard directories:

  • Old: /opt/aitbc/data/keystore/ → New: /var/lib/aitbc/keystore/
  • Old: /opt/aitbc/data/ → New: /var/lib/aitbc/data/

SystemD Integration

Services should be updated to use these standard paths:

  • Environment=KEYSTORE_PATH=/var/lib/aitbc/keystore
  • Environment=DB_PATH=/var/lib/aitbc/data
  • Environment=LOG_PATH=/var/log/aitbc