# Convenciones generales

## Conversación
- Siempre respondé en castellano.
- En tu respuesta Claude, al final de todo indica archivos creados, modificados y eliminados, mostrando rutas completas relativas al proyecto. De esta forma:
     Archivos modificados
        - ejemplo/ejemplo/ejemplo.tsx
    Archivos creados
        - ejemplo/ejemplo/ejemplo.ts
    Archivos eliminados
        - ejemplo/ejemplo/ejemplo.js

## Lenguaje de programacion y versión
- Este desarrollo debe realizarse para PHP 8.2 FPM

## Convenciones de nombres
- Respetar la nomenclatura de archivos utilizando únicamente minúsculas y separando las palabras mediante guiones medios (-).
Ejemplo: mi-perfil-asociado.php

## HTML
- Utilizar HTML semántico siempre que sea posible.
- Mantener el código limpio y correctamente indentado.
- Limita los campos en cantidad de caracteres, ningún campo debe ser de carga infinita.
- Siempre que se realice un listar y haya un texto muy largo limitarlo y poner puntos suspensivos al final.
- Las tablas siempre deben tener la posibilidad de ordenamiento al tocar los titulos (ascendente y descendente).

## CSS
- No utilizar estilos en línea (`style=""`) ni etiquetas `<style>`.
- Todos los estilos deben ubicarse en `/includes/css/styles.css`.
- Si el proyecto crece, dividir los estilos en archivos independientes dentro de `/includes/css/`.

## Javascript
- No escribir código JavaScript embebido en el HTML.
- Todos los scripts deben ubicarse en `/includes/javascript/scripts.js` o en archivos independientes dentro de `/includes/javascript/`.
- Utilizar `addEventListener` en lugar de atributos como `onclick`, `onchange`, etc.

## Responsive Design
- Todas las pantallas deben ser completamente responsivas.
- Deben adaptarse correctamente a dispositivos móviles, tablets y escritorio.
- Priorizar un enfoque Mobile First.

## SEO
- Desarrollar todas las páginas siguiendo buenas prácticas de SEO.
- Utilizar correctamente las etiquetas `title`, `meta description`, encabezados (`h1`–`h6`), atributos `alt` en imágenes y URLs amigables.
- Mantener una estructura HTML semántica para favorecer la indexación.

## Buenas prácticas generales
- Evitar duplicación de código.
- Reutilizar componentes siempre que sea posible.
- Mantener nombres descriptivos para variables, funciones y clases.
- Cada pantalla que se acceda debe tener un “Cargando..” hasta que se cargue la pantalla.