# acms2345/xadrez-em-c architecture

> Architecture diagram of the GitHub repository acms2345/xadrez-em-c, 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/acms2345/xadrez-em-c
- Repository: https://github.com/acms2345/xadrez-em-c

## Overview

This is a local, terminal-based, two-player chess game. Players choose a language and start or resume a game from the menu; during play they enter moves, which are validated before the game updates its state and checks for wins or draws. The game also supports saving/loading, replaying move history, scoring, colored board output, and Portuguese/English text. Edges reflect calls visible in excerpts and menu-documented behavior; save/load details and some game stages are not fully shown in the sampled code.

Main entry points: [`jogo.c`](https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c) (Game loop), [`menu.c`](https://github.com/acms2345/xadrez-em-c/blob/main/menu.c) (Main menu), [`replay.c`](https://github.com/acms2345/xadrez-em-c/blob/main/replay.c) (Move replay), [`traducao.c`](https://github.com/acms2345/xadrez-em-c/blob/main/traducao.c) (Translation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and interface"]
  node_menu["Main menu<br/>[menu.c]"]
end

subgraph group_play["Chess gameplay"]
  node_game["Game loop<br/>[jogo.c]"]
  node_move_input["Move input<br/>[jogo.c]"]
  node_rules["Move rules<br/>[jogadasvalidas.c]"]
  node_outcomes["Win and draw checks<br/>[jogadasvalidas.c]"]
  node_game_state["Board and scoring<br/>[jogo.c]"]
  node_save_load["Save and load<br/>[jogo.c]"]
  node_saved_file[("Save slot")]
end

subgraph group_history["Game history"]
  node_replay["Move replay<br/>[replay.c]"]
  node_position_history["Position history<br/>[jogadasvalidas.c]"]
  node_move_history["Move history<br/>[jogo.c]"]
end

subgraph group_shared["Shared presentation"]
  node_board_display["Board display<br/>[jogo.c]"]
  node_translation["Translation<br/>[traducao.c]"]
  node_terminal_utils["Terminal helpers<br/>[utils.c]"]
  node_colors["Terminal colors<br/>[cores.h]"]
end

node_players(("Two players"))

node_players -->|"choose language"| node_menu
node_menu -->|"sets language"| node_translation
node_menu -->|"starts or resumes"| node_game
node_menu -->|"opens replay"| node_replay
node_players -->|"enter moves"| node_move_input
node_game -->|"requests coordinates"| node_move_input
node_game -->|"validates moves"| node_rules
node_game -->|"updates board"| node_game_state
node_game -->|"checks results"| node_outcomes
node_game -->|"saves or loads"| node_save_load
node_save_load -->|"reads or writes"| node_saved_file
node_game -->|"renders board"| node_board_display
node_game -.->|"records moves"| node_move_history
node_game -.->|"records positions"| node_position_history
node_replay -->|"reads moves"| node_move_history
node_replay -->|"reads positions"| node_position_history
node_replay -->|"renders replay board"| node_board_display
node_menu -->|"uses helpers"| node_terminal_utils
node_game -.->|"uses helpers"| node_terminal_utils
node_rules -->|"gets messages"| node_translation
node_terminal_utils -->|"gets messages"| node_translation
node_board_display -->|"uses color codes"| node_colors
node_replay -->|"uses color codes"| node_colors
node_game -->|"displays messages"| node_translation

click node_menu "https://github.com/acms2345/xadrez-em-c/blob/main/menu.c"
click node_game "https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c"
click node_move_input "https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c"
click node_rules "https://github.com/acms2345/xadrez-em-c/blob/main/jogadasvalidas.c"
click node_outcomes "https://github.com/acms2345/xadrez-em-c/blob/main/jogadasvalidas.c"
click node_game_state "https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c"
click node_save_load "https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c"
click node_replay "https://github.com/acms2345/xadrez-em-c/blob/main/replay.c"
click node_position_history "https://github.com/acms2345/xadrez-em-c/blob/main/jogadasvalidas.c"
click node_move_history "https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c"
click node_board_display "https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c"
click node_translation "https://github.com/acms2345/xadrez-em-c/blob/main/traducao.c"
click node_terminal_utils "https://github.com/acms2345/xadrez-em-c/blob/main/utils.c"
click node_colors "https://github.com/acms2345/xadrez-em-c/blob/main/cores.h"

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_menu toneBlue
class node_game,node_move_input,node_rules,node_outcomes,node_game_state,node_save_load,node_saved_file toneAmber
class node_replay,node_position_history,node_move_history toneMint
class node_board_display,node_translation,node_terminal_utils,node_colors toneRose
class node_players toneIndigo
```

## Components

### Entry and interface

- [Main menu](https://github.com/acms2345/xadrez-em-c/blob/main/menu.c): `menu.c`

### Chess gameplay

- [Game loop](https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c): `jogo.c`
- [Move input](https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c): `jogo.c`
- [Move rules](https://github.com/acms2345/xadrez-em-c/blob/main/jogadasvalidas.c): `jogadasvalidas.c`
- [Win and draw checks](https://github.com/acms2345/xadrez-em-c/blob/main/jogadasvalidas.c): `jogadasvalidas.c`
- [Board and scoring](https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c): `jogo.c`
- [Save and load](https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c): `jogo.c`
- **Save slot**

### Game history

- [Move replay](https://github.com/acms2345/xadrez-em-c/blob/main/replay.c): `replay.c`
- [Position history](https://github.com/acms2345/xadrez-em-c/blob/main/jogadasvalidas.c): `jogadasvalidas.c`
- [Move history](https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c): `jogo.c`

### Shared presentation

- [Board display](https://github.com/acms2345/xadrez-em-c/blob/main/jogo.c): `jogo.c`
- [Translation](https://github.com/acms2345/xadrez-em-c/blob/main/traducao.c): `traducao.c`
- [Terminal helpers](https://github.com/acms2345/xadrez-em-c/blob/main/utils.c): `utils.c`
- [Terminal colors](https://github.com/acms2345/xadrez-em-c/blob/main/cores.h): `cores.h`

### Other components

- **Two players**

## Connections

- Two players → Main menu: choose language (evidence: `menu.c`)
- Main menu → Translation: sets language (evidence: `menu.c`)
- Main menu → Game loop: starts or resumes (evidence: `menu.c`)
- Main menu → Move replay: opens replay (evidence: `menu.c`)
- Two players → Move input: enter moves (evidence: `README.md`)
- Game loop → Move input: requests coordinates (evidence: `jogo.c`)
- Game loop → Move rules: validates moves (evidence: `jogo.c`)
- Game loop → Board and scoring: updates board (evidence: `jogo.c`)
- Game loop → Win and draw checks: checks results (evidence: `jogo.c`)
- Game loop → Save and load: saves or loads (evidence: `README.md`)
- Save and load → Save slot: reads or writes (evidence: `README.md`)
- Game loop → Board display: renders board (evidence: `jogo.c`)
- Game loop → Move history: records moves (evidence: `jogo.c`)
- Game loop → Position history: records positions
- Move replay → Move history: reads moves (evidence: `replay.c`)
- Move replay → Position history: reads positions (evidence: `replay.c`)
- Move replay → Board display: renders replay board (evidence: `replay.c`)
- Main menu → Terminal helpers: uses helpers (evidence: `menu.c`)
- Game loop → Terminal helpers: uses helpers
- Move rules → Translation: gets messages (evidence: `jogadasvalidas.c`)
- Terminal helpers → Translation: gets messages (evidence: `utils.c`)
- Board display → Terminal colors: uses color codes (evidence: `jogo.c`)
- Move replay → Terminal colors: uses color codes (evidence: `replay.c`)
- Game loop → Translation: displays messages (evidence: `jogo.c`)
