Registro público
Informe de salud del softwareesquema 0.11.0 · métricas 2.10.0 · 2026-07-17 15:23 UTC

nelmio / NelmioApiDocBundle

Generates documentation for your REST API from attributes

PHPMIT★ 2354 estrellas⑂ 902 forksdesde abr 2012Ver en GitHub ↗
TipoBibliotecaServicio de redHerramienta de línea de comandoscómo se determina

nelmio/NelmioApiDocBundle tiene un índice de salud de 93 sobre 100, lo que lo sitúa en la banda Excepcional. Su puntuación más alta es Vitality (89/100) y la más baja, AI Readiness (59/100). Se actualizó por última vez hoy. 2 personas concentran la mayor parte del trabajo reciente.

93
global / 100
Excepcional

Índice de salud del software

Las métricas se agrupan en categorías ponderadas sobre una escala estandarizada de 1 a 100. El resultado global parte de su media ponderada, calibrada contra la distribución del registro público para que las bandas tengan significado percentil; cuando la evidencia pública activa la Política de Jurisdicciones de Alto Riesgo, la calificación se ajusta y recibe un límite «En riesgo» de 34.

93
Excepcional93-100El nivel más alto del registro (≈ el 5% superior); cumple prácticamente todos los criterios evaluados
Excelente80-92Sólido en todos los frentes; carencias menores
Bueno65-79Saludable; carencias limitadas y manejables
Moderado50-64Aceptable con carencias notables; se recomienda revisión
Débil35-49Debilidades sustanciales en varias áreas
En riesgo20-34Debilidades significativas; su adopción exige cautela
Crítico1-19Problemas graves (proyecto abandonado, un solo mantenedor, sin higiene)
VitalidadComunidad yAdopciónSostenibilidady GobernanzaCalidad deIngenieríaSeguridadPreparaciónpara IA

Perfil de puntuación

Cada eje es una categoría. La forma importa más que la media: un proyecto sano llena toda la figura, mientras que un perfil de picos y cráteres indica que la fortaleza en una dimensión enmascara el riesgo en otra.

El resultado global ponderado 79 se calibra a 93 en la escala publicada del índice (calibración del registro 2026-08-02).

Titularidad

NelmioOrganización
34 seguidores18 repositorios públicosdesde may 2016

Este repositorio está respaldado por una organización: una custodia compartida y responsable que puede sobrevivir a cualquier mantenedor individual.

Ecosistemas de paquetes

RegistroPaqueteVersiónDescargas / mesVersionesÚltima publicaciónEtiquetas
Packagistnelmio/api-doc-bundlev5.10.31.195.999202hace 46 díasdocumentationrestapidoc

Métricas por categoría

Vitalidad

¿Está vivo el proyecto: se escribe código y se publican versiones?

89Excelente · 21% del índice global
Cómo se puntúa
36/36Recencia de pushúltimo push hace 0 días
16.6/36Cadencia de commits24/52 semanas con commits
18/18Volumen de commits145 commits en el último año
10/10OpenSSF Scorecard: Maintained15 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
Datos de entrada utilizados
commits_last_year145
human_commit_share
days_since_last_push0
active_weeks_last_year24
Cómo se puntúa
27/27Publica versiones100 versiones publicadas
36/36Recencia de las versionesúltima versión hace 46 días
27/27Cadencia de publicaciónuna versión cada ~16 días
0/10OpenSSF Scorecard: Signed-Releasessin datos
Datos de entrada utilizados
releases_count100
latest_release_tagv5.10.3
releases_from_tagsno
days_since_latest_release46
mean_days_between_releases16
Excluidos de la puntuación (sin datos o no aplicable): OpenSSF Scorecard: Signed-Releases. Los pesos restantes se han renormalizado.

Comunidad y Adopción

¿Tiene el proyecto usuarios, descargas, atención y unas condiciones acogedoras para quienes contribuyen?

87Excelente · 17% del índice global
Cómo se puntúa
54.7/60Estrellas2354 estrellas
24.6/25Forks902 forks
10/15Observadores65 observadores
Datos de entrada utilizados
forks902
stars2354
watchers65
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history
Cómo se puntúa
22.5/22.5README
22.5/22.5Licencialicencia reconocida (MIT)
18/18Guía CONTRIBUTING
0/13.5Código de conducta
0/7.2Plantilla de issues
6.3/6.3Plantilla de PR
Datos de entrada utilizados
has_readme
has_license
readme_badges
has_contributing
has_issue_templateno
has_code_of_conductno
readme_badge_services
has_pull_request_template
Cómo se puntúa
80/80Descargas mensuales1.195.999 descargas/mes en packagist
16.7/20Dependientes en el registro321 paquetes dependen de él
Datos de entrada utilizados
packagesnelmio/api-doc-bundle
dependents321
ecosystemspackagist
total_downloads68.023.306
monthly_downloads1.195.999
unverified_packages_excluded

