Skip to main content

Badges Dinámicos para Proyectos - Guía Completa

AutorAutor:: Abkrim
Última actualizaciónactualización:: 31 Diciembre 2025
2026-06-22 PropósitoPropósito:: Documentación unificada de badges para todoslos proyectos AichaDigital

Principio rector: un badge dinámico no debe poder mentir. Cada badge se emite solo si su fuente de datos existe; los proyectosque no tienen un badge dinámico fiable (nivel de PHPStan, versión de Laravel) se regeneran desde la fuente local en lugar de mantenerse a mano.


Herramienta: skill /ai-badges

Para aplicar esta guía sin trabajo manual existe el skill de Claude Code /ai-badges. Lee el estado real del paquete (composer.json, phpstan.neon, workflows de CI) y regenera un bloque de badges canónico en el README.md, de forma idempotente, entre marcadores:

<!-- AI-BADGES:START profile=essential -->
...badges...
<!-- AI-BADGES:END -->
    Solo escribe entre los marcadores. El resto del README.md no se toca. Dos capas, todo condicional:
      essential (siempre): Latest Version, Total Downloads, Tests, Code Style, PHPStan level, PHP Version, Laravel Version, License. extra (opt-in): Code Coverage, Repo Status, Last Commit. Cada badge se emite solo si su fuente existe (no pone coverage sin Codecov, ni PHPStan sin phpstan.neon). Invocación: /ai-badges check (dry-run, no escribe), /ai-badges (perfil guardado en el marcador), /ai-badges essential | /ai-badges extra. Reporta los badges omitidos con su motivo y la coherencia de la licencia (composer.json vs badge vs fichero LICENSE).

      El catálogo de plantillas de abajo es la referencia canónica; el skill las implementa.


      Plantilla Base Adaptable

      <!-- PROJECT HEADER -->
      # {NOMBRE_PROYECTO}
      
      <!-- BADGES: Información del Paquete -->
      [![Latest Version](https://img.shields.io/packagist/v/{vendor}/{package}.svg?style=flat-square)](https://packagist.org/packages/{vendor}/{package})
      [![Total Downloads](https://img.shields.io/packagist/dt/{vendor}/{package}.svg?style=flat-square)](https://packagist.org/packages/{vendor}/{package})
      [![Monthly Downloads](https://img.shields.io/packagist/dm/{vendor}/{package}.svg?style=flat-square)](https://packagist.org/packages/{vendor}/{package})
      
      <!-- BADGES: Estado de CI/CD -->
      [![Tests](https://img.shields.io/github/actions/workflow/status/{vendor}/{repo}/run-tests.yml?branch=main&label=tests&style=flat-square)](https://github.com/{vendor}/{repo}/actions?query=workflow%3Arun-tests+branch%3Amain)
      [![Code Style](https://img.shields.io/github/actions/workflow/status/{vendor}/{repo}/fix-php-code-style-issues.yml?branch=main&label=code%20style&style=flat-square)](https://github.com/{vendor}/{repo}/actions?query=workflow%3A"Fix+PHP+code+style+issues"+branch%3Amain)
      [![PHPStan](https://img.shields.io/github/actions/workflow/status/{vendor}/{repo}/phpstan.yml?branch=main&label=phpstan&style=flat-square)](https://github.com/{vendor}/{repo}/actions/workflows/phpstan.yml)
      
      <!-- BADGES: Calidad de Código -->
      [![PHPStan Level](https://img.shields.io/badge/PHPStan-level%20max-brightgreen.svg?style=flat-square&logo=php)](https://phpstan.org/)
      [![Code Coverage](https://img.shields.io/codecov/c/github/{vendor}/{repo}?style=flat-square&logo=codecov)](https://codecov.io/gh/{vendor}/{repo})
      [![Maintainability](https://img.shields.io/codeclimate/maintainability/{vendor}/{repo}?style=flat-square&logo=code-climate)](https://codeclimate.com/github/{vendor}/{repo})
      [![Technical Debt](https://img.shields.io/codeclimate/tech-debt/{vendor}/{repo}?style=flat-square&logo=code-climate)](https://codeclimate.com/github/{vendor}/{repo})
      
      <!-- BADGES: Requisitos Técnicos -->
      [![PHP Version](https://img.shields.io/packagist/php-v/{vendor}/{package}.svg?style=flat-square&logo=php)](https://packagist.org/packages/{vendor}/{package})
      [![Laravel Version](https://img.shields.io/badge/Laravel-12.x-red.svg?style=flat-square&logo=laravel)](https://laravel.com)
      
      <!-- BADGES: Stack Tecnológico -->
      [![Stack: RabbitMQ](https://img.shields.io/badge/Stack-RabbitMQ-FF6600?style=flat-square&logo=rabbitmq)](https://www.rabbitmq.com/)
      [![Stack: Elasticsearch](https://img.shields.io/badge/Stack-Elasticsearch-005571?style=flat-square&logo=elasticsearch)](https://www.elastic.co/)
      [![Stack: Redis](https://img.shields.io/badge/Stack-Redis-DC382D?style=flat-square&logo=redis)](https://redis.io/)
      [![Stack: PostgreSQL](https://img.shields.io/badge/Stack-PostgreSQL-336791?style=flat-square&logo=postgresql)](https://www.postgresql.org/)
      
      <!-- BADGES: Estado del Repositorio -->
      [![Last Commit](https://img.shields.io/github/last-commit/{vendor}/{repo}?style=flat-square&logo=github)](https://github.com/{vendor}/{repo}/commits)
      [![Commit Activity](https://img.shields.io/github/commit-activity/m/{vendor}/{repo}?style=flat-square&logo=github)](https://github.com/{vendor}/{repo}/graphs/commit-activity)
      [![Issues](https://img.shields.io/github/issues/{vendor}/{repo}?style=flat-square&logo=github)](https://github.com/{vendor}/{repo}/issues)
      [![Pull Requests](https://img.shields.io/github/issues-pr/{vendor}/{repo}?style=flat-square&logo=github)](https://github.com/{vendor}/{repo}/pulls)
      
      <!-- BADGES: Estado del Proyecto -->
      [![Project Status: Active](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
      [![Maintenance](https://img.shields.io/maintenance/yes/2025?style=flat-square)](https://github.com/{vendor}/{repo}/graphs/commit-activity)
      [![License](https://img.shields.io/github/license/{vendor}/{repo}?style=flat-square)](LICENSE.md)
      
      <!-- BADGES: Comunidad -->
      [![GitHub Stars](https://img.shields.io/github/stars/{vendor}/{repo}?style=flat-square&logo=github)](https://github.com/{vendor}/{repo}/stargazers)
      [![GitHub Forks](https://img.shields.io/github/forks/{vendor}/{repo}?style=flat-square&logo=github)](https://github.com/{vendor}/{repo}/network/members)
      [![Contributors](https://img.shields.io/github/contributors/{vendor}/{repo}?style=flat-square&logo=github)](https://github.com/{vendor}/{repo}/graphs/contributors)
      
      <!-- BADGES: Seguridad -->
      [![Security](https://img.shields.io/badge/Security-Snyk-4C4A73?style=flat-square&logo=snyk)](https://snyk.io/)
      [![Known Vulnerabilities](https://snyk.io/test/github/{vendor}/{repo}/badge.svg?style=flat-square)](https://snyk.io/test/github/{vendor}/{repo})
      
      

      Variables a reemplazar

      Variable Ejemplo Descripción
      {vendor} AichaDigital Nombre de la organización/vendor
      {repo} lara-verifactu Nombre del repositorio
      {package} aichadigital/lara-verifactu Nombre completo del paquete en Packagist

      Badges por Categoría

      1. Información del Paquete (Packagist)

      Versión y Descargas

      <!-- Versión estable actual -->
      [![Latest Version](https://img.shields.io/packagist/v/{vendor}/{package})](https://packagist.org/packages/{vendor}/{package})
      
      <!-- Versión pre-release -->
      [![Latest Unstable Version](https://img.shields.io/packagist/vpre/{vendor}/{package})](https://packagist.org/packages/{vendor}/{package})
      
      <!-- Descargas totales -->
      [![Total Downloads](https://img.shields.io/packagist/dt/{vendor}/{package})](https://packagist.org/packages/{vendor}/{package})
      
      <!-- Descargas mensuales -->
      [![Monthly Downloads](https://img.shields.io/packagist/dm/{vendor}/{package})](https://packagist.org/packages/{vendor}/{package})
      
      <!-- Descargas diarias -->
      [![Daily Downloads](https://img.shields.io/packagist/dd/{vendor}/{package})](https://packagist.org/packages/{vendor}/{package})
      
      <!-- Licencia desde Packagist -->
      [![License](https://img.shields.io/packagist/l/{vendor}/{package})](https://packagist.org/packages/{vendor}/{package})
      
      

      Configuración

      • URL: https://packagist.org/
      • Requisitos: Paquete publicado en Packagist
      • Actualización: Automática tras cada release
      • Costo: Gratuito

      2. CI/CD y Tests (GitHub Actions)

      Workflows Estándar

      <!-- Tests generales -->
      [![Tests](https://github.com/{vendor}/{repo}/actions/workflows/run-tests.yml/badge.svg)](https://github.com/{vendor}/{repo}/actions/workflows/run-tests.yml)
      
      <!-- Code Style (Pint/PHP-CS-Fixer) -->
      [![Code Style](https://github.com/{vendor}/{repo}/actions/workflows/fix-php-code-style-issues.yml/badge.svg)](https://github.com/{vendor}/{repo}/actions/workflows/fix-php-code-style-issues.yml)
      
      <!-- PHPStan -->
      [![PHPStan](https://github.com/{vendor}/{repo}/actions/workflows/phpstan.yml/badge.svg)](https://github.com/{vendor}/{repo}/actions/workflows/phpstan.yml)
      
      <!-- Pest/PHPUnit -->
      [![Tests](https://github.com/{vendor}/{repo}/actions/workflows/tests.yml/badge.svg)](https://github.com/{vendor}/{repo}/actions/workflows/tests.yml)
      
      <!-- Build Status (genérico) -->
      [![Build Status](https://github.com/{vendor}/{repo}/workflows/CI/badge.svg)](https://github.com/{vendor}/{repo}/actions)
      
      <!-- Estado específico de workflow con parámetros -->
      [![Tests](https://img.shields.io/github/actions/workflow/status/{vendor}/{repo}/run-tests.yml?branch=main&label=tests)](https://github.com/{vendor}/{repo}/actions/workflows/run-tests.yml)
      
      

      Configuración

      • Ubicación: .github/workflows/*.yml
      • Requisitos: Workflows activos en GitHub Actions
      • Actualización: Automática en cada push/PR
      • Costo: Gratuito para repos públicos

      Ejemplo de workflow mínimo:

      # .github/workflows/run-tests.yml
      name: Tests
      
      on: [push, pull_request]
      
      jobs:
        test:
          runs-on: ubuntu-latest
          steps:
      
            - uses: actions/checkout@v4
            - name: Setup PHP
              uses: shivammathur/setup-php@v2
              with:
                php-version: 8.3
      
            - run: composer install
            - run: vendor/bin/pest
      

      3. Calidad de Código

      PHPStan (Badges Manuales)

      <!-- Level específico (0-9) - ACTUALIZAR MANUALMENTE -->
      [![PHPStan Level 0](https://img.shields.io/badge/PHPStan-level%200-red.svg?logo=php)](https://phpstan.org/)
      [![PHPStan Level 1](https://img.shields.io/badge/PHPStan-level%201-orange.svg?logo=php)](https://phpstan.org/)
      [![PHPStan Level 2](https://img.shields.io/badge/PHPStan-level%202-yellow.svg?logo=php)](https://phpstan.org/)
      [![PHPStan Level 3](https://img.shields.io/badge/PHPStan-level%203-yellowgreen.svg?logo=php)](https://phpstan.org/)
      [![PHPStan Level 4](https://img.shields.io/badge/PHPStan-level%204-yellowgreen.svg?logo=php)](https://phpstan.org/)
      [![PHPStan Level 5](https://img.shields.io/badge/PHPStan-level%205-green.svg?logo=php)](https://phpstan.org/)
      [![PHPStan Level 6](https://img.shields.io/badge/PHPStan-level%206-green.svg?logo=php)](https://phpstan.org/)
      [![PHPStan Level 7](https://img.shields.io/badge/PHPStan-level%207-brightgreen.svg?logo=php)](https://phpstan.org/)
      [![PHPStan Level 8](https://img.shields.io/badge/PHPStan-level%208-brightgreen.svg?logo=php)](https://phpstan.org/)
      [![PHPStan Level 9](https://img.shields.io/badge/PHPStan-level%209-brightgreen.svg?logo=php)](https://phpstan.org/)
      
      <!-- Max Level (para proyectos con level 9) -->
      [![PHPStan Level](https://img.shields.io/badge/PHPStan-level%20max-brightgreen.svg?logo=php)](https://phpstan.org/)
      
      <!-- Badge con workflow dinámico (muestra estado del workflow) -->
      [![PHPStan](https://github.com/{vendor}/{repo}/actions/workflows/phpstan.yml/badge.svg)](https://github.com/{vendor}/{repo}/actions/workflows/phpstan.yml)
      
      

      Nota importante: PHPStan no tiene badge oficial dinámico que lea el level automáticamente. DebesEl actualizarskill /ai-badges lo regenera leyendo level: de phpstan.neon[.dist], de modo que el badge manualmenteestático cuandodeja cambiesde mantenerse a mano (colores: 0-2 rojo, 3-4 naranja, 5-6 verde, 7-9/max verde brillante). Si no usas el level.skill, Veractualízalo manualmente o ver Solución Custom para PHPStan más abajo.

      Codecov

      <!-- Badge básico -->
      [![Code Coverage](https://codecov.io/gh/{vendor}/{repo}/branch/main/graph/badge.svg)](https://codecov.io/gh/{vendor}/{repo})
      
      <!-- Con token (para repos privados) -->
      [![codecov](https://codecov.io/gh/{vendor}/{repo}/branch/main/graph/badge.svg?token=YOUR_TOKEN)](https://codecov.io/gh/{vendor}/{repo})
      
      <!-- Badge con porcentaje visible -->
      [![Coverage](https://img.shields.io/codecov/c/github/{vendor}/{repo}?logo=codecov)](https://codecov.io/gh/{vendor}/{repo})
      
      

      Configuración:

      1. Crear cuenta en https://codecov.io/

      2. Vincular repositorio

      3. Obtener token (Settings > Repository > Upload Token)

      4. Añadir token a GitHub Secrets: CODECOV_TOKEN

      5. Configurar workflow:

      # .github/workflows/tests.yml
      
      - name: Run tests with coverage
        run: vendor/bin/pest --coverage --coverage-clover=coverage.xml
      
      - name: Upload coverage to Codecov
        uses: codecov/codecov-action@v3
        with:
          files: ./coverage.xml
          fail_ci_if_error: true
          token: ${{ secrets.CODECOV_TOKEN }}
      
      

      Costo: Gratuito para repos open source

      Code Climate

      <!-- Maintainability -->
      [![Maintainability](https://api.codeclimate.com/v1/badges/{badge_id}/maintainability)](https://codeclimate.com/github/{vendor}/{repo}/maintainability)
      
      <!-- Test Coverage -->
      [![Test Coverage](https://api.codeclimate.com/v1/badges/{badge_id}/test_coverage)](https://codeclimate.com/github/{vendor}/{repo}/test_coverage)
      
      <!-- Technical Debt -->
      [![Technical Debt](https://img.shields.io/codeclimate/tech-debt/{vendor}/{repo})](https://codeclimate.com/github/{vendor}/{repo})
      
      <!-- Badge de issues -->
      [![Code Issues](https://img.shields.io/codeclimate/issues/{vendor}/{repo})](https://codeclimate.com/github/{vendor}/{repo}/issues)
      
      

      Configuración:

      1. Crear cuenta en https://codeclimate.com/

      2. Conectar repositorio

      3. Obtener badge_id del dashboard (Repo Settings > Badges)

      4. Crear .codeclimate.yml:

      version: "2"
      checks:
        argument-count:
          enabled: true
          config:
            threshold: 4
        complex-logic:
          enabled: true
        method-complexity:
          enabled: true
          config:
            threshold: 10
        method-lines:
          enabled: true
          config:
            threshold: 50
      
      

      Costo: Gratuito para repos open source

      Scrutinizer

      <!-- Quality Score -->
      [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/{vendor}/{repo}/badges/quality-score.png?b=main)](https://scrutinizer-ci.com/g/{vendor}/{repo}/?branch=main)
      
      <!-- Coverage -->
      [![Code Coverage](https://scrutinizer-ci.com/g/{vendor}/{repo}/badges/coverage.png?b=main)](https://scrutinizer-ci.com/g/{vendor}/{repo}/?branch=main)
      
      <!-- Build Status -->
      [![Build Status](https://scrutinizer-ci.com/g/{vendor}/{repo}/badges/build.png?b=main)](https://scrutinizer-ci.com/g/{vendor}/{repo}/build-status/main)
      
      

      Configuración:

      • URL: https://scrutinizer-ci.com/
      • Requisitos: Conectar repo, configurar .scrutinizer.yml
      • Costo: Gratuito para repos open source

      SonarCloud

      <!-- Quality Gate Status -->
      [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project={project_key}&metric=alert_status)](https://sonarcloud.io/dashboard?id={project_key})
      
      <!-- Bugs -->
      [![Bugs](https://sonarcloud.io/api/project_badges/measure?project={project_key}&metric=bugs)](https://sonarcloud.io/dashboard?id={project_key})
      
      <!-- Code Smells -->
      [![Code Smells](https://sonarcloud.io/api/project_badges/measure?project={project_key}&metric=code_smells)](https://sonarcloud.io/dashboard?id={project_key})
      
      <!-- Coverage -->
      [![Coverage](https://sonarcloud.io/api/project_badges/measure?project={project_key}&metric=coverage)](https://sonarcloud.io/dashboard?id={project_key})
      
      <!-- Duplicated Lines -->
      [![Duplicated Lines](https://sonarcloud.io/api/project_badges/measure?project={project_key}&metric=duplicated_lines_density)](https://sonarcloud.io/dashboard?id={project_key})
      
      <!-- Technical Debt -->
      [![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project={project_key}&metric=sqale_index)](https://sonarcloud.io/dashboard?id={project_key})
      
      <!-- Vulnerabilities -->
      [![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project={project_key}&metric=vulnerabilities)](https://sonarcloud.io/dashboard?id={project_key})
      
      <!-- Security Rating -->
      [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project={project_key}&metric=security_rating)](https://sonarcloud.io/dashboard?id={project_key})
      
      <!-- Maintainability Rating -->
      [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project={project_key}&metric=sqale_rating)](https://sonarcloud.io/dashboard?id={project_key})
      
      <!-- Reliability Rating -->
      [![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project={project_key}&metric=reliability_rating)](https://sonarcloud.io/dashboard?id={project_key})
      
      

      Configuración:

      • URL: https://sonarcloud.io/
      • Requisitos: Vincular con GitHub/GitLab, configurar sonar-project.properties
      • Costo: Gratuito para repos open source

      4. Requisitos Técnicos

      <!-- PHP Version (desde composer.json - DINÁMICO) -->
      [![PHP Version](https://img.shields.io/packagist/php-v/{vendor}/{package}?logo=php)](https://packagist.org/packages/{vendor}/{package})
      
      <!-- PHP Version específica (manual) -->
      [![PHP](https://img.shields.io/badge/PHP-%3E%3D8.2-777BB4?logo=php)](https://www.php.net/)
      [![PHP](https://img.shields.io/badge/PHP-%3E%3D8.3-777BB4?logo=php)](https://www.php.net/)
      
      <!-- Laravel Version (manual) -->
      [![Laravel](https://img.shields.io/badge/Laravel-11.x-red?logo=laravel)](https://laravel.com)
      [![Laravel](https://img.shields.io/badge/Laravel-12.x-red?logo=laravel)](https://laravel.com)
      
      <!-- Versión múltiple de Laravel -->
      [![Laravel](https://img.shields.io/badge/Laravel-11.x%20%7C%2012.x-red?logo=laravel)](https://laravel.com)
      
      <!-- Composer Version -->
      [![Composer](https://img.shields.io/badge/Composer-2.x-885630?logo=composer)](https://getcomposer.org/)
      
      <!-- Node.js (si aplica) -->
      [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20-339933?logo=node.js)](https://nodejs.org/)
      
      

      Nota: El badge de PHP desde Packagist lee automáticamente el require.php de composer.json. La versión de Laravel no tiene badge dinámico oficial: el skill /ai-badges la regenera desde la matriz laravel: del workflow de tests (o, si no existe, desde el constraint illuminate/* de composer.json).


      5. Stack Tecnológico

      Bases de Datos

      <!-- MySQL -->
      [![MySQL](https://img.shields.io/badge/MySQL-8.0-4479A1?logo=mysql&logoColor=white)](https://www.mysql.com/)
      [![MySQL](https://img.shields.io/badge/MySQL-8.x-4479A1?logo=mysql&logoColor=white)](https://www.mysql.com/)
      
      <!-- PostgreSQL -->
      [![PostgreSQL](https://img.shields.io/badge/PostgreSQL-16-336791?logo=postgresql)](https://www.postgresql.org/)
      [![PostgreSQL](https://img.shields.io/badge/PostgreSQL-15%20%7C%2016-336791?logo=postgresql)](https://www.postgresql.org/)
      
      <!-- MariaDB -->
      [![MariaDB](https://img.shields.io/badge/MariaDB-11.x-003545?logo=mariadb)](https://mariadb.org/)
      
      <!-- SQLite -->
      [![SQLite](https://img.shields.io/badge/SQLite-3.x-003B57?logo=sqlite)](https://www.sqlite.org/)
      
      <!-- MongoDB -->
      [![MongoDB](https://img.shields.io/badge/MongoDB-7.x-47A248?logo=mongodb&logoColor=white)](https://www.mongodb.com/)
      
      

      Message Queues

      <!-- RabbitMQ -->
      [![RabbitMQ](https://img.shields.io/badge/RabbitMQ-3.x-FF6600?logo=rabbitmq)](https://www.rabbitmq.com/)
      
      <!-- Apache Kafka -->
      [![Apache Kafka](https://img.shields.io/badge/Kafka-latest-231F20?logo=apache-kafka)](https://kafka.apache.org/)
      
      <!-- AWS SQS -->
      [![AWS SQS](https://img.shields.io/badge/AWS-SQS-FF9900?logo=amazon-aws)](https://aws.amazon.com/sqs/)
      
      

      Cache y Storage

      <!-- Redis -->
      [![Redis](https://img.shields.io/badge/Redis-7.x-DC382D?logo=redis&logoColor=white)](https://redis.io/)
      
      <!-- Memcached -->
      [![Memcached](https://img.shields.io/badge/Memcached-latest-00D8FF)](https://memcached.org/)
      
      <!-- MinIO -->
      [![MinIO](https://img.shields.io/badge/MinIO-latest-C72E49?logo=minio&logoColor=white)](https://min.io/)
      
      

      Search Engines

      <!-- Elasticsearch -->
      [![Elasticsearch](https://img.shields.io/badge/Elasticsearch-8.x-005571?logo=elasticsearch)](https://www.elastic.co/)
      
      <!-- Algolia -->
      [![Algolia](https://img.shields.io/badge/Algolia-latest-5468FF?logo=algolia&logoColor=white)](https://www.algolia.com/)
      
      <!-- MeiliSearch -->
      [![MeiliSearch](https://img.shields.io/badge/MeiliSearch-latest-FF69B4?logo=meilisearch&logoColor=white)](https://www.meilisearch.com/)
      
      <!-- Typesense -->
      [![Typesense](https://img.shields.io/badge/Typesense-latest-D91A5B)](https://typesense.org/)
      
      

      Frontend (si aplica)

      <!-- Vue.js -->
      [![Vue.js](https://img.shields.io/badge/Vue.js-3.x-4FC08D?logo=vue.js&logoColor=white)](https://vuejs.org/)
      
      <!-- React -->
      [![React](https://img.shields.io/badge/React-18.x-61DAFB?logo=react&logoColor=black)](https://reactjs.org/)
      
      <!-- Alpine.js -->
      [![Alpine.js](https://img.shields.io/badge/Alpine.js-3.x-8BC0D0?logo=alpine.js&logoColor=black)](https://alpinejs.dev/)
      
      <!-- Livewire -->
      [![Livewire](https://img.shields.io/badge/Livewire-3.x-FB70A9?logo=livewire)](https://livewire.laravel.com/)
      
      <!-- Inertia.js -->
      [![Inertia.js](https://img.shields.io/badge/Inertia.js-latest-9553E9?logo=inertia)](https://inertiajs.com/)
      
      <!-- Tailwind CSS -->
      [![Tailwind CSS](https://img.shields.io/badge/Tailwind-3.x-06B6D4?logo=tailwind-css&logoColor=white)](https://tailwindcss.com/)
      
      <!-- Bootstrap -->
      [![Bootstrap](https://img.shields.io/badge/Bootstrap-5.x-7952B3?logo=bootstrap&logoColor=white)](https://getbootstrap.com/)
      
      

      DevOps y Contenedores

      <!-- Docker -->
      [![Docker](https://img.shields.io/badge/Docker-latest-2496ED?logo=docker&logoColor=white)](https://www.docker.com/)
      
      <!-- Kubernetes -->
      [![Kubernetes](https://img.shields.io/badge/Kubernetes-latest-326CE5?logo=kubernetes&logoColor=white)](https://kubernetes.io/)
      
      <!-- Proxmox -->
      [![Proxmox](https://img.shields.io/badge/Proxmox-VE-E57000?logo=proxmox&logoColor=white)](https://www.proxmox.com/)
      
      <!-- GitHub Actions -->
      [![GitHub Actions](https://img.shields.io/badge/GitHub-Actions-2088FF?logo=github-actions&logoColor=white)](https://github.com/features/actions)
      
      <!-- GitLab CI -->
      [![GitLab CI](https://img.shields.io/badge/GitLab-CI-FC6D26?logo=gitlab&logoColor=white)](https://docs.gitlab.com/ee/ci/)
      
      

      6. Estado del Repositorio

      <!-- Último commit (DINÁMICO) -->
      [![Last Commit](https://img.shields.io/github/last-commit/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo}/commits)
      
      <!-- Actividad de commits mensual (DINÁMICO) -->
      [![Commit Activity](https://img.shields.io/github/commit-activity/m/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo}/graphs/commit-activity)
      
      <!-- Actividad de commits semanal (DINÁMICO) -->
      [![Commit Activity](https://img.shields.io/github/commit-activity/w/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo}/graphs/commit-activity)
      
      <!-- Actividad de commits anual (DINÁMICO) -->
      [![Commit Activity](https://img.shields.io/github/commit-activity/y/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo}/graphs/commit-activity)
      
      <!-- Issues abiertas (DINÁMICO) -->
      [![Open Issues](https://img.shields.io/github/issues/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo}/issues)
      
      <!-- Issues cerradas (DINÁMICO) -->
      [![Closed Issues](https://img.shields.io/github/issues-closed/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo}/issues?q=is%3Aissue+is%3Aclosed)
      
      <!-- Pull Requests abiertas (DINÁMICO) -->
      [![Open PRs](https://img.shields.io/github/issues-pr/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo}/pulls)
      
      <!-- Pull Requests cerradas (DINÁMICO) -->
      [![Closed PRs](https://img.shields.io/github/issues-pr-closed/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo}/pulls?q=is%3Apr+is%3Aclosed)
      
      <!-- Tamaño del repositorio (DINÁMICO) -->
      [![Repo Size](https://img.shields.io/github/repo-size/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo})
      
      <!-- Lenguaje principal (DINÁMICO) -->
      [![Top Language](https://img.shields.io/github/languages/top/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo})
      
      <!-- Conteo de lenguajes (DINÁMICO) -->
      [![Language Count](https://img.shields.io/github/languages/count/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo})
      
      <!-- Última release (DINÁMICO) -->
      [![Latest Release](https://img.shields.io/github/v/release/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo}/releases/latest)
      
      <!-- Release date (DINÁMICO) -->
      [![Release Date](https://img.shields.io/github/release-date/{vendor}/{repo}?logo=github)](https://github.com/{vendor}/{repo}/releases)
      
      

      7. Estado del Proyecto (dinámicos)

      RepoStatus.org (Estados Oficiales)

      <!-- Active: Proyecto activo con desarrollo regular -->
      [![Active](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
      
      <!-- WIP: Work In Progress, funcional pero en desarrollo -->
      [![WIP](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip)
      
      <!-- Suspended: Temporalmente detenido -->
      [![Suspended](https://www.repostatus.org/badges/latest/suspended.svg)](https://www.repostatus.org/#suspended)
      
      <!-- Abandoned: No mantenido -->
      [![Abandoned](https://www.repostatus.org/badges/latest/abandoned.svg)](https://www.repostatus.org/#abandoned)
      
      <!-- Moved: Repositorio movido a otra ubicación -->
      [![Moved](https://www.repostatus.org/badges/latest/moved.svg)](https://www.repostatus.org/#moved)
      
      <!-- Inactive: Funcional pero no mantenido activamente -->
      [![Inactive](https://www.repostatus.org/badges/latest/inactive.svg)](https://www.repostatus.org/#inactive)
      
      <!-- Unsupported: Funcional pero sin soporte -->
      [![Unsupported](https://www.repostatus.org/badges/latest/unsupported.svg)](https://www.repostatus.org/#unsupported)
      
      <!-- Concept: En fase de concepto -->
      [![Concept](https://www.repostatus.org/badges/latest/concept.svg)](https://www.repostatus.org/#concept)
      
      

      URL: https://www.repostatus.org/
      Actualización: Manual (copiar el badge apropiado)

      Maintenance Status (Año específico)

      <!-- Mantenido actualmente (cambiar año según corresponda) -->
      [![Maintenance](https://img.shields.io/maintenance/yes/2025)](https://github.com/{vendor}/{repo})
      
      <!-- No mantenido -->
      [![Maintenance](https://img.shields.io/maintenance/no/2025)](https://github.com/{vendor}/{repo})
      
      

      Nota: Actualizar el año anualmente.


      8. Licencia

      <!-- Licencia desde GitHub (DINÁMICO) -->
      [![License](https://img.shields.io/github/license/{vendor}/{repo})](https://github.com/{vendor}/{repo}/blob/main/LICENSE.md)
      
      <!-- MIT -->
      [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
      
      <!-- GPL v3 -->
      [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
      
      <!-- AGPL v3 (por defecto en cores/aplicaciones AichaDigital) -->
      [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
      
      <!-- Licencia DINÁMICA desde Packagist (RECOMENDADO: lee composer.json) -->
      [![License](https://img.shields.io/packagist/l/{vendor}/{package}.svg)](https://packagist.org/packages/{vendor}/{package})
      
      <!-- Apache 2.0 -->
      [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
      
      <!-- BSD 3-Clause -->
      [![License: BSD-3](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
      
      <!-- ISC -->
      [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
      
      <!-- Propietaria -->
      [![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE.md)
      
      

      Criterio de licencia (AichaDigital):

        Producto / aplicación desplegada como servicio → AGPL-3.0-or-later. Copyleft fuerte: impide que un tercero monte un SaaS cerrado con el motor sin liberar su código. Librería / integración pensada para que otros la integren → MIT. AGPL es vírica y frena la adopción comercial; MIT maximiza el uso (es lo idiomático en el ecosistema Laravel). Forks: el copyleft solo se endurece, nunca se relaja. Desde MIT/Apache puedes pasar tu fork a AGPL; desde (A)GPL estás obligado a mantener (A)GPL. Badge: preferir el dinámico packagist/l (lee la licencia real de composer.json) frente al estático, para que no se desincronice.

        9. Comunidad

        <!-- Stars (DINÁMICO) -->
        [![GitHub Stars](https://img.shields.io/github/stars/{vendor}/{repo}?style=social)](https://github.com/{vendor}/{repo}/stargazers)
        
        <!-- Forks (DINÁMICO) -->
        [![GitHub Forks](https://img.shields.io/github/forks/{vendor}/{repo}?style=social)](https://github.com/{vendor}/{repo}/network/members)
        
        <!-- Watchers (DINÁMICO) -->
        [![GitHub Watchers](https://img.shields.io/github/watchers/{vendor}/{repo}?style=social)](https://github.com/{vendor}/{repo}/watchers)
        
        <!-- Contributors (DINÁMICO) -->
        [![Contributors](https://img.shields.io/github/contributors/{vendor}/{repo})](https://github.com/{vendor}/{repo}/graphs/contributors)
        
        <!-- Discussions (DINÁMICO) -->
        [![GitHub Discussions](https://img.shields.io/github/discussions/{vendor}/{repo})](https://github.com/{vendor}/{repo}/discussions)
        
        <!-- Sponsors -->
        [![GitHub Sponsors](https://img.shields.io/github/sponsors/{vendor}?logo=github)](https://github.com/sponsors/{vendor})
        
        <!-- Discord -->
        [![Discord](https://img.shields.io/discord/{server_id}?logo=discord&label=Discord)](https://discord.gg/{invite_code})
        
        <!-- Slack -->
        [![Slack](https://img.shields.io/badge/Slack-Join-4A154B?logo=slack)](https://join.slack.com/...)
        
        <!-- Twitter -->
        [![Twitter Follow](https://img.shields.io/twitter/follow/{handle}?style=social)](https://twitter.com/{handle})
        
        

        10. Seguridad

        <!-- Snyk (DINÁMICO) -->
        [![Known Vulnerabilities](https://snyk.io/test/github/{vendor}/{repo}/badge.svg)](https://snyk.io/test/github/{vendor}/{repo})
        
        <!-- Dependabot (manual) -->
        [![Dependabot](https://img.shields.io/badge/Dependabot-enabled-success?logo=dependabot)](https://github.com/{vendor}/{repo}/network/dependencies)
        
        <!-- Security Policy (manual) -->
        [![Security Policy](https://img.shields.io/badge/Security-Policy-blue)](https://github.com/{vendor}/{repo}/security/policy)
        
        <!-- OSSF Best Practices (DINÁMICO tras registro) -->
        [![OpenSSF Best Practices](https://bestpractices.coreinfrastructure.org/projects/{project_id}/badge)](https://bestpractices.coreinfrastructure.org/projects/{project_id})
        
        <!-- OSSF Scorecard -->
        [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/{vendor}/{repo}/badge)](https://api.securityscorecards.dev/projects/github.com/{vendor}/{repo})
        
        

        Configuración Snyk:

        1. Crear cuenta en https://snyk.io/

        2. Conectar repositorio

        3. Badge aparece automáticamente

        Costo: Gratuito para repos open source


        11. Documentación

        <!-- ReadTheDocs (DINÁMICO) -->
        [![Documentation](https://readthedocs.org/projects/{project}/badge/?version=latest)](https://{project}.readthedocs.io/en/latest/)
        
        <!-- GitHub Pages (manual) -->
        [![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue?logo=github)](https://{vendor}.github.io/{repo}/)
        
        <!-- Wiki (manual) -->
        [![Wiki](https://img.shields.io/badge/docs-Wiki-blue?logo=github)](https://github.com/{vendor}/{repo}/wiki)
        
        <!-- Gitbook -->
        [![Gitbook](https://img.shields.io/badge/docs-Gitbook-blue?logo=gitbook&logoColor=white)](https://{organization}.gitbook.io/{project}/)
        
        <!-- Badge de "docs" personalizado -->
        [![Documentation](https://img.shields.io/badge/docs-latest-blue)](https://docs.{domain}.com)
        
        

        Servicios Externos Recomendados

        Servicio Propósito URL API Key Costo OSS Configuración
        Packagist Stats de paquetes PHP https://packagist.org/ No Gratis Automático tras publish
        Codecov Code Coverage https://codecov.io/ Sí Gratis Token en GitHub Secrets
        Code Climate Calidad de código https://codeclimate.com/ Sí Gratis Conectar repo + .codeclimate.yml
        Scrutinizer Análisis estático https://scrutinizer-ci.com/ No Gratis Conectar + .scrutinizer.yml
        SonarCloud Análisis de seguridad https://sonarcloud.io/ Sí Gratis sonar-project.properties
        Snyk Vulnerabilidades https://snyk.io/ Sí Gratis Conectar repositorio
        Shields.io Badges personalizados https://shields.io/ No Gratis -
        RepoStatus.org Estado del proyecto https://www.repostatus.org/ No Gratis -
        OSSF Security Scorecard https://securityscorecards.dev/ No Gratis Configurar workflow

        Ejemplos Completos por Tipo de Proyecto

        Ejemplo 1: Paquete Laravel con Testing Completo

        # Lara-Verifactu
        
        > Paquete Laravel para integración con el sistema VeriFactu de la AEAT
        
        [![Latest Version](https://img.shields.io/packagist/v/aichadigital/lara-verifactu?style=flat-square)](https://packagist.org/packages/aichadigital/lara-verifactu)
        [![Total Downloads](https://img.shields.io/packagist/dt/aichadigital/lara-verifactu?style=flat-square)](https://packagist.org/packages/aichadigital/lara-verifactu)
        [![Tests](https://img.shields.io/github/actions/workflow/status/AichaDigital/lara-verifactu/run-tests.yml?branch=main&label=tests&style=flat-square)](https://github.com/AichaDigital/lara-verifactu/actions/workflows/run-tests.yml)
        [![PHPStan Level 9](https://img.shields.io/badge/PHPStan-level%209-brightgreen?style=flat-square&logo=php)](https://phpstan.org/)
        [![Code Coverage](https://img.shields.io/codecov/c/github/AichaDigital/lara-verifactu?style=flat-square&logo=codecov)](https://codecov.io/gh/AichaDigital/lara-verifactu)
        
        [![PHP Version](https://img.shields.io/packagist/php-v/aichadigital/lara-verifactu?style=flat-square&logo=php)](https://packagist.org/packages/aichadigital/lara-verifactu)
        [![Laravel Version](https://img.shields.io/badge/Laravel-11.x%20%7C%2012.x-red?style=flat-square&logo=laravel)](https://laravel.com)
        [![License](https://img.shields.io/github/license/AichaDigital/lara-verifactu?style=flat-square)](LICENSE.md)
        
        ## Instalación
        
        \```bash
        composer require aichadigital/lara-verifactu
        \```
        
        

        Ejemplo 2: Proyecto Laravel con Stack Completo

        # Sistema de Subastas Online
        
        > Plataforma empresarial para subastas en tiempo real
        
        [![Project Status: Active](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
        [![Maintenance](https://img.shields.io/maintenance/yes/2025?style=flat-square)](https://github.com/AichaDigital/subastas-app)
        [![Tests](https://img.shields.io/github/actions/workflow/status/AichaDigital/subastas-app/tests.yml?branch=main&label=tests&style=flat-square)](https://github.com/AichaDigital/subastas-app/actions/workflows/tests.yml)
        [![Last Commit](https://img.shields.io/github/last-commit/AichaDigital/subastas-app?style=flat-square)](https://github.com/AichaDigital/subastas-app/commits)
        
        **Stack Tecnológico:**
        
        [![PHP 8.3](https://img.shields.io/badge/PHP-8.3-777BB4?style=flat-square&logo=php)](https://www.php.net/)
        [![Laravel 12](https://img.shields.io/badge/Laravel-12.x-red?style=flat-square&logo=laravel)](https://laravel.com)
        [![Livewire](https://img.shields.io/badge/Livewire-3.x-FB70A9?style=flat-square&logo=livewire)](https://livewire.laravel.com/)
        
        **Infraestructura:**
        
        [![PostgreSQL](https://img.shields.io/badge/PostgreSQL-16-336791?style=flat-square&logo=postgresql)](https://www.postgresql.org/)
        [![Redis](https://img.shields.io/badge/Redis-7.x-DC382D?style=flat-square&logo=redis&logoColor=white)](https://redis.io/)
        [![RabbitMQ](https://img.shields.io/badge/RabbitMQ-3.x-FF6600?style=flat-square&logo=rabbitmq)](https://www.rabbitmq.com/)
        [![Elasticsearch](https://img.shields.io/badge/Elasticsearch-8.x-005571?style=flat-square&logo=elasticsearch)](https://www.elastic.co/)
        
        [![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red?style=flat-square)](LICENSE.md)
        
        

        Ejemplo 3: Paquete PHP Standalone

        # PHP-Utils
        
        > Utilidades PHP para proyectos empresariales
        
        [![Latest Version](https://img.shields.io/packagist/v/xerintel/php-utils?style=flat-square)](https://packagist.org/packages/xerintel/php-utils)
        [![PHP Version](https://img.shields.io/packagist/php-v/xerintel/php-utils?style=flat-square&logo=php)](https://www.php.net/)
        [![Tests](https://img.shields.io/github/actions/workflow/status/xerintel/php-utils/tests.yml?branch=main&label=tests&style=flat-square)](https://github.com/xerintel/php-utils/actions/workflows/tests.yml)
        [![PHPStan Level 8](https://img.shields.io/badge/PHPStan-level%208-brightgreen?style=flat-square&logo=php)](https://phpstan.org/)
        [![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](LICENSE.md)
        
        

        Ejemplo 4: Proyecto con Monitorización y Seguridad

        # Enterprise CRM
        
        [![Active](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
        [![Tests](https://img.shields.io/github/actions/workflow/status/empresa/crm/tests.yml?branch=main&style=flat-square)](https://github.com/empresa/crm/actions)
        [![Security](https://snyk.io/test/github/empresa/crm/badge.svg?style=flat-square)](https://snyk.io/test/github/empresa/crm)
        
        **Calidad:**
        
        [![Code Coverage](https://img.shields.io/codecov/c/github/empresa/crm?style=flat-square)](https://codecov.io/gh/empresa/crm)
        [![Maintainability](https://api.codeclimate.com/v1/badges/ABC123/maintainability)](https://codeclimate.com/github/empresa/crm)
        [![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=empresa_crm&metric=alert_status)](https://sonarcloud.io/dashboard?id=empresa_crm)
        
        **Stack:**
        
        [![Laravel 12](https://img.shields.io/badge/Laravel-12.x-red?style=flat-square&logo=laravel)](https://laravel.com)
        [![Vue.js 3](https://img.shields.io/badge/Vue.js-3.x-4FC08D?style=flat-square&logo=vue.js)](https://vuejs.org/)
        [![MySQL 8](https://img.shields.io/badge/MySQL-8.0-4479A1?style=flat-square&logo=mysql)](https://www.mysql.com/)
        
        

        Soluciones Especiales

        Badge Dinámico para PHPStan (Solución Custom)

        Como PHPStan no ofrece badges dinámicos oficiales, aquí hay una solución mediante GitHub Actions:

        Opción 1: Badge con GitHub Actions Status

        # .github/workflows/phpstan-badge.yml
        name: PHPStan Badge
        
        on:
          push:
            branches: [main]
          pull_request:
        
        jobs:
          phpstan:
            name: PHPStan Level Check
            runs-on: ubuntu-latest
            
            steps:
        
              - uses: actions/checkout@v4
              
              - name: Setup PHP
                uses: shivammathur/setup-php@v2
                with:
                  php-version: 8.3
              
              - name: Install dependencies
                run: composer install --no-interaction
              
              - name: Run PHPStan
                run: vendor/bin/phpstan analyse --no-progress
        
        

        Badge a usar:

        [![PHPStan](https://img.shields.io/github/actions/workflow/status/{vendor}/{repo}/phpstan-badge.yml?branch=main&label=PHPStan%20Level%209&style=flat-square)](https://github.com/{vendor}/{repo}/actions/workflows/phpstan-badge.yml)
        
        

        Opción 2: Badge Dinámico con Gist (Avanzado)

        # .github/workflows/phpstan-dynamic-badge.yml
        name: PHPStan Dynamic Badge
        
        on:
          push:
            branches: [main]
        
        jobs:
          badge:
            runs-on: ubuntu-latest
            steps:
        
              - uses: actions/checkout@v4
              
              - name: Setup PHP
                uses: shivammathur/setup-php@v2
                with:
                  php-version: 8.3
              
              - name: Install dependencies
                run: composer install --no-interaction
              
              - name: Extract PHPStan Level
                id: level
                run: |
                  if [ -f phpstan.neon ]; then
                    LEVEL=$(grep -oP "level: \K\d+" phpstan.neon || echo "0")
                  elif [ -f phpstan.neon.dist ]; then
                    LEVEL=$(grep -oP "level: \K\d+" phpstan.neon.dist || echo "0")
                  else
                    LEVEL="0"
                  fi
                  echo "level=$LEVEL" >> $GITHUB_OUTPUT
                  echo "PHPStan Level: $LEVEL"
              
              - name: Create Badge
                uses: schneegans/dynamic-badges-action@v1.7.0
                with:
                  auth: ${{ secrets.GIST_SECRET }}
                  gistID: YOUR_GIST_ID_HERE
                  filename: phpstan-${{ github.event.repository.name }}.json
                  label: PHPStan
                  message: level ${{ steps.level.outputs.level }}
                  color: brightgreen
        
        

        Configuración:

        1. Crear un GitHub Personal Access Token con scope gist

        2. Añadirlo a GitHub Secrets como GIST_SECRET

        3. Crear un Gist público en https://gist.github.com/

        4. Copiar el Gist ID (última parte de la URL)

        5. Reemplazar YOUR_GIST_ID_HERE en el workflow

        Badge a usar:

        [![PHPStan](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/{username}/{gist_id}/raw/phpstan-{repo}.json&style=flat-square)](https://phpstan.org/)
        
        

        Opción 3: Badge Manual (Más simple)

        Si prefieres simplicidad, actualiza manualmente el badge cuando cambies el level:

        <!-- Level 0 (rojo) -->
        [![PHPStan Level 0](https://img.shields.io/badge/PHPStan-level%200-red.svg?style=flat-square&logo=php)](https://phpstan.org/)
        
        <!-- Level 5 (verde) -->
        [![PHPStan Level 5](https://img.shields.io/badge/PHPStan-level%205-green.svg?style=flat-square&logo=php)](https://phpstan.org/)
        
        <!-- Level 8 (verde brillante) -->
        [![PHPStan Level 8](https://img.shields.io/badge/PHPStan-level%208-brightgreen.svg?style=flat-square&logo=php)](https://phpstan.org/)
        
        <!-- Level 9 / Max (verde brillante) -->
        [![PHPStan Level 9](https://img.shields.io/badge/PHPStan-level%209-brightgreen.svg?style=flat-square&logo=php)](https://phpstan.org/)
        [![PHPStan Max](https://img.shields.io/badge/PHPStan-level%20max-brightgreen.svg?style=flat-square&logo=php)](https://phpstan.org/)
        
        

        Colores recomendados por level:

        • Level 0-2: red
        • Level 3-4: orange o yellow
        • Level 5-6: yellowgreen o green
        • Level 7-9: brightgreen

        Badges Personalizados con Shields.io

        Para crear badges totalmente personalizados:

        <!-- Badge estático simple -->
        [![Custom](https://img.shields.io/badge/{label}-{message}-{color})](https://example.com)
        
        <!-- Ejemplos reales -->
        [![Hosted](https://img.shields.io/badge/Hosted-Proxmox-E57000?logo=proxmox)](https://www.proxmox.com/)
        [![Monitoring](https://img.shields.io/badge/Monitoring-Zabbix-D20000?logo=zabbix)](https://www.zabbix.com/)
        [![Stack](https://img.shields.io/badge/Stack-LEMP-339933)](https://www.nginx.com/)
        
        <!-- Badge con endpoint dinámico -->
        [![Dynamic](https://img.shields.io/endpoint?url=https://your-api.com/badge.json)](https://example.com)
        
        

        Formato del endpoint JSON:

        {
          "schemaVersion": 1,
          "label": "PHPStan",
          "message": "level 9",
          "color": "brightgreen",
          "logoSvg": "<svg>...</svg>"
        }
        
        

        Documentación completa: https://shields.io/


        Checklist de Configuración

        Requisitos Básicos

        • Repositorio público en GitHub
        • Archivo LICENSE.md presente
        • Archivo README.md con badges
        • .gitignore configurado
        • composer.json con metadatos completos

        Para Paquetes Packagist

        • Publicado en https://packagist.org/
        • composer.json con:
          • name correcto
          • description clara
          • license especificada
          • require con versiones de PHP
          • autoload configurado
        • Tags/Releases versionados (semver)

        Para GitHub Actions

        • Workflows en .github/workflows/
        • Workflow para tests: run-tests.yml
        • Workflow para code style: fix-php-code-style-issues.yml
        • Workflow para PHPStan: phpstan.yml
        • Secrets configurados (si se requieren)

        Para Code Coverage

        • Cuenta en Codecov.io vinculada
        • Token añadido a GitHub Secrets: CODECOV_TOKEN
        • Workflow configurado para subir coverage
        • Tests generan archivo coverage.xml

        Para Calidad de Código

        • Code Climate:
          • Repo conectado
          • .codeclimate.yml configurado
          • Badge ID obtenido
        • Scrutinizer:
          • Repo conectado
          • .scrutinizer.yml configurado
        • SonarCloud:
          • Proyecto configurado
          • sonar-project.properties creado
          • Project key obtenido

        Para Seguridad

        • Snyk vinculado al repositorio
        • Dependabot habilitado
        • SECURITY.md presente
        • Vulnerabilities monitorizadas

        Para Testing

        • Tests unitarios con PHPUnit o Pest
        • PHPStan configurado (phpstan.neon)
        • Code style configurado (Pint, PHP-CS-Fixer)
        • Coverage mínimo definido

        Documentación

        • README.md completo
        • CONTRIBUTING.md (si es open source)
        • CHANGELOG.md mantenido
        • PHPDoc en código
        • Wiki o docs externas (opcional)

        Referencias y Recursos

        Documentación Oficial

        • Shields.io: https://shields.io/
        • Packagist: https://packagist.org/about
        • GitHub Actions: https://docs.github.com/en/actions
        • RepoStatus: https://www.repostatus.org/

        Servicios de Calidad

        • Codecov: https://docs.codecov.com/
        • Code Climate: https://docs.codeclimate.com/
        • Scrutinizer: https://scrutinizer-ci.com/docs/
        • SonarCloud: https://docs.sonarcloud.io/

        Herramientas de Testing

        • PHPStan: https://phpstan.org/user-guide/getting-started
        • Pest: https://pestphp.com/docs/
        • PHPUnit: https://phpunit.de/documentation.html
        • Laravel Pint: https://laravel.com/docs/11.x/pint

        Seguridad

        • Snyk: https://docs.snyk.io/
        • Dependabot: https://docs.github.com/en/code-security/dependabot
        • OSSF: https://github.com/ossf/scorecard

        Mantenimiento de este Documento

        • Responsable: Abkrim
        • Frecuencia de revisión: Trimestral
        • Última revisión: 31 Diciembre 20252026-06-22
        • Próxima revisión: MarzoSeptiembre 2026

        Historial de Cambios

        Fecha Versión Cambios
        2025-12-31 1.0 Creación del documento inicial
        2026-06-22 1.1 Principio «un badge dinámico no debe poder mentir»; sección del skill /ai-badges; AGPL-3.0 + criterio AGPL-core / MIT-librería; PHPStan y Laravel regenerados desde la fuente; licencia dinámica packagist/l

        Soporte

        Para dudas o sugerencias sobre esta guía:

        1. Abrir issue en el repositorio del proyecto

        2. Consultar con el equipo de desarrollo

        3. Revisar documentación oficial de cada servicio


        Fin del documento