# dantheman457/projects_2026 architecture

> Architecture diagram of the GitHub repository dantheman457/projects_2026, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dantheman457/projects_2026
- Repository: https://github.com/dantheman457/projects_2026

## Overview

This repository is a collection of three independent console programs: Tic-Tac-Toe, a Sudoku solver, and an N-Queens solver. Each takes input, applies its own game or search logic, and reports a result; they do not share a runtime or call one another. The README establishes the three project capabilities, while the source excerpts show their internal workflows. The map groups each standalone program separately; no shared service or persistence layer is evident.

Main entry points: [`sudoku.cpp`](https://github.com/dantheman457/projects_2026/blob/main/sudoku.cpp) (Console workflow), [`tic_tac.cpp`](https://github.com/dantheman457/projects_2026/blob/main/tic_tac.cpp) (Game loop), [`N_queen.cpp`](https://github.com/dantheman457/projects_2026/blob/main/N_queen.cpp) (Console workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tic["Tic-Tac-Toe"]
  node_tic_app["Game loop<br/>[tic_tac.cpp]"]
  node_tic_board["Board state<br/>[tic_tac.cpp]"]
  node_tic_rules["Win and draw checks<br/>[tic_tac.cpp]"]
end

subgraph group_sudoku["Sudoku Solver"]
  node_sudoku_app["Console workflow<br/>[sudoku.cpp]"]
  node_sudoku_state["Grid and fixed cells<br/>[sudoku.cpp]"]
  node_sudoku_search["Backtracking solver<br/>[sudoku.cpp]"]
  node_sudoku_rules["Placement checks<br/>[sudoku.cpp]"]
  node_sudoku_display["Board display<br/>[sudoku.cpp]"]
end

subgraph group_queens["N-Queens"]
  node_queen_app["Console workflow<br/>[N_queen.cpp]"]
  node_queen_state["Queen board<br/>[N_queen.cpp]"]
  node_queen_search["Backtracking search<br/>[N_queen.cpp]"]
  node_queen_rules["Safety checks<br/>[N_queen.cpp]"]
end

node_player(("Player"))
node_sudoku_user(("Puzzle user"))
node_queen_user(("Puzzle user"))

node_player -->|"enters moves"| node_tic_app
node_tic_app -->|"initializes and updates"| node_tic_board
node_tic_app -->|"checks outcome"| node_tic_rules
node_tic_app -->|"prints game status"| node_player
node_sudoku_user -->|"enters puzzle"| node_sudoku_app
node_sudoku_app -->|"fills grid"| node_sudoku_state
node_sudoku_app -->|"starts solving"| node_sudoku_search
node_sudoku_search -->|"tests placements"| node_sudoku_rules
node_sudoku_app -->|"shows board"| node_sudoku_display
node_sudoku_app -->|"reports result"| node_sudoku_user
node_queen_user -->|"enters size"| node_queen_app
node_queen_app -->|"initializes board"| node_queen_state
node_queen_app -->|"starts search"| node_queen_search
node_queen_search -->|"checks placement"| node_queen_rules
node_queen_app -->|"prints coordinates"| node_queen_user

click node_tic_app "https://github.com/dantheman457/projects_2026/blob/main/tic_tac.cpp"
click node_tic_board "https://github.com/dantheman457/projects_2026/blob/main/tic_tac.cpp"
click node_tic_rules "https://github.com/dantheman457/projects_2026/blob/main/tic_tac.cpp"
click node_sudoku_app "https://github.com/dantheman457/projects_2026/blob/main/sudoku.cpp"
click node_sudoku_state "https://github.com/dantheman457/projects_2026/blob/main/sudoku.cpp"
click node_sudoku_search "https://github.com/dantheman457/projects_2026/blob/main/sudoku.cpp"
click node_sudoku_rules "https://github.com/dantheman457/projects_2026/blob/main/sudoku.cpp"
click node_sudoku_display "https://github.com/dantheman457/projects_2026/blob/main/sudoku.cpp"
click node_queen_app "https://github.com/dantheman457/projects_2026/blob/main/N_queen.cpp"
click node_queen_state "https://github.com/dantheman457/projects_2026/blob/main/N_queen.cpp"
click node_queen_search "https://github.com/dantheman457/projects_2026/blob/main/N_queen.cpp"
click node_queen_rules "https://github.com/dantheman457/projects_2026/blob/main/N_queen.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_tic_app,node_tic_board,node_tic_rules,node_sudoku_user,node_queen_user toneBlue
class node_sudoku_app,node_sudoku_state,node_sudoku_search,node_sudoku_rules,node_sudoku_display toneAmber
class node_queen_app,node_queen_state,node_queen_search,node_queen_rules toneMint
class node_player toneIndigo
```

## Components

### Tic-Tac-Toe

- [Game loop](https://github.com/dantheman457/projects_2026/blob/main/tic_tac.cpp): `tic_tac.cpp`
- [Board state](https://github.com/dantheman457/projects_2026/blob/main/tic_tac.cpp): `tic_tac.cpp`
- [Win and draw checks](https://github.com/dantheman457/projects_2026/blob/main/tic_tac.cpp): `tic_tac.cpp`

### Sudoku Solver

- [Console workflow](https://github.com/dantheman457/projects_2026/blob/main/sudoku.cpp): `sudoku.cpp`
- [Grid and fixed cells](https://github.com/dantheman457/projects_2026/blob/main/sudoku.cpp): `sudoku.cpp`
- [Backtracking solver](https://github.com/dantheman457/projects_2026/blob/main/sudoku.cpp): `sudoku.cpp`
- [Placement checks](https://github.com/dantheman457/projects_2026/blob/main/sudoku.cpp): `sudoku.cpp`
- [Board display](https://github.com/dantheman457/projects_2026/blob/main/sudoku.cpp): `sudoku.cpp`

### N-Queens

- [Console workflow](https://github.com/dantheman457/projects_2026/blob/main/N_queen.cpp): `N_queen.cpp`
- [Queen board](https://github.com/dantheman457/projects_2026/blob/main/N_queen.cpp): `N_queen.cpp`
- [Backtracking search](https://github.com/dantheman457/projects_2026/blob/main/N_queen.cpp): `N_queen.cpp`
- [Safety checks](https://github.com/dantheman457/projects_2026/blob/main/N_queen.cpp): `N_queen.cpp`

### Other components

- **Player**
- **Puzzle user**
- **Puzzle user**

## Connections

- Player → Game loop: enters moves (evidence: `tic_tac.cpp`)
- Game loop → Board state: initializes and updates (evidence: `tic_tac.cpp`)
- Game loop → Win and draw checks: checks outcome (evidence: `tic_tac.cpp`)
- Game loop → Player: prints game status (evidence: `tic_tac.cpp`)
- Puzzle user → Console workflow: enters puzzle (evidence: `sudoku.cpp`)
- Console workflow → Grid and fixed cells: fills grid (evidence: `sudoku.cpp`)
- Console workflow → Backtracking solver: starts solving (evidence: `sudoku.cpp`)
- Backtracking solver → Placement checks: tests placements (evidence: `sudoku.cpp`)
- Console workflow → Board display: shows board (evidence: `sudoku.cpp`)
- Console workflow → Puzzle user: reports result (evidence: `sudoku.cpp`)
- Puzzle user → Console workflow: enters size (evidence: `N_queen.cpp`)
- Console workflow → Queen board: initializes board (evidence: `N_queen.cpp`)
- Console workflow → Backtracking search: starts search (evidence: `N_queen.cpp`)
- Backtracking search → Safety checks: checks placement (evidence: `N_queen.cpp`)
- Console workflow → Puzzle user: prints coordinates (evidence: `N_queen.cpp`)