Sostenibilidad y Gobernanza

¿Sobrevivirá el proyecto a sus personas: factor bus, capacidad de respuesta, quién lo respalda y mantenimiento del paquete?

79Bueno · 23% del índice global
Cómo se puntúa
25.2/54Factor busla mitad de los commits recae en 2 contribuyente(s)
15/22.5Distribución de commitsel principal contribuyente firma el 33% de los commits
13.5/13.5Amplitud de contribuyentes100 contribuyentes
10/10OpenSSF Scorecard: Contributorsproject has 42 contributing companies or organizations
Datos de entrada utilizados
bus_factor2
contributors_sampled100
top_contributor_share0,334
Cómo se puntúa
40.2/42Resolución de issues96% de issues cerradas
21.9/30Aceptación de PR1054/1442 PR decididos fusionados
0/13Newcomer PR acceptanceningún PR de un contribuyente primerizo decidido en 30 d
7.5/15OpenSSF Scorecard: Code-ReviewFound 7/14 approved changesets -- score normalized to 5
Datos de entrada utilizados
merged_prs1054
open_issues54
closed_issues1234
prs_merged_7d
prs_decided_7d
prs_merged_30d
prs_decided_30d
issue_closed_ratio0,958
closed_unmerged_prs388
first_time_authors_30d
first_time_prs_merged_30d
first_time_prs_decided_30d
Excluidos de la puntuación (sin datos o no aplicable): Newcomer PR acceptance. Los pesos restantes se han renormalizado.
Cómo se puntúa
30/30Respaldo de la propiedadpropiedad de una organización
0/20Dominio verificadoel estado de dominio verificado no se leyó para esta organización
11.1/25Alcance del propietario34 seguidores de nelmio
21.3/25Trayectoria18 repos públicos, cuenta de ~10 años
Datos de entrada utilizados
followers34
owner_typeOrganization
is_verified
owner_loginnelmio
public_repos18
account_age_days3699
Excluidos de la puntuación (sin datos o no aplicable): Dominio verificado. Los pesos restantes se han renormalizado.
Cómo se puntúa
25/25Publicado y resoluble1 paquete(s) en packagist
35/35Recencia de publicaciónúltima publicación hace 46 días
20/20Historial de versiones202 versiones en el registro
20/20No obsoletoactivo, ni obsoleto ni retirado
Datos de entrada utilizados
packagesnelmio/api-doc-bundle
ecosystemspackagist
any_deprecatedno
min_days_since_publish46

Calidad de Ingeniería

¿Existen unas prácticas mínimas de ingeniería y documentación?

79Bueno · 19% del índice global
Cómo se puntúa
24/24Flujos de trabajo de CI9 flujo(s) de trabajo
24/24Pruebas presentes
16/16Configuración de linter.php-cs-fixer.dist.php
0/9.6Hooks de pre-commit
0/6.4.editorconfig
18/20OpenSSF Scorecard: CI-Tests27 out of 29 merged PRs checked by a CI test -- score normalized to 9
Datos de entrada utilizados
has_ci
has_tests
has_editorconfigno
has_linter_config
has_precommit_configno
Cómo se puntúa
30/30README
25/25Directorio de documentación
0/15Sitio de documentación / página del proyecto
10/10Descripción del repositorio
10/10Topics10 topics
0/10Wiki
Datos de entrada utilizados
topicsphp, symfony-bundle, symfony, bundle, api, api-documentation, redoc, swagger, swagger-php, openapi
has_wikino
homepage
docs_site
has_readme
has_docs_dir
has_description

Seguridad

¿Son sólidas las prácticas visibles de seguridad y de cadena de suministro, sin exposición jurisdiccional de alto riesgo sin resolver?

