Gabriel Radureau
69e7c44eb2
Added ADR-0018 for User Management and Authentication System with: - Non-persisted admin user with master password authentication - JWT-based authentication with bcrypt password hashing - PostgreSQL database schema and GORM integration - Admin-assisted password reset workflow - Comprehensive security considerations Added ADR-0019 for BDD Feature Structure: - Epic/User Story organization pattern - Unified development workflow - Source of truth hierarchy Added ADR-0020 for Docker Build Strategy: - Multi-stage build approach - Cache optimization strategy - Production vs development build differences Added technical documentation: - Complete user management system specification - API endpoints and integration details - Security architecture and best practices Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Architecture Decision Records (ADRs)
This directory contains Architecture Decision Records (ADRs) for the dance-lessons-coach project.
What is an ADR?
An ADR is a document that captures an important architectural decision made along with its context and consequences.
Format
Each ADR follows this structure:
# [Short title is a few words]
* Status: [Proposed | Accepted | Deprecated | Superseded]
* Deciders: [List of decision makers]
* Date: [YYYY-MM-DD]
## Context and Problem Statement
[Describe the context and problem statement]
## Decision Drivers
* [Driver 1]
* [Driver 2]
* [Driver 3]
## Considered Options
* [Option 1]
* [Option 2]
* [Option 3]
## Decision Outcome
Chosen option: "[Option 1]" because [justification]
## Pros and Cons of the Options
### [Option 1]
* Good, because [argument a]
* Good, because [argument b]
* Bad, because [argument c]
### [Option 2]
* Good, because [argument a]
* Good, because [argument b]
* Bad, because [argument c]
## Links
* [Link type] [Link to ADR]
* [Link type] [Link to ADR]
ADR List
- 0001-go-1.26.1-standard.md - Use Go 1.26.1 as the standard Go version
- 0002-chi-router.md - Use Chi router for HTTP routing
- 0003-zerolog-logging.md - Use Zerolog for structured logging
- 0004-interface-based-design.md - Adopt interface-based design pattern
- 0005-graceful-shutdown.md - Implement graceful shutdown with readiness endpoints
- 0006-configuration-management.md - Use Viper for configuration management
- 0007-opentelemetry-integration.md - Integrate OpenTelemetry for distributed tracing
- 0008-bdd-testing.md - Adopt BDD with Godog for behavioral testing
- 0009-hybrid-testing-approach.md - Combine BDD and Swagger-based testing
- 0010-api-v2-feature-flag.md - API v2 implementation with feature flag control
- 0011-validation-library-selection.md - Selection of go-playground/validator for input validation
- 0012-git-hooks-staged-only-formatting.md - Git hooks format only staged Go files
- 0013-openapi-swagger-toolchain.md - ✅ OpenAPI/Swagger documentation with swaggo/swag (Implemented)
- 0014-grpc-adoption-strategy.md - Hybrid REST/gRPC adoption strategy
- 0015-cli-subcommands-cobra.md - Cobra CLI framework adoption
- 0016-ci-cd-pipeline-design.md - CI/CD pipeline architecture
- 0017-trunk-based-development-workflow.md - Trunk-based development workflow
- 0018-user-management-auth-system.md - User management and authentication system
- 0019-postgresql-integration.md - PostgreSQL database integration
- 0020-docker-build-strategy.md - Docker Build Strategy: Traditional vs Buildx
How to Add a New ADR
- Create a new file with the next available number (e.g.,
0010-new-decision.md) - Follow the template format
- Update this README.md with the new ADR
- Commit the changes
Status Legend
- Proposed: Decision is being discussed
- Accepted: Decision has been made and implemented
- Deprecated: Decision is no longer relevant
- Superseded: Decision has been replaced by another ADR