Files
aitbc/docs/infrastructure/app-shell-classification.md
aitbc 573aae065b
Some checks failed
API Endpoint Tests / test-api-endpoints (push) Successful in 56s
Blockchain Synchronization Verification / sync-verification (push) Failing after 3s
CLI Tests / test-cli (push) Failing after 5s
Coverage Phase 1 (70% Target) / test-coverage-70 (push) Failing after 19s
Coverage Phase 2 (85% Target) / test-coverage-85 (push) Failing after 18s
Cross-Chain Functionality Tests / test-cross-chain-sync (push) Successful in 3s
Cross-Chain Functionality Tests / test-cross-chain-transactions (push) Successful in 4s
Cross-Chain Functionality Tests / test-multi-chain-consensus (push) Successful in 5s
Deploy to Testnet / deploy-testnet (push) Failing after 21s
Documentation Validation / validate-docs (push) Failing after 13s
Documentation Validation / validate-policies-strict (push) Successful in 4s
Integration Tests / test-service-integration (push) Failing after 2s
Multi-Chain Island Architecture Tests / test-multi-chain-island (push) Successful in 4s
Multi-Node Blockchain Health Monitoring / health-check (push) Failing after 14s
Node Failover Simulation / failover-test (push) Successful in 9s
P2P Network Verification / p2p-verification (push) Successful in 5s
Package Tests / Python package - aitbc-agent-sdk (push) Successful in 51s
Package Tests / Python package - aitbc-core (push) Failing after 3s
Package Tests / Python package - aitbc-crypto (push) Successful in 22s
Package Tests / Python package - aitbc-sdk (push) Successful in 16s
Package Tests / JavaScript package - aitbc-sdk-js (push) Successful in 21s
Package Tests / JavaScript package - aitbc-token (push) Failing after 18s
Production Tests / Production Integration Tests (push) Failing after 1m9s
Python Tests / test-python (push) Failing after 3s
Security Scanning / security-scan (push) Failing after 41s
Smart Contract Tests / test-solidity (map[name:aitbc-contracts path:contracts]) (push) Failing after 6s
Smart Contract Tests / test-solidity (map[name:aitbc-token path:packages/solidity/aitbc-token]) (push) Failing after 7s
Smart Contract Tests / test-foundry (push) Failing after 20s
Smart Contract Tests / lint-solidity (push) Failing after 4s
Smart Contract Tests / deploy-contracts (push) Failing after 5s
Cross-Chain Functionality Tests / aggregate-results (push) Successful in 2s
Multi-Node Stress Testing / stress-test (push) Successful in 2s
Cross-Node Transaction Testing / transaction-test (push) Successful in 3s
feat: complete codebase remediation with all phases
Phase 1: Security fixes
- Added CORSMiddleware to marketplace-service with specific origins
- Fixed blockchain-node auth to fail closed on JWT errors
- Added security regression tests (test_cors_configuration.py, test_dispute_auth.py)

Phase 2: Repository cleanup
- Removed 51 fix/backup/legacy files
- Deleted marketplace-service-debug directory

Phase 3.1: Python version constraints
- Updated aitbc-crypto and aitbc-sdk with requires-python >=3.13
- Added explicit [tool.poetry].packages declarations

Phase 3.2: Agent service DI architecture
- Created aitbc-agent-core package with protocols and shared service
- Implemented adapters for agent-management and coordinator-api
- Created factory functions for gradual migration
- Added migration comments to existing integration files

Phase 4.1: Auth/utils extraction
- Created auth.py module with JWT validation and security utilities
- Created utils.py module with common helpers

Phase 4.2: Router decomposition
- Decomposed router.py into 10 domain modules (58 endpoints)
- Created route table snapshot for verification
- Preserved router_old.py as reference

Phase 5: App shell classification
- Documented app shell patterns across services

Phase 6: Quality gates
- Verified mypy type checking (75% error reduction)
- Analyzed logging inconsistencies with structlog migration plan
- Removed unused orjson dependency

Documentation:
- Created comprehensive remediation report
- Added architecture documentation for DI pattern
- Added quality analysis documents
2026-05-24 20:21:23 +02:00

60 lines
2.4 KiB
Markdown

# App Shell Classification
This document classifies app shells and thin services in the AITBC repository.
## Classification
### Active Services
| Service | Status | Purpose | Dependencies |
|---------|--------|---------|--------------|
| `shared-domain` | **ACTIVE** | Shared domain models (agent, performance, portfolio, etc.) used by agent-management and other services | Used by `aitbc-agent-management` |
| `shared-core` | **ACTIVE** | Shared core utilities (config, database, logging, security) for microservices | Used by root aitbc package |
| `marketplace-service` | **ACTIVE** | Production GPU marketplace service with proper packaging | Standard Poetry app |
| `docs/enterprise` | **ACTIVE** | Enterprise integration documentation | Documentation only |
### Candidates for Removal
| Service | Status | Reason | Action |
|---------|--------|--------|--------|
| `marketplace-service-debug` | **REMOVE** | Debug variant without pyproject.toml; redundant given marketplace-service exists | Remove directory |
### Non-Existent
| Service | Status | Reason |
|---------|--------|--------|
| `docs/ai-models` | N/A | Directory does not exist |
## Service Boundaries
### shared-domain
- **Purpose**: Centralized domain models for AITBC microservices
- **Contents**: Agent, performance, portfolio, AMM, analytics, bounty, certification, reputation, trading, etc.
- **Consumers**: `aitbc-agent-management`
- **Location**: `/opt/aitbc/apps/shared-domain/src/app/domain/`
### shared-core
- **Purpose**: Shared core utilities (config, database, logging, security)
- **Contents**: Configuration management, database utilities, structured logging, security helpers
- **Consumers**: Root aitbc package and microservices
- **Location**: `/opt/aitbc/apps/shared-core/src/app/core/`
### marketplace-service
- **Purpose**: Production GPU marketplace service
- **Contents**: FastAPI app with marketplace operations
- **Location**: `/opt/aitbc/apps/marketplace-service/`
## Actions Taken
- [x] Classified `shared-domain` as ACTIVE
- [x] Classified `shared-core` as ACTIVE
- [x] Classified `marketplace-service` as ACTIVE
- [x] Classified `marketplace-service-debug` for removal
- [x] Documented `docs/enterprise` as active documentation
- [ ] Remove `marketplace-service-debug` directory
## References
- Roadmap: `/root/.windsurf/plans/aitbc-codebase-remediation-roadmap-5659ea.md`
- Analysis: `.hermes/plans/2026-05-12_102100-aitbc-codebase-analysis.md`