62Moderado · 16% del índice global
Cómo se puntúa
7.5/7.5Binary-Artifactsno binaries found in the repo
2.2/7.5Branch-Protectionbranch protection is not maximal on development and all release branches
2.2/2.5CI-Tests27 out of 29 merged PRs checked by a CI test -- score normalized to 9
0/2.5CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
3.8/7.5Code-ReviewFound 7/14 approved changesets -- score normalized to 5
2.5/2.5Contributorsproject has 42 contributing companies or organizations
0/10Dangerous-Workflowsin datos
7.5/7.5Dependency-Update-Toolupdate tool detected
0/5Fuzzingproject is not fuzzed
2.5/2.5Licencialicense file detected
7.5/7.5Maintained15 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
0/5Packagingsin datos
0/5Pinned-Dependenciessin datos
0/5SASTSAST tool is not run on all commits -- score normalized to 0
0/5Security-Policysecurity policy file not detected
0/7.5Signed-Releasessin datos
0/7.5Token-Permissionssin datos
7.5/7.5Vulnerabilities0 existing vulnerabilities detected
Datos de entrada utilizados
sourceopenssf_scorecard
checks_evaluated13
scorecard_versionv5.5.0
checks_inconclusive5
scorecard_aggregate6,2
Excluidos de la puntuación (sin datos o no aplicable): Dangerous-Workflow, Packaging, Pinned-Dependencies, Signed-Releases, Token-Permissions. Los pesos restantes se han renormalizado.

Preparación para IA

¿Hasta qué punto está el repositorio preparado para desarrollarse y mantenerse con agentes de codificación de IA? Tiene un peso deliberadamente pequeño (4%): las herramientas para agentes son una señal real de mantenimiento, pero un repositorio sin ninguna puede alcanzar igualmente 100/100.

59Moderado · 4% del índice global
Cómo se puntúa
45/45Instrucciones para agentes.github/copilot-instructions.md
0/15Documentación legible por máquinas (llms.txt)
0/40Historial de commits legiblesin datos
Datos de entrada utilizados
has_llms_txtno
llms_txt_url
legible_history_share
agent_instruction_files.github/copilot-instructions.md
agent_instruction_max_bytes5932
Excluidos de la puntuación (sin datos o no aplicable): Historial de commits legible. Los pesos restantes se han renormalizado.
Cómo se puntúa
0/18Arranque con un solo comando
22/22Pruebas automatizadas
11/11Configuración de lint / formato.php-cs-fixer.dist.php
0/11Verificación estática de tipos
0/10Entorno reproducible
0/10Práctica demostrada con agentessin datos
5/8Mantenimiento automatizadoautomatización de dependencias configurada, no observada en los commits muestreados
0/10OpenSSF Scorecard: Pinned-Dependenciessin datos
Datos de entrada utilizados
has_nixno
has_tests
lockfiles
has_dockerfileno
typed_languageno
bootstrap_files
has_devcontainerno
has_linter_config
typecheck_configs
agent_commit_share
toolchain_manifests
dependency_bot_commit_share0
Excluidos de la puntuación (sin datos o no aplicable): Práctica demostrada con agentes, OpenSSF Scorecard: Pinned-Dependencies. Los pesos restantes se han renormalizado.
Cómo se puntúa
0/45Código verificable por tiposPHP sin configuración de verificación de tipos
54.1/55Tamaños de archivo manejables5/293 archivos fuente de más de 60 KB
Datos de entrada utilizados
primary_languagePHP
largest_source_bytes3.723.524
source_files_sampled293
oversized_source_files5

Datos clave

2354estrellas de GitHub
100contribuidores
145commits en los últimos 12 meses
0días desde el último push
100versiones publicadas
2factor bus
54issues abiertas
npm, Packagistecosistemas de paquetes

Más detalle

OpenSSF Scorecard 6.2 / 10
6.2agregado

Evaluación de seguridad independiente y agnóstica en cuanto a herramientas, procedente del proyecto de código abierto OpenSSF Scorecard. Cada comprobación premia una práctica de seguridad, no la herramienta de un proveedor concreto. Las comprobaciones que Scorecard no pudo determinar se marcan como n/d y se excluyen de la puntuación de seguridad (nunca se cuentan como cero).Scorecard v5.5.0 · 2026-07-17 15:22 UTC

