Documentación de Aplicaciones

1/**
2 * Comprueba los datos introducidos en los formularios de la aplicación.
3 * <p>
4 * Todos los métodos son estáticos y no modifican sus argumentos.
5 *
6 * @author Equipo de interfaces
7 * @version 2.1
8 * @since 1.0
9 * @see java.util.regex.Pattern
10 */
11public final class Validador {
12
13    /**
14     * Indica si un NIF español tiene formato válido y su letra de control es correcta.
15     *
16     * @param nif el NIF a comprobar, con o sin espacios; no puede ser {@code null}
17     * @return {@code true} si el NIF es válido
18     * @throws NullPointerException si {@code nif} es {@code null}
19     */
20    public static boolean nifValido(String nif) { … }
21
22    /**
23     * Calcula el precio con descuento.
24     *
25     * @param precio precio original en euros, mayor o igual que 0
26     * @param descuento porcentaje de descuento entre 0 y 100
27     * @return el precio con el descuento aplicado, redondeado a 2 decimales
28     * @throws IllegalArgumentException si algún valor está fuera de rango
29     * @deprecated usar {@link Tarifas#aplicarDescuento(double, int)}
30     */
31    @Deprecated
32    public static double conDescuento(double precio, int descuento) { … }
33}

1javadoc -d docs -author -version -encoding UTF-8 -charset UTF-8 -sourcepath src -subpackages com.empresa
2mvn javadoc:javadoc              # con Maven: target/site/apidocs
3./gradlew dokkaHtml              # Kotlin (KDoc) con Dokka

1// JavaFX: tooltip y ayuda contextual con F1
2TextField nif = new TextField();
3nif.setTooltip(new Tooltip("8 números y una letra, sin espacios"));
4nif.setUserData("ayuda/clientes.html#nif");            // página de ayuda de este campo
5
6scene.getAccelerators().put(new KeyCodeCombination(KeyCode.F1), () -> {
7    Node foco = scene.getFocusOwner();
8    String pagina = (foco != null && foco.getUserData() != null) ? (String) foco.getUserData() : "ayuda/indice.html";
9    WebView vista = new WebView();
10    vista.getEngine().load(getClass().getResource("/" + pagina).toExternalForm());
11    Stage ventana = new Stage();
12    ventana.setTitle("Ayuda");
13    ventana.setScene(new Scene(vista, 700, 500));
14    ventana.show();
15});

1# GestiónClientes
2
3Aplicación de escritorio (JavaFX) para gestionar los clientes y las facturas de una pyme.
4
5## Requisitos
6- Windows 10/11, macOS 13+ o Linux x64
7- 4 GB de RAM · MySQL 8 o MariaDB 10.6
8
9## Instalación
101. Descarga el instalador de la [última versión](https://github.com/empresa/gestion/releases).
112. Ejecuta `GestionClientes-2.1.0.msi` y sigue el asistente.
123. En el primer arranque indica los datos de conexión a la base de datos.
13
14## Desarrollo
15```bash
16git clone https://github.com/empresa/gestion.git
17mvn javafx:run
18```
19
20## Licencia
21MIT — véase [LICENSE](LICENSE).

1## [2.1.0] - 2025-09-30
2### Añadido
3- Exportación de facturas a Excel.
4### Corregido
5- La búsqueda de clientes ignoraba las tildes (#142).
6
7## [2.0.0] - 2025-06-12
8### Cambiado
9- Nueva interfaz con modo oscuro. **Incompatible**: requiere Java 21.