Lista de Verificación de Recorrido del Código Base

Una lista de verificación por niveles para dónde viven las rutas, características, configuración nativa e integración continua en una aplicación Expo SDK 57 - úsala el segundo día con un compañero, no como una búsqueda en solitario.

Cómo Usar Esta Lista de Verificación

Completa Nivel 1 antes de tu primer PR; Nivel 2 antes de la característica capstone; Nivel 3–4 en la segunda semana.
Reemplaza rutas de placeholder (features/orders/) con los nombres reales de tu repositorio - usa grep si el README está desactualizado.
Marca cada item con ✓ encontrado, ? poco claro, o ✗ faltante - escala los ✗ al responsable de la plataforma.
Registra las respuestas en tu PR de incorporación o wiki interno - la próxima contratación hereda tus notas.
Vuelve a ejecutar el Nivel 4 cuando te unas a un nuevo equipo o después de una migración de arquitectura importante.

Nivel 1 - Primer Día (1–8)

Puedes ejecutar Metro y encontrar la pantalla de inicio sin pedir ayuda a Slack.

README de entrada del repositorio - comando de clon, versión de Node, npm ci vs pnpm, enlace a canales de Slack.
- Busca: engines.node, canal #mobile o #app, enlace al proyecto EAS
- Pregunta si falta: "¿Dónde está el documento de inicio canónico?"
Scripts de package.json - cómo se invocan lint, typecheck, test y start.
- Busca: expo start, typecheck, lint, test - los mismos scripts que llama CI
- Relacionado: Fundamentos de Configuración de Proyecto
SDK pin - versiones de expo, react, react-native coinciden con la matriz SDK 57.
- Busca: "expo": "~57.0.4", "react": "19.2.3", "react-native": "0.86.0"
- Verifica: npx expo-doctor pasa en clon limpio
Directorio app/ - rutas basadas en archivos (Expo Router).
- Busca: _layout.tsx, index.tsx, (tabs)/ o grupos de rutas
- Regla: Los archivos de ruta permanecen delgados - re-exporta pantallas de características
- Relacionado: Fundamentos de Expo Router
Root layout app/_layout.tsx - providers, fuentes, splash, navegador raíz.
- Busca: QueryClient, tema, puerta de auth, Stack / Tabs de expo-router
- Señal: Todos los wrappers globales deben estar aquí o en un archivo de provider importado
app.config.ts o app.json - bundle IDs, iconos, plugins, extra para env.
- Busca: ios.bundleIdentifier, android.package, plugins: [], extra.eas.projectId
- Relacionado: Fundamentos de Configuración de Proyecto
Plantilla de entorno - .env.example con variables EXPO_PUBLIC_* documentadas.
- Busca: URL de API de staging, claves de feature flag seguras para el bundle del cliente
- Nunca: Secretos privados de API en EXPO_PUBLIC_
CONTRIBUTING.md - flujo de rama, estilo de commit, plantilla de PR, etiqueta de compilación previa.
- Busca: reglas de etiqueta needs-preview, mención de CODEOWNERS, commits convencionales

Nivel 2 - Primer PR (9–16)

Puedes rastrear una acción del usuario desde tap hasta red.

Convención de carpeta de características - dónde vive la lógica de pantalla fuera de app/.
- Busca: features/<name>/screens|hooks|api|components/
- Patrones alternativos: src/modules/, FSD entities/ + features/
- Relacionado: Estructura de Carpetas para Características
Cliente API compartido - un único wrapper HTTP con headers de auth y URL base.
- Busca: shared/api/client.ts, lib/api.ts, o factory createApiClient()
- Rastrea: Screen → hook → ordersApi.getById → client.get
Puerta de auth/sesión - cómo se redirigen los usuarios sin iniciar sesión.
- Busca: Redirect en app/_layout.tsx, grupo de ruta (auth)/, o guardia useAuth()
- Pregunta: ¿Dónde se almacena el refresh token? (patrón expo-secure-store)
Estrategia de estado - qué vive en TanStack Query vs Zustand vs context.
- Busca: useQuery para datos del servidor; guarda solo para estado de sesión de UI
- Olor: fetch dentro de acciones de Zustand duplicando caché de query
Entrada del sistema de diseño - botones, tipografía, tokens de tema.
- Busca: shared/ui/, @/components, o importación de paquete externo
- Pregunta: URL de Storybook o catálogo en dispositivo si existe
Perfiles de compilación eas.json - development, preview, production.
- Busca: developmentClient, distribution: internal, channel por perfil
- Relacionado: Fundamentos de EAS Build
Rutas de TypeScript - mapeo de alias @/ en tsconfig.json.
- Busca: "paths": { "@/*": ["./*"] } o nombres de paquetes de monorepo
- Verifica: Ir a definición desde ruta a pantalla de características funciona en IDE
Test colocation - política de *.test.tsx junto a componentes o carpeta __tests__.
- Busca: jest.config.js, jest.setup.ts, preset jest-expo
- Ejecuta: npm test -- --listTests | head

