Feature: Add Local Docker Compose Development Stack

[3m1n3nc3]

Description

Provide a reproducible local API, PostgreSQL, Redis, and worker stack.

File Location

learnault-api/docker-compose.yml, development Dockerfile, .env.example, and docs

Design Reference

API Roadmap Phase 0: Add Local Docker Compose Development Stack.

Dependencies

• Status: Blocked
• Blocked by: Feature: Repair Clean Install and Prisma Generation #67 (Repair Clean Install and Prisma Generation) — done
• Blocks: Feature: Add Isolated Integration Test Database Lifecycle #70 (Add Isolated Integration Test Database Lifecycle) — done; Feature: Add Staging Deployment Rollback and Smoke Tests #74 (Add Staging Deployment Rollback and Smoke Tests) — done

Tasks

• Define API, worker, PostgreSQL, and Redis services
• Add health checks and dependency startup behavior
• Run migrations and seeds explicitly
• Add safe persistent-volume and reset instructions
• Support logs and graceful shutdown
• Add compose validation and smoke test

Acceptance Criteria

• One command starts a healthy stack
• Readiness waits for dependencies
• Migrations and seeds are deterministic
• Reset is project-scoped
• Smoke test passes

Verification Evidence

• Attach compose config, healthy service status, and smoke-test output

Difficulty

Medium

[Fabluchy]

Hi maintainer, please assign this issue to me

[grantfox-oss]

🦊 GrantFox — @Fabluchy has been assigned to this issue as part of the Third Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #125)
2. Your PR will be reviewed by the learnault maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Third Campaign campaign!

@Fabluchy's PR #144 was approved and merged by @3m1n3nc3.

🏆 @Fabluchy: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (764 total points). Track your full progress on GrantFox.

👏 Great work, @Fabluchy! Keep contributing to learnault.