📘 DOCUMENTACIÓ DEL PROJECTE: Jo(F)X

---

👤 1. Descripció General

Jo(F)X és una aplicació amb interfície gràfica feta en JavaFX on els usuaris es poden registrar i iniciar sessió. Un cop autenticats, poden accedir a una selecció de quatre miniaplicacions:

• 🎨 Píxel Art: eina per dibuixar amb píxels com si fos una quadrícula.
• 💣 Pescamines: versió gràfica del clàssic joc de mines.
• 🌱 Joc de la Vida: simulació de l’autòmat cel·lular de Conway.
• 🌤️ Wordle: versió pròpia del joc de paraules.

---

🛠️ 2. Tecnologies Utilitzades

• Java (JDK 21)
• JavaFX 21.0.7 per la interfície gràfica
• Base de dades (MariaDB)
• JDBC per la connexió a la base de dades
• Tot es compila manualment amb el IDE Eclipse

---

🗂️ 3. Estructura del Projecte

🗁 MiniJocsFX
 ├️ 🗂 src/
 │ ├️ 🗂 imgs/            → Imatges, icones, sons
 │ ├️ 🗂 auth/            → Login, registre, gestió d'usuaris (amb BBDD)
 │ ├️ 🗂 ui/              → Pantalles i navegació general
 │ ├️ 🗂 pixelart/        → Mòdul del joc Píxel Art
 │ ├️ 🗂 minesweeper/     → Mòdul del joc Pescamines
 │ ├️ 🗂 jocvida/         → Joc de la Vida (Game of Life)
 │ ├️ 🗂 wordle/          → Joc Wordle
 │ └️ 📜 Main.java        → Inici de l'aplicació
 ├️ scriptCreateJoFX.sql  → Script creació de BBDD
 └️ README.md

---

🗄️ 4. UML per a BBDD

---

✏️ 5. Paleta de colors

🎨 Paleta de Colors MiniJocsFX

• #2a7963 → Verd Clar (Botó Accedir, enllaç)
• #0d262e → Blau Obscur (Background/Fons)
• #365057 → Blau Clar (Camps d’Escriure)
• #e8e8e8 → Blanc Brut (Text que pareix blanc)
• #141414 → Gris Obscur (Text Botó Enrere)
• #e4a81d → Groc Càlid (Wordle)
• #43a047 → Verd Potent (Wordle)

---

✏️ 6. Disseny de l’app

Imatge de fons

Logotip del programa (combinació amb les lletres dels membres)

Aspecte de referencia de les finestres (al final podria ser diferent)

Finestra Registre

Finestra del Menu principal de cada usuari

Finestres Joc de la Vida

Finestres PixelArt

Finestres Pescamines

Finestra Wordle

---

🔐 7. Sistema d’Usuari

• Els usuaris es registren i les dades es guarden a la base de dades.
• El sistema comprova les credencials amb JDBC.
• Si la connexió és correcta, l’usuari accedeix al menú principal.

---

🎮 8. Jocs Inclosos

1. Píxel Art

• L’usuari pot pintar en una graella de cel·les.
• Opcions de color, reinici i guardat/exportació.

2. Pescamines

• Joc de mines amb interfície gràfica.
• S'actualitza el tauler en cada clic.

3. Joc de la Vida (Conway)

• L’usuari configura una disposició inicial i veu la simulació.

4. Wordle

• Joc on cal endevinar una paraula en 6 intents.
• El sistema mostra si una lletra està ben col·locada, existeix o no.

---

⚙️ 9. Compilació i Execució

Si es fa des de terminal:

javac --module-path /ruta/javafx-sdk-21.0.7/lib --add-modules javafx.controls,javafx.fxml,javafx.media -d bin src/Main.java

java --module-path /ruta/javafx-sdk-21.0.7/lib --add-modules javafx.controls,javafx.fxml,javafx.media -cp bin Main

Si es fa des de Eclipse > main > run as > run configurations > arguments:

javac --module-path /ruta/javafx-sdk-21.0.7/lib --add-modules javafx.controls,javafx.fxml,javafx.media

---

✏️ 10. To-Do

---

👨‍💻 11. Autors

• Nom: Lluis, Helena, Patryk, Yordan, Moha
• Data: Maig 2025