Nivel 3 - Segunda Semana (17–24)

Puedes razonar sobre comportamiento nativo y depurar compilaciones con forma de producción.

Plugins de configuración - cambios nativos sin editar manualmente ios/ / android/.
- Busca: plugins: ["expo-router", "./plugins/withCustom"] en app config
- Pregunta: ¿Cuándo fue el último npx expo prebuild y se ha adoptado CNG?
Presencia de ios/ y android/ - managed vs bare vs directorios nativos generados.
- Managed/CNG: carpetas en gitignore - EAS genera en compilación
- Bare: carpetas committed - pod install local requerido
- Relacionado: Fundamentos de Prebuild
Configuración de deep linking - scheme, universal links, intent filters.
- Busca: scheme en app config, apple-app-site-association, intent filters de Android
- Relacionado: Fundamentos de Deep Linking
Cableado de notificaciones push - registro de token y ruta de inicio en frío.
- Busca: configuración de expo-notifications, listener de respuesta de notificación en app/_layout.tsx
- Pregunta: ¿Qué entorno envía pushes de prueba?
Análisis y reporte de errores - Sentry, Datadog, Amplitude, etc.
- Busca: init en root layout o AppProviders, patrón de uso de captureException
- Pregunta: Reglas de PII - ¿qué está prohibido en breadcrumbs?
Actualizaciones OTA - canales y política de runtimeVersion.
- Busca: config de expo-updates, nombres de canal eas update en docs
- Relacionado: Fundamentos de Actualizaciones OTA
Carpeta Maestro / E2E - flujos de humo y cuándo CI los ejecuta.
- Busca: .maestro/smoke.yml, appId coincidiendo con identificador de bundle
- Relacionado: Fundamentos de Pruebas Móviles
Internacionalización - archivos de locale y formato de fecha/número.
- Busca: i18n/, locales/, uso de expo-localization
- Olor: Strings hard-coded en pantallas de características sin extracción

Nivel 4 - Alfabetización de Lanzamiento (25–30)

Sabes cómo el código se convierte en un binario de tienda y a quién contactar cuando se rompe.

Ubicación del flujo de CI - GitHub Actions, GitLab CI, o EAS Workflows.
- Busca: .github/workflows/pr-checks.yml, .eas/workflows/
- Rastrea: PR abierto → qué jobs se ejecutan → checks requeridos para merge
Pipelines de PR vs lanzamiento - triggers separados y secretos.
- Busca: pull_request para lint/tsc/test; tags: v* para eas build
- Relacionado: Fundamentos de CI/CD Móvil
Documentación de EXPO_TOKEN y secretos - dónde viven las credenciales de robot (no en el repositorio).
- Busca: runbook de secretos de org de GitHub, nombre de vault de 1Password
- Nunca: Tokens en YAML de flujo de trabajo en texto plano
Ruta de envío a la tienda - quién ejecuta eas submit y pistas de TestFlight / Play.
- Busca: perfil submit en eas.json, links de documentación de prueba interna
- Relacionado: EAS Submit
Límites de monorepo - si aplica, qué espacio de trabajo es la aplicación móvil.
- Busca: apps/mobile/, packages/ui, filtros de pipeline turbo.json
- Relacionado: Monorepo con Turborepo
CODEOWNERS y on-call - quién debe aprobar cambios en app/, nativo, o lanzamiento.
- Busca: .github/CODEOWNERS, link de programación de PagerDuty / on-call
- Pregunta: Proceso de hotfix fuera de horas de negocio

