Mejores prácticas de Gobernanza

Un resumen condensado de las 25 prácticas de gobernanza más importantes para equipos móviles de Expo SDK 57 - extraídas de cada página de esta sección.

1. Publica estándares en docs/CONTRIBUTING.md: Nombres, carpetas y reglas de toque nativo viven en git - no en pines de Slack que los nuevos empleados nunca ven (Conceptos Básicos de Estándares).

2. Los barriles de características son bloqueadores de fusión: Importa solo desde @/features/<name> - las importaciones profundas acoplan refactores; refuerza con ESLint no-restricted-imports (Estándares de Codificación y Guías de Estilo).

3. app/ delgada, src/features/ gorda: Los archivos de ruta re-exportan pantallas; la lógica empresarial nunca vive en nombres de archivo de Expo Router - se alinea con Lista de verificación de reglas del proyecto Expo.

4. Las reglas de toque nativo tienen propietarios nombrados: plugins/, app.config.ts y ios/ / android/ revisados requieren CODEOWNERS de plataforma - los equipos de CNG regeneran, nunca editan a mano (Reglas de Módulos Nativos).

5. Una superficie de comando para calidad: format:check, lint, typecheck, test - idénticas en Husky, laptop y GitHub Actions (Compuertas de Calidad de CI).

6. Cero advertencias de ESLint en main: expo lint -- --max-warnings 0 en CI - las advertencias se convierten en deuda ignorada en una semana (Conceptos Básicos de Linting).

7. Prettier y ESLint no luchan: Elige Prettier para formateo y orden de importación; desactiva las reglas estilísticas de ESLint superpuestas (Prettier y Ordenamiento de Importaciones).

8. La plantilla de PR codifica compuertas humanas: Evidencia de dispositivos, adjuntos de diff nativos y casillas de verificación de estándares - la política supera el sistema de honor (Estándares de Codificación y Guías de Estilo).

9. ADR para cada excepción intencional: Las ediciones nativas "temporales" o violaciones de arquitectura sin ADR se vuelven permanentes - usa Registros de Decisiones de Arquitectura.

10. Confirma lockfiles; CI usa npm ci: Las instalaciones flotantes ocultan sesgo nativo/JS hasta TestFlight - nunca hagas gitignore package-lock.json (Gobernanza de Dependencias y Cadena de Suministro).

11. npx expo install para paquetes Expo: Los pines de versión manual causan fallos de doctor y bloqueos nativos de producción - Mejores prácticas de reglas Expo.

12. npm audit falla en alto/crítico en CI: Documenta el riesgo aceptado en docs/security-exceptions.md con vencimiento - las excepciones sin fechas no se aceptan (Gobernanza de Dependencias y Cadena de Suministro).

13. SBOM por etiqueta de lanzamiento de tienda: CycloneDX desde lockfile archivado con build_id de EAS - las auditorías empresariales preguntarán qué se envió en la compilación abc123, no en el main de hoy.

14. Las licencias de software de OSS nativo se envían en la aplicación: El paquete de configuración de iOS y la pantalla de OSS de Android se actualizan en cada bump nativo - revisión legal en adiciones de clase GPL.

15. Ventana de soporte N-1 del SDK solo: La producción admite el SDK actual y uno anterior - tres generaciones del SDK en el wild rompen OTA y soporte (Política de Actualización del SDK).

16. Campeón de actualización nombrado por cada bump del SDK: Responsable de rama, expo-doctor, matriz de vista previa y ADR de runtimeVersion - no un voluntario en sprint 47 (Habilidad de Actualización del SDK).

17. Actualizaciones del SDK en ramas dedicadas + worktrees: Nunca mezcles expo upgrade con trabajo de características en main - los hotfixes se mantienen posibles en worktree paralelo (Rebase Interactivo y Worktrees).

18. expo-doctor y vista previa eas build son compuertas de fusión: OTA no puede fijar sesgo nativo de una mala fusión del SDK - matriz de compilación completa antes de producción (Reglas de Lanzamiento y OTA).

19. Registro de EOL con propietarios y fechas límite: Arquitectura de RN, Expo SDK, pisos del SO y depreciaciones de API en docs/eol-registry.md - revisadas trimestralmente (Seguimiento de Depreciación y EOL).

20. Los bumps del piso del SO son decisiones de producto: Analítica de ASC / Play + ADR antes de aumentar deploymentTarget / minSdkVersion - la preferencia de ingeniería sola es insuficiente.

21. Los picos se limitan en tiempo con resultados de ADR: ADOPT, DEFER o REJECT documentados; ramas de pico eliminadas después de la demostración - sin fusión de viernes sin flags y QA (Picos, PoCs y Nueva Arquitectura).

22. Los picos de Brownfield usan artefactos aislados: expo-brownfield AAR/XCFramework - nunca copies-pegues bundles JS en activos de host (Conceptos Básicos de Brownfield).

23. Nueva Arquitectura validada en compilaciones similares a lanzamiento: Expo Go no es prueba - EAS preview + dispositivo smoke antes de la habilitación de NA en toda la organización en RN 0.86.

24. El calendario de riesgos alinea tres relojes: Binario de la tienda, bundle de OTA y depreciación de API de backend en un documento compartido - el EOL móvil no debe rezagarse con la eliminación de API (Calendario del Tren de Lanzamiento).

25. La gobernanza de Staff+ se mide por durabilidad: Políticas, runbooks y ADRs adoptados por equipos después de que te vayas - no líneas de código o fines de semana de lanzamiento heroicos (Crecimiento Profesional: Senior - Lead - Staff).

Preguntas Frecuentes

Relacionado

• Conceptos Básicos de Estándares - nombres, carpetas, toque nativo
• Estándares de Codificación y Guías de Estilo - libro de cocina de refuerzo
• Gobernanza de Dependencias y Cadena de Suministro - auditoría y SBOM
• Política de Actualización del SDK - N-1 y campeones
• Seguimiento de Depreciación y EOL - registro
• Picos, PoCs y Nueva Arquitectura - experimentación segura
• Crecimiento Profesional: Senior - Lead - Staff - ruta principal
• Lista de verificación de reglas del proyecto Expo - no-negociables técnicos
• Mejores prácticas de Linting y Formateo - resumen de compuerta de calidad

Versiones de pila: Esta página fue escrita para React 19.2.3, React Native 0.86.0 y Expo SDK 57 (expo ~57.0.4).