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
96 lines
2.5 KiB
Markdown
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.
|