Plantilla de Sesión de Recorrido

Usa esta agenda de 60 minutos con un compañero:

## Recorrido del código base - <hire> + <buddy> - <date>
 
### Nivel 1 (20m)
- [ ] Ruta de clon del README verificada
- [ ] app/_layout.tsx recorrida
- [ ] Bundle IDs de app.config.ts anotados
 
### Nivel 2 (25m)
- [ ] Rastreado: <elige una característica> tap → API
- [ ] Perfiles de eas.json explicados
- [ ] Comando de test ejecutado juntos
 
### Nivel 3-4 (15m bosquejo)
- [ ] Checks de PR de CI nombrados
- [ ] Etiqueta de compilación previa demostrada
- [ ] Preguntas abiertas registradas abajo
 
### Preguntas abiertas → PRs de documentación
1.
2.

FAQs

Nuestras rutas no coinciden con la lista de verificación - ¿ahora qué?

Actualiza el wiki de tu equipo con una tabla de mapa de rutas. Envía una PR de documentación agregando una sección ## Mapa del repositorio al README vinculando carpetas reales.

¿Qué tan profundo en Nivel 4 para juniors?

Conciencia solamente en la primera semana - "PR checks viven aquí, releases tagged allá." El deber de lanzamiento práctico llega después del primer preview build.

¿Repositorio brownfield con aplicaciones nativas?

Agrega items para punto de entrada de aplicación host, URL de bundle de RN, y módulos bridge - ver Fundamentos de Brownfield.

Relacionado

Fundamentos de Incorporación - configuración de máquina antes del recorrido
Ruta de Aprendizaje de la Primera Semana - arco de característica capstone
Fundamentos de Configuración de Proyecto - layout SDK 57 por defecto
Fundamentos de Expo Router - enrutamiento app/
Fundamentos de EAS Build - perfiles de compilación
Fundamentos de CI/CD Móvil - pipelines de PR vs lanzamiento

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

Cómo Usar Esta Lista de Verificación

Completa Nivel 1 antes de tu primer PR; Nivel 2 antes de la característica capstone; Nivel 3–4 en la segunda semana.
Reemplaza rutas de placeholder (features/orders/) con los nombres reales de tu repositorio - usa grep si el README está desactualizado.
Marca cada item con ✓ encontrado, ? poco claro, o ✗ faltante - escala los ✗ al responsable de la plataforma.
Registra las respuestas en tu PR de incorporación o wiki interno - la próxima contratación hereda tus notas.
Vuelve a ejecutar el Nivel 4 cuando te unas a un nuevo equipo o después de una migración de arquitectura importante.

Nivel 1 - Primer Día (1–8)

Puedes ejecutar Metro y encontrar la pantalla de inicio sin pedir ayuda a Slack.

README de entrada del repositorio - comando de clon, versión de Node, npm ci vs pnpm, enlace a canales de Slack.
- Busca: engines.node, canal #mobile o #app, enlace al proyecto EAS
- Pregunta si falta: "¿Dónde está el documento de inicio canónico?"
Scripts de package.json - cómo se invocan lint, typecheck, test y start.
- Busca: expo start, typecheck, lint, test - los mismos scripts que llama CI
- Relacionado: Fundamentos de Configuración de Proyecto
SDK pin - versiones de expo, react, react-native coinciden con la matriz SDK 57.
- Busca: "expo": "~57.0.4", "react": "19.2.3", "react-native": "0.86.0"
- Verifica: npx expo-doctor pasa en clon limpio
Directorio app/ - rutas basadas en archivos (Expo Router).
- Busca: _layout.tsx, index.tsx, (tabs)/ o grupos de rutas
- Regla: Los archivos de ruta permanecen delgados - re-exporta pantallas de características
- Relacionado: Fundamentos de Expo Router
Root layout app/_layout.tsx - providers, fuentes, splash, navegador raíz.
- Busca: QueryClient, tema, puerta de auth, Stack / Tabs de expo-router
- Señal: Todos los wrappers globales deben estar aquí o en un archivo de provider importado
app.config.ts o app.json - bundle IDs, iconos, plugins, extra para env.
- Busca: ios.bundleIdentifier, android.package, plugins: [], extra.eas.projectId
- Relacionado: Fundamentos de Configuración de Proyecto
Plantilla de entorno - .env.example con variables EXPO_PUBLIC_* documentadas.
- Busca: URL de API de staging, claves de feature flag seguras para el bundle del cliente
- Nunca: Secretos privados de API en EXPO_PUBLIC_
CONTRIBUTING.md - flujo de rama, estilo de commit, plantilla de PR, etiqueta de compilación previa.
- Busca: reglas de etiqueta needs-preview, mención de CODEOWNERS, commits convencionales

