trombonet12/Rally-Copilot / .claude/skills/android-create-system-component
android-create-system-component
Verifiedandroid-create-system-component
Crea el componente $ARGUMENTS en :app. Por defecto notification; si el valor no es uno de los tres, pedirlo y parar. Contexto: la navegación y el copiloto deben seguir funcionando con la pantalla apagada o la app en segundo plano (como un navegador), offline y sin Google Play Services (ver docs/DECISIONES.md).
Cuándo usarla
- Hace falta una pieza que el sistema mantiene viva fuera de la UI: servicio de ubicación de la navegación/grabación de tramo, notificación persistente, reacción a reinicio o actualización.
Cuándo NO usarla
- Solo declarar o pedir un permiso →
android-add-permission. - Pantallas Compose →
android-create-feature. - Workers de descarga de mapas (WorkManager): requieren decisión registrada (
registrar-decision) y dependencia condependency-add.
Precondiciones
- Lógica de dominio (notas, cronometraje, detección de tramo) en
:motor(puro): decide qué leer y cuándo; el componente de sistema solo recibe posiciones, delega y muestra. - Dependencias por Hilt (
android-create-hilt-modulesi faltan). Detalles de API y límites por versión de Android se confirman con la documentación oficial, no de memoria.
Pasos
Comunes
- Lógica en una clase testeable aparte (servicio y receiver solo delegan). Declarar en
AndroidManifest.xmlconexported="false"salvo que el sistema lo exija. - Textos en
strings_<feature>.xml(solo español). Escribir primero el test de la lógica, después el componente.
location-service
Serviceen primer plano conandroid:foregroundServiceType="location"; permisosFOREGROUND_SERVICEyFOREGROUND_SERVICE_LOCATION(API 34+) másACCESS_FINE_LOCATION(conandroid-add-permission). Se inicia desde la UI («Conducir», «Reconocimiento»), nunca en segundo plano.startForeground(id, notificación, FOREGROUND_SERVICE_TYPE_LOCATION)en los primeros segundos; notificación persistente con iconoic_stat_rally, estado del tramo y acción «Parar».- Posiciones con
LocationManager(GPS_PROVIDER,requestLocationUpdatesa ~1 Hz o lo decidido) tras una interfaz de dominio (fuente de posiciones), sin Fused Location de Google Play Services. Detectar pérdida de señal (sin fix en N s) y avisar. - Exponer el flujo de posiciones y el estado (en marcha, pausado, sin señal) a la UI vía un repositorio inyectado (
StateFlow), no por broadcast. - Parar ordenadamente (
stopForeground(STOP_FOREGROUND_REMOVE)+stopSelf) al llegar, al parar el usuario o al revocar el permiso; persistir el tramo en curso en Room para sobrevivir a la muerte del proceso.
notification
- Canal del servicio de conducción (importancia baja, sin sonido: la voz va por TTS) y canal de avisos (incidencias, importancia alta), ids constantes, creados idempotentes al arrancar la app.
NotificationFactoryinyectable: iconoic_stat_rally, título,PendingIntentinmutable que abre la pantalla de conducción, acción para parar.POST_NOTIFICATIONSen runtime (API 33+) conandroid-add-permission; sin él el servicio funciona igualmente.
boot-receiver
- Receiver para
MY_PACKAGE_REPLACED(yBOOT_COMPLETEDsolo si una decisión lo requiere) que limpia tramos a medias o retoma tareas pendientes desde Room; idempotente. Nunca reinicia la navegación solo.
Validaciones / tests
./gradlew ktlintCheck detekt lintDebug testDebugUnitTest assembleDebug.- Unit/Robolectric: lógica del servicio con fuente de posiciones fake, construcción de notificación y canal (
ShadowNotificationManager), arranque/parada del servicio (ShadowService). - Prueba manual en emulador con
gps-replay+qa-scenario screen-off|background|gps-loss; revisar conandroid-review(location, background, permissions).
Definition of Done
- Componente declarado en el manifest con su
foregroundServiceType, no exportado salvo necesidad, y lógica cubierta por tests. - Sin Google Play Services; posiciones tras una interfaz de dominio.
- Sigue funcionando con pantalla apagada y en segundo plano (escenario ejecutado).
- Sin coordenadas ni datos de usuario en logs.
-
./gradlew ktlintCheck detekt lintDebug testDebugUnitTest assembleDebugen verde.
Docs a actualizar
docs/DECISIONES.mdsi cambia el enfoque de servicio o ubicación · docs/ESTADO.md (skillsession-handoff)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |