Files
aitbc/README.md
aitbc 7035f09a8c docs: reorganize project structure and update root README
Project Organization:
- Moved configuration files to project-config/ directory
- Moved documentation files to documentation/ directory
- Moved security reports to security/ directory
- Moved backup files to backup-config/ directory
- Created PROJECT_ORGANIZATION_SUMMARY.md documenting changes
- Updated all script references to new file locations

Root README Simplification:
- Replaced 715-line detailed README with 95-line structure guide
2026-04-02 23:17:02 +02:00

96 lines
2.5 KiB
Markdown

# AITBC - Advanced Intelligence Training Blockchain Consortium
## Project Structure
This project has been organized for better maintainability. Here's the directory structure:
### 📁 Essential Root Files
- `LICENSE` - Project license
- `aitbc-cli` - Main CLI symlink
- `README.md` - This file
### 📁 Core Directories
- `aitbc/` - Core AITBC Python package
- `cli/` - Command-line interface implementation
- `contracts/` - Smart contracts
- `scripts/` - Automation and deployment scripts
- `services/` - Microservices
- `tests/` - Test suites
### 📁 Configuration
- `project-config/` - Project configuration files
- `pyproject.toml` - Python project configuration
- `requirements.txt` - Python dependencies
- `poetry.lock` - Dependency lock file
- `.gitignore` - Git ignore rules
- `.deployment_progress` - Deployment tracking
### 📁 Documentation
- `docs/` - Comprehensive documentation
- `documentation/` - User guides and manuals
- `README.md` - Main project documentation
- `SETUP.md` - Setup instructions
- `PYTHON_VERSION_STATUS.md` - Python compatibility
- `AITBC1_TEST_COMMANDS.md` - Testing commands
- `AITBC1_UPDATED_COMMANDS.md` - Updated commands
### 📁 Development
- `dev/` - Development tools and examples
- `.windsurf/` - IDE configuration
- `packages/` - Package distributions
- `extensions/` - Browser extensions
- `plugins/` - System plugins
### 📁 Infrastructure
- `infra/` - Infrastructure as code
- `systemd/` - System service configurations
- `monitoring/` - Monitoring setup
### 📁 Applications
- `apps/` - Application components
- `services/` - Service implementations
- `website/` - Web interface
### 📁 AI & GPU
- `gpu_acceleration/` - GPU optimization
- `ai-ml/` - AI/ML components
### 📁 Security & Backup
- `security/` - Security reports and fixes
- `backup-config/` - Backup configurations
- `backups/` - Data backups
### 📁 Cache & Logs
- `venv/` - Python virtual environment
- `logs/` - Application logs
- `.mypy_cache/`, `.pytest_cache/`, `.ruff_cache/` - Tool caches
## Quick Start
```bash
# Setup environment
cd /opt/aitbc
source venv/bin/activate
# Install dependencies
pip install -r project-config/requirements.txt
# Run CLI
./aitbc-cli --help
# Run training
./scripts/training/master_training_launcher.sh
```
## Development
See `documentation/SETUP.md` for detailed setup instructions.
## Security
See `security/SECURITY_VULNERABILITY_REPORT.md` for security status.
## License
See `LICENSE` for licensing information.