Nivel 2 - Primer PR (9–16)

Puedes rastrear una acción del usuario desde tap hasta red.

Convención de carpeta de características - dónde vive la lógica de pantalla fuera de app/.
- Busca: features/<name>/screens|hooks|api|components/
- Patrones alternativos: src/modules/, FSD entities/ + features/
- Relacionado: Estructura de Carpetas para Características
Cliente API compartido - un único wrapper HTTP con headers de auth y URL base.
- Busca: shared/api/client.ts, lib/api.ts, o factory createApiClient()
- Rastrea: Screen → hook → ordersApi.getById → client.get
Puerta de auth/sesión - cómo se redirigen los usuarios sin iniciar sesión.
- Busca: Redirect en app/_layout.tsx, grupo de ruta (auth)/, o guardia useAuth()
- Pregunta: ¿Dónde se almacena el refresh token? (patrón expo-secure-store)
Estrategia de estado - qué vive en TanStack Query vs Zustand vs context.
- Busca: useQuery para datos del servidor; guarda solo para estado de sesión de UI
- Olor: fetch dentro de acciones de Zustand duplicando caché de query
Entrada del sistema de diseño - botones, tipografía, tokens de tema.
- Busca: shared/ui/, @/components, o importación de paquete externo
- Pregunta: URL de Storybook o catálogo en dispositivo si existe
Perfiles de compilación eas.json - development, preview, production.
- Busca: developmentClient, distribution: internal, channel por perfil
- Relacionado: Fundamentos de EAS Build
Rutas de TypeScript - mapeo de alias @/ en tsconfig.json.
- Busca: "paths": { "@/*": ["./*"] } o nombres de paquetes de monorepo
- Verifica: Ir a definición desde ruta a pantalla de características funciona en IDE
Test colocation - política de *.test.tsx junto a componentes o carpeta __tests__.
- Busca: jest.config.js, jest.setup.ts, preset jest-expo
- Ejecuta: npm test -- --listTests | head

Nivel 3 - Segunda Semana (17–24)

Puedes razonar sobre comportamiento nativo y depurar compilaciones con forma de producción.

Plugins de configuración - cambios nativos sin editar manualmente ios/ / android/.
- Busca: plugins: ["expo-router", "./plugins/withCustom"] en app config
- Pregunta: ¿Cuándo fue el último npx expo prebuild y se ha adoptado CNG?
Presencia de ios/ y android/ - managed vs bare vs directorios nativos generados.
- Managed/CNG: carpetas en gitignore - EAS genera en compilación
- Bare: carpetas committed - pod install local requerido
- Relacionado: Fundamentos de Prebuild
Configuración de deep linking - scheme, universal links, intent filters.
- Busca: scheme en app config, apple-app-site-association, intent filters de Android
- Relacionado: Fundamentos de Deep Linking
Cableado de notificaciones push - registro de token y ruta de inicio en frío.
- Busca: configuración de expo-notifications, listener de respuesta de notificación en app/_layout.tsx
- Pregunta: ¿Qué entorno envía pushes de prueba?
Análisis y reporte de errores - Sentry, Datadog, Amplitude, etc.
- Busca: init en root layout o AppProviders, patrón de uso de captureException
- Pregunta: Reglas de PII - ¿qué está prohibido en breadcrumbs?
Actualizaciones OTA - canales y política de runtimeVersion.
- Busca: config de expo-updates, nombres de canal eas update en docs
- Relacionado: Fundamentos de Actualizaciones OTA
Carpeta Maestro / E2E - flujos de humo y cuándo CI los ejecuta.
- Busca: .maestro/smoke.yml, appId coincidiendo con identificador de bundle
- Relacionado: Fundamentos de Pruebas Móviles
Internacionalización - archivos de locale y formato de fecha/número.
- Busca: i18n/, locales/, uso de expo-localization
- Olor: Strings hard-coded en pantallas de características sin extracción

