Infrastructure¶

Docker, containerization, CI/CD pipelines, database migrations, and environment configuration for the Dashtam project.

Contents¶

This directory contains infrastructure and DevOps documentation covering Docker setup, environments, database migrations, and continuous integration/deployment workflows.

Directory Structure¶

infrastructure/
├── docker-setup.md                  # Multi-environment Docker configuration
├── environment-flows.md             # Development, test, and CI/CD workflows
├── database-migrations.md           # Alembic migration system and best practices
├── ci-cd.md                         # GitHub Actions CI/CD pipeline
└── index.md                         # This file

Documents¶

Container & Environment Setup¶

• Docker Multi-Environment Setup - Comprehensive Docker architecture with dev, test, and CI configurations
• Multi-stage Dockerfile
• Docker Compose configurations
• Network and service configuration

• Volume management and security

• Environment Flows - Development, test, and CI/CD environment workflows

• Environment-specific configurations
• Service initialization and health checks
• Local development process flow
• Testing environment setup
• CI/CD environment configuration

Database Management¶

• Database Migrations - Alembic migration system and best practices
• Migration creation and management
• Async SQLAlchemy support
• Safe schema evolution
• Production deployment strategies
• Testing migrations in isolation

CI/CD Pipeline¶

• CI/CD Pipeline - GitHub Actions workflow and automation
• Workflow configuration and triggers
• Test execution in Docker
• Coverage reporting and Codecov integration
• Branch protection requirements
• Automated deployment processes

Quick Links¶

Related Documentation:

• Docker Refactoring Guide - Docker migration implementation details
• Architecture Overview - System design
• Testing Strategy - Testing approach

Development Workflows:

• Git Workflow Guide - Version control and branching
• UV Package Management - Dependency management

External Resources:

• Docker Documentation - Official Docker reference
• Docker Compose Reference
• Alembic Documentation
• GitHub Actions Documentation

Navigation¶

Parent Directory: ../index.md

Related Directories:

• Architecture - System design and decisions
• Development Guides - How-to guides and tutorials
• Testing - Testing documentation

Contributing¶

When adding new infrastructure documentation to this directory:

1. Choose appropriate infrastructure-template.md (located in docs/templates/) - Use for infrastructure and operations docs
2. Document both local development and production setups
3. Include configuration examples and troubleshooting steps
4. Use Mermaid diagrams for environment flows
5. Document health checks and monitoring requirements
6. Update this index with a link and brief description
7. Run markdown linting: make lint-md-file FILE="path/to/file.md"

Document Information¶

Template: index-section-template.md Created: 2025-10-03 Last Updated: 2025-10-21