Files
aitbc/docs/reference/REPOSITORY_STRUCTURE.md
aitbc a7fbf58462
Some checks failed
Cross-Node Transaction Testing / transaction-test (push) Successful in 3s
Deploy to Testnet / deploy-testnet (push) Successful in 1m6s
Documentation Validation / validate-docs (push) Failing after 9s
Documentation Validation / validate-policies-strict (push) Successful in 5s
Multi-Node Stress Testing / stress-test (push) Successful in 3s
Node Failover Simulation / failover-test (push) Failing after 4s
docs: merge docs/project files into appropriate doc directories
- Moved ai-economics/ to docs/ai-economics/
- Moved completion/ to docs/completion/
- Merged cli/ with docs/cli/
- Merged infrastructure/ with docs/infrastructure/
- Moved planning/ to docs/planning/
- Moved requirements/ to docs/requirements/
- Moved workspace/ to docs/development/workspace/
- Moved 1_files.md to docs/reference/REPOSITORY_STRUCTURE.md
- Moved 2_roadmap.md to docs/ROADMAP.md
- Moved 3_infrastructure.md to docs/infrastructure/INFRASTRUCTURE.md
- Moved SECURITY.md to docs/security/SECURITY.md
- Moved PROJECT_STRUCTURE.md to docs/archive/GPU_PROJECT_STRUCTURE.md
- Moved WORKING_SETUP.md to docs/guides/getting-started/WORKING_SETUP.md
- Moved E2E_TEST_CREATION_SUMMARY.md to docs/reports/E2E_TEST_CREATION_SUMMARY.md
- Moved SQLMODEL_METADATA_FIX_SUMMARY.md to docs/reports/SQLMODEL_METADATA_FIX_SUMMARY.md
- Moved GITHUB_PULL_SUMMARY.md to docs/reports/GITHUB_PULL_SUMMARY.md
- Moved GIFT_CERTIFICATE_newuser.md to docs/guides/getting-started/GIFT_CERTIFICATE.md
- Moved user_profile_newuser.md to docs/guides/getting-started/USER_PROFILE.md
- Moved aitbc.md to docs/infrastructure/NODE_AITBC.md
- Moved aitbc1.md to docs/infrastructure/NODE_AITBC1.md
- Updated project/README.md with new documentation locations
- Removed empty subdirectories from docs/project/
- Created docs/MERGE_PLAN.md for reference
2026-05-09 21:52:55 +02:00

2.0 KiB

AITBC Repository File Structure

This document describes the current organization and status of files and folders in the repository. A current snapshot appears first, followed by a short list of related docs.

Last updated: 2026-04-27

Current Snapshot

This is the authoritative layout of the repository root at /opt/aitbc.

/opt/aitbc/
├── apps/
├── cli/
├── contracts/
├── dev/
├── docs/
├── examples/
├── extensions/
├── infra/
├── packages/
├── plugins/
├── scripts/
├── systemd/
├── tests/
├── website/
├── build/            # generated output
├── venv/             # local virtualenv
└── agent_registry.db # runtime database

Main directories at a glance

  • apps/ — application and service packages
  • cli/ — CLI entrypoints and command modules
  • contracts/ — Solidity contracts and deployment tooling
  • dev/ — developer utilities and local helpers
  • docs/ — documentation tree, including guides/, project/, infrastructure/, reference/, and workflows/
  • packages/py/ — shared Python libraries (aitbc-agent-sdk, aitbc-core, aitbc-crypto, aitbc-sdk)
  • plugins/ — plugin integrations such as Ollama
  • scripts/ — CI, deployment, development, monitoring, service, testing, utility, and wrapper scripts
  • systemd/ — standardized service units
  • tests/ — repository-wide test suites and fixtures
  • website/ — public site, dashboards, docs portal, and wallet assets

Notes

  • Repo root: /opt/aitbc
  • Legacy home paths: historical only
  • Deployment docs: see docs/project/3_infrastructure.md and docs/project/5_done.md

See Also

  • docs/project/3_infrastructure.md
  • docs/project/5_done.md
  • docs/guides/getting-started/

This page intentionally stays short. For detailed historical context, use the infrastructure and completed-deployments docs above.