Nivel 4 - Alfabetización de Lanzamiento (25–30)

Sabes cómo el código se convierte en un binario de tienda y a quién contactar cuando se rompe.

Ubicación del flujo de CI - GitHub Actions, GitLab CI, o EAS Workflows.
- Busca: .github/workflows/pr-checks.yml, .eas/workflows/
- Rastrea: PR abierto → qué jobs se ejecutan → checks requeridos para merge
Pipelines de PR vs lanzamiento - triggers separados y secretos.
- Busca: pull_request para lint/tsc/test; tags: v* para eas build
- Relacionado: Fundamentos de CI/CD Móvil
Documentación de EXPO_TOKEN y secretos - dónde viven las credenciales de robot (no en el repositorio).
- Busca: runbook de secretos de org de GitHub, nombre de vault de 1Password
- Nunca: Tokens en YAML de flujo de trabajo en texto plano
Ruta de envío a la tienda - quién ejecuta eas submit y pistas de TestFlight / Play.
- Busca: perfil submit en eas.json, links de documentación de prueba interna
- Relacionado: EAS Submit
Límites de monorepo - si aplica, qué espacio de trabajo es la aplicación móvil.
- Busca: apps/mobile/, packages/ui, filtros de pipeline turbo.json
- Relacionado: Monorepo con Turborepo
CODEOWNERS y on-call - quién debe aprobar cambios en app/, nativo, o lanzamiento.
- Busca: .github/CODEOWNERS, link de programación de PagerDuty / on-call
- Pregunta: Proceso de hotfix fuera de horas de negocio

Plantilla de Sesión de Recorrido

Usa esta agenda de 60 minutos con un compañero:

## Recorrido del código base - <hire> + <buddy> - <date>
 
### Nivel 1 (20m)
- [ ] Ruta de clon del README verificada
- [ ] app/_layout.tsx recorrida
- [ ] Bundle IDs de app.config.ts anotados
 
### Nivel 2 (25m)
- [ ] Rastreado: <elige una característica> tap → API
- [ ] Perfiles de eas.json explicados
- [ ] Comando de test ejecutado juntos
 
### Nivel 3-4 (15m bosquejo)
- [ ] Checks de PR de CI nombrados
- [ ] Etiqueta de compilación previa demostrada
- [ ] Preguntas abiertas registradas abajo
 
### Preguntas abiertas → PRs de documentación
1.
2.

FAQs

Nuestras rutas no coinciden con la lista de verificación - ¿ahora qué?

Actualiza el wiki de tu equipo con una tabla de mapa de rutas. Envía una PR de documentación agregando una sección ## Mapa del repositorio al README vinculando carpetas reales.

¿Qué tan profundo en Nivel 4 para juniors?

Conciencia solamente en la primera semana - "PR checks viven aquí, releases tagged allá." El deber de lanzamiento práctico llega después del primer preview build.

¿Repositorio brownfield con aplicaciones nativas?

Agrega items para punto de entrada de aplicación host, URL de bundle de RN, y módulos bridge - ver Fundamentos de Brownfield.

Relacionado

Fundamentos de Incorporación - configuración de máquina antes del recorrido
Ruta de Aprendizaje de la Primera Semana - arco de característica capstone
Fundamentos de Configuración de Proyecto - layout SDK 57 por defecto
Fundamentos de Expo Router - enrutamiento app/
Fundamentos de EAS Build - perfiles de compilación
Fundamentos de CI/CD Móvil - pipelines de PR vs lanzamiento

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

Lista de Verificación de Recorrido del Código Base

Buscar en la documentación

Lista de Verificación de Recorrido del Código Base