mirror of
https://github.com/johndoe6345789/metabuilder.git
synced 2026-04-25 06:14:59 +00:00
86 lines
3.1 KiB
Markdown
86 lines
3.1 KiB
Markdown
# DBAL - Data Bus Abstraction Layer
|
|
|
|
The DBAL (Data Bus Abstraction Layer) provides a comprehensive implementation guide and source code documentation for the distributed data architecture that powers MetaBuilder.
|
|
|
|
## 📚 Documentation
|
|
|
|
### Getting Started
|
|
|
|
- [Quick Start Guide](../shared/docs/QUICK_START.md) - Setup and first steps
|
|
- [README](./README.md) - Project overview
|
|
|
|
### Implementation Guides
|
|
|
|
- [Phase 2 Implementation](../shared/docs/PHASE2_IMPLEMENTATION.md) - Version 2 features and design
|
|
- [Phase 2 Complete](../shared/docs/PHASE2_COMPLETE.md) - Implementation completion status
|
|
- [Implementation Summary](../shared/docs/IMPLEMENTATION_SUMMARY.md) - Feature overview
|
|
|
|
### Architecture
|
|
|
|
- [Project Documentation](./PROJECT.md) - Complete project reference
|
|
- [Agent Instructions](./AGENTS.md) - AI development guidelines
|
|
|
|
## 📂 Directory Structure
|
|
|
|
```
|
|
dbal/
|
|
├── README.md # Quick reference
|
|
├── LICENSE # MIT License
|
|
├── .gitignore # Git ignore rules
|
|
├── docs/ # Documentation
|
|
│ ├── README.md # Main project documentation
|
|
│ ├── README_INDEX.md # Documentation index
|
|
│ ├── PROJECT.md # Complete project reference
|
|
│ ├── AGENTS.md # AI development guidelines
|
|
│ ├── RESTRUCTURE_SUMMARY.md # Restructure details
|
|
│ └── BEFORE_AFTER.md # Before/after comparison
|
|
├── development/ # TypeScript implementation (fast iteration)
|
|
├── production/ # C++ implementation (security & performance)
|
|
└── shared/ # Shared resources
|
|
├── api/ # API specifications (YAML contracts)
|
|
├── backends/ # Backend implementations (Prisma, SQLite)
|
|
├── common/ # Shared utilities and contracts
|
|
├── docs/ # Additional documentation
|
|
├── scripts/ # Utility scripts
|
|
└── tools/ # Development tools (codegen, build assistant)
|
|
```
|
|
|
|
## 🎯 Key Concepts
|
|
|
|
DBAL provides:
|
|
|
|
- **Abstraction Layer** - Unified interface across multiple backends
|
|
- **Type Safety** - Full TypeScript support
|
|
- **Performance** - Optimized C++ implementations
|
|
- **Flexibility** - Multiple backend options (SQL, NoSQL, etc.)
|
|
- **Reliability** - Comprehensive test coverage
|
|
- **Documentation** - Extensive guides and examples
|
|
|
|
## 📖 Common Tasks
|
|
|
|
### Understanding DBAL Architecture
|
|
|
|
See [PROJECT.md](./PROJECT.md) for complete architecture documentation.
|
|
|
|
### Setting Up Development Environment
|
|
|
|
See [QUICK_START.md](./shared/docs/QUICK_START.md) for setup instructions.
|
|
|
|
### Implementing New Features
|
|
|
|
See [PHASE2_IMPLEMENTATION.md](./shared/docs/PHASE2_IMPLEMENTATION.md) for design patterns.
|
|
|
|
### AI-Assisted Development
|
|
|
|
See [AGENTS.md](./AGENTS.md) for guidelines on working with AI development tools.
|
|
|
|
## 🔗 Related Documentation
|
|
|
|
- [MetaBuilder Root README](../README.md)
|
|
- [Architecture Guides](../docs/architecture/)
|
|
- [Database Guide](../docs/architecture/database.md)
|
|
|
|
## 📄 License
|
|
|
|
See [LICENSE](./LICENSE) file.
|