Source: data_layer/docs/README-STRUCTURE.md
Database Directory Structure
Purpose: Data, prompts, schemas, and templates ONLY - NO Python code
Python code belongs in: apps/backend/
📁 What Belongs in database/
✅ YES (Data & Configuration)
database/
├── output-styles/ # Prompt components, schemas, templates
│ ├── prompts/
│ │ ├── workflows/*.md # Workflow definitions
│ │ ├── agents/*.md # Agent definitions
│ │ └── components/*.md # Reusable prompt components
│ ├── schemas/
│ │ └── seeds/*.json # JSON schemas
│ ├── examples/
│ │ └── seeds/*.json # Few-shot examples
│ └── templates/
│ ├── html/*.html # HTML templates
│ └── contracts/*.md # Contract templates
├── kb_catalog/ # Knowledge base catalog (data)
└── scripts/ # Data processing scripts (OK if needed)❌ NO (Python Application Logic)
database/services/apps/backend/services/database_services/database/retrieval/apps/backend/services/retrieval/
📁 What Belongs in apps/backend/
✅ ALL Python Application Code
apps/backend/
├── services/ # Business logic services
│ ├── database_services/ # ✅ MOVED FROM database/services/
│ │ ├── league_storage.py
│ │ └── user_preferences.py
│ ├── retrieval/ # ✅ MOVED FROM database/retrieval/
│ │ └── prompt_intelligence.py
│ ├── workflow_orchestrator.py
│ ├── dynamic_workflow_builder.py
│ ├── betting_service.py
│ ├── pipeline_service.py
│ └── ...
├── models/ # Pydantic models
├── routers/ # FastAPI routers
├── stores/ # InMemoryStore, prompt store
├── agents/ # Agent coordinators
└── server.py # FastAPI app🎯 Principle
database/ = Data files only (prompts, schemas, templates, examples)
apps/backend/ = All Python code (services, models, routers, etc.)
This separation ensures:
- ✅ Clear what's data vs code
- ✅ Data can be updated without touching Python
- ✅ Python code is all in one place
- ✅ No confusion about where logic lives
🔄 Import Updates Needed
After moving files, update imports:
# OLD:
from database.services.league_storage import LeagueStorage
from database.retrieval.prompt_intelligence import PromptIntelligence
# NEW:
from apps.backend.services.database_services.league_storage import LeagueStorage
from apps.backend.services.retrieval.prompt_intelligence import PromptIntelligence✅ Migration Complete
- ✅
database/services/→apps/backend/services/database_services/ - ✅
database/retrieval/→apps/backend/services/retrieval/ - ✅
database/now contains only data files - ✅
apps/backend/contains all Python application logic