10Binary-Artifactsno binaries found in the repo
3Branch-Protectionbranch protection is not maximal on development and all release branches
9CI-Tests27 out of 29 merged PRs checked by a CI test -- score normalized to 9
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
5Code-ReviewFound 7/14 approved changesets -- score normalized to 5
10Contributorsproject has 42 contributing companies or organizations
n/dDangerous-Workflowno workflows found
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained15 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
n/dPackagingpackaging workflow not detected
n/dPinned-Dependenciesno dependencies found
0SASTSAST tool is not run on all commits -- score normalized to 0
0Security-Policysecurity policy file not detected
n/dSigned-Releasesno releases found
n/dToken-PermissionsNo tokens found
10Vulnerabilities0 existing vulnerabilities detected
Dependencias directas 19
RegistroPaqueteRestricción de versiónManifiesto
Packagistpsr/cache^1.0 || ^2.0 || ^3.0composer.json
Packagistpsr/container^1.0 || ^2.0composer.json
Packagistpsr/log^1.0 || ^2.0 || ^3.0composer.json
Packagistsymfony/config^6.4 || ^7.2 || ^8.0composer.json
Packagistsymfony/console^6.4 || ^7.2 || ^8.0composer.json
Packagistsymfony/dependency-injection^6.4 || ^7.2 || ^8.0composer.json
Packagistsymfony/deprecation-contracts^2.1 || ^3composer.json
Packagistsymfony/framework-bundle^6.4 || ^7.2 || ^8.0composer.json
Packagistsymfony/http-foundation^6.4 || ^7.2 || ^8.0composer.json
Packagistsymfony/http-kernel^6.4 || ^7.2 || ^8.0composer.json
Packagistsymfony/options-resolver^6.4 || ^7.2 || ^8.0composer.json
Packagistsymfony/property-info^6.4 || ^7.2 || ^8.0composer.json
Packagistsymfony/routing^6.4 || ^7.2 || ^8.0composer.json
Packagistsymfony/type-info^7.2 || ^8.0composer.json
Packagistzircote/swagger-php^4.11.1 || ^5.0 || ^6.0composer.json
npm@scalar/api-reference1.62.5utils/package.json
npm@stoplight/elements9.0.21utils/package.json
npmredoc2.5.3utils/package.json
npmswagger-ui-dist5.32.6utils/package.json
Todas las dependencias 50

Conjunto completo de dependencias resueltas según el grafo de dependencias de GitHub: 19 paquetes directos y 31 indirectos (transitivos). El cierre transitivo es completo cuando el repositorio incluye un lockfile.

RegistroPaqueteVersiónRelación
npm@scalar/api-reference1.62.5directa
npm@stoplight/elements9.0.21directa
npmredoc2.5.3directa
npmswagger-ui-dist5.32.6directa
Packagistpsr/cachedirecta
Packagistpsr/containerdirecta
Packagistpsr/logdirecta
Packagistsymfony/configdirecta
Packagistsymfony/consoledirecta
Packagistsymfony/dependency-injectiondirecta
Packagistsymfony/deprecation-contractsdirecta
Packagistsymfony/framework-bundledirecta
Packagistsymfony/http-foundationdirecta
Packagistsymfony/http-kerneldirecta
Packagistsymfony/options-resolverdirecta
Packagistsymfony/property-infodirecta
Packagistsymfony/routingdirecta
Packagistsymfony/type-infodirecta
Packagistzircote/swagger-phpdirecta
Packagistapi-platform/coreindirecta
Packagistdoctrine/inflectorindirecta
Packagistfriendsofphp/php-cs-fixerindirecta
Packagistfriendsofsymfony/rest-bundleindirecta
Packagistjms/serializerindirecta
Packagistjms/serializer-bundleindirecta
Packagistphpindirecta
Packagistphpdocumentor/reflection-docblockindirecta
Packagistphpdocumentor/type-resolverindirecta
Packagistphpstan/phpstanindirecta
Packagistphpstan/phpstan-phpunitindirecta
Packagistphpstan/phpstan-strict-rulesindirecta
Packagistphpstan/phpstan-symfonyindirecta
Packagistphpunit/phpunitindirecta
Packagistsymfony/assetindirecta
Packagistsymfony/browser-kitindirecta
Packagistsymfony/cacheindirecta
Packagistsymfony/dom-crawlerindirecta
Packagistsymfony/expression-languageindirecta
Packagistsymfony/finderindirecta
Packagistsymfony/formindirecta
Packagistsymfony/phpunit-bridgeindirecta
Packagistsymfony/security-csrfindirecta
Packagistsymfony/security-httpindirecta
Packagistsymfony/serializerindirecta
Packagistsymfony/translationindirecta
Packagistsymfony/twig-bundleindirecta
Packagistsymfony/uidindirecta
Packagistsymfony/validatorindirecta
Packagistwilldurand/hateoas-bundleindirecta
Packagistwilldurand/negotiationindirecta
Informe JSON sin procesar legible por máquina

Comentarios

¿Algo no cuadra en este informe, o hay ideas que compartir? Mediciones erróneas, herramientas no detectadas, ideas, preguntas: todo es bienvenido. Cada mensaje se lee y recibe respuesta.

El mensaje se conserva durante el inicio de sesión.

Las puntuaciones son señales, no garantías. Reflejan prácticas públicamente visibles en GitHub; no son una auditoría de código ni una garantía de seguridad.

Los datos ausentes se excluyen y los pesos se renormalizan; nunca se puntúan como cero. La metodología es versionada y abierta: métricas v2.10.0, esquema v0.11.0 — metodología completa · wiki de métricas.

Cómo se sitúa un resultado dentro del registro general: estadísticas agregadasPackagist.