🧩 Java Sudoku

🇧🇷 Português

📌 Sobre o projeto

Este é um jogo de Sudoku desenvolvido em Java, com interface gráfica utilizando Swing.

O projeto inclui:

• 🎲 Gerador automático de tabuleiros (utilizando backtracking)
• 🧠 Validação de jogadas em tempo real
• 🔒 Diferenciação entre células fixas e editáveis
• 🖥️ Interface gráfica customizada

---

🚀 Funcionalidades

• Geração de Sudoku válido e aleatório
• Sistema de dificuldade baseado na remoção de números
• Verificação de regras do Sudoku (linha, coluna e bloco 3x3)
• Interface interativa para o usuário

---

🛠️ Tecnologias utilizadas

• Java
• Swing (Javax)
• Programação orientada a objetos

---

▶️ Como executar

1. Clone o repositório:

git clone https://github.com/JoaoFerrett/Sudoku_Java.git

2. Entre na pasta do projeto:

cd Sudoku_Java

3. Compile e execute:

javac src/main/app/UIMain.java
java app.UIMain

---

📂 Estrutura do projeto

src/
 └── main/
     └── java/
         ├── app/        # Classe principal
         ├── model/      # Estruturas do jogo (Board e Space)
         ├── service/    # Lógica (gerador, validação)
         ├── ui/         # Interface gráfica
         └── util/       # Utilitários

---

🔮 Melhorias futuras

• Garantia de solução única
• Sistema de níveis de dificuldade mais avançado
• Solver visual passo a passo
• Melhorias na interface gráfica

---

🇺🇸 English

📌 About the project

This is a Sudoku game developed in Java, featuring a graphical interface built with Swing.

The project includes:

• 🎲 Automatic puzzle generator (using backtracking)
• 🧠 Real-time move validation
• 🔒 Fixed and editable cells
• 🖥️ Custom graphical interface

---

🚀 Features

• Random valid Sudoku generation
• Difficulty system based on number removal
• Rule validation (row, column, and 3x3 grid)
• Interactive user interface

---

🛠️ Technologies

• Java
• Swing (Javax)
• Object-Oriented Programming

---

▶️ How to run

1. Clone the repository:

git clone https://github.com/JoaoFerrett/Java_Sudoku.git

2. Navigate to the project folder:

cd Java_Sudoku

3. Compile and run:

javac src/main/java/app/UIMain.java
java app.UIMain

---

📂 Project structure

src/
 └── main/
     └── java/
         ├── app/
         ├── model/
         ├── service/
         ├── ui/
         └── util/

---

🔮 Future improvements

• Unique solution validation
• Advanced difficulty system
• Step-by-step visual solver
• UI/UX improvements

---

👨‍💻 Author

Developed by João Ferrett