docs: add ADR-002 through ADR-010 covering architecture, persistence, frontend, and infrastructure decisions#226
Merged
Conversation
Agent-Logs-Url: https://github.com/xenobiasoft/sudoku/sessions/7d6f9725-dd6e-43b4-b28c-581435a97e48 Co-authored-by: xenobiasoft <6907805+xenobiasoft@users.noreply.github.com>
xenobiasoft
approved these changes
Apr 15, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Continues the ADR authoring session. ADR-001 (Clean Architecture) existed; this adds the remaining nine decisions across all four architectural themes.
ADRs Added
Architecture & Design
ICommand/IQueryabstractions, the 14 commands and 4 queries, pipeline behavior extensibility, and rules prohibiting repository injection in controllersISpecification<T>usage and explicitly flagsGetBySpecificationAsyncinCosmosDbGameRepositoryas technical debt — it issuesSELECT * FROM cand filters in-memory; direct SQL query methods should be preferred until a Cosmos DB expression translator is builtPersistence
IGameRepository: retiresAzureBlobGameRepositoryfrom game persistence, deprecates theUseCosmosDbenv var toggle, documents partition key strategyInMemoryPuzzleRepositoryscoped to puzzle generation: documents theCircularStack<SudokuPuzzle>(100)design and the intentionalNotSupportedExceptiononCreateAsync/LoadAllAsync— prevents contributors from "fixing" it by wiring it to a databaseSudoku.Storage.Azureis retained butAzureBlobGameRepositorymust not be re-registered asIGameRepository; lists candidate repurposing use cases pending a follow-up ADRFrontend
Sudoku.Blazoris maintenance-only; defines explicit exit criteria for Blazor retirement (feature parity + user migration)Infrastructure
sudoku-api,sudoku-blazor,sudoku-react), environment variable injection contract, and why Docker Compose was not chosenappsettings.jsonor App Configuration