# Proposal: Notification Visual Polish

## Intent

PluriWave's 3 native alarm notifications use generic Android system drawables (`ic_dialog_info`, `ic_lock_idle_alarm`) and carry no brand color, so they look unbranded in the status bar and shade. The audio/media notification sets the brand color but no explicit icon, so Android auto-silhouettes the full-color `mipmap/ic_launcher` into an illegible status-bar blob. This change gives all 4 notifications a single, legible, on-brand identity.

## Scope

### In Scope
- One new monochrome vector drawable: `android/app/src/main/res/drawable/ic_stat_pluriwave.xml` (equalizer-bars glyph, 24x24dp, white fill on transparent).
- Wire the icon into all 4 notification builders (3 Kotlin `setSmallIcon`, 1 Dart `androidNotificationIcon`).
- Add `.setColor()` with the shared cyan brand value `#21D4D9` to the 3 Kotlin alarm builders (audio notification already has it).
- Dart test asserting the new `androidNotificationIcon` config field.

### Out of Scope (deferred follow-up candidates)
- Action-button icons (snooze/stop/skip currently pass `0`).
- BigTextStyle / expanded layouts.
- Fallback artwork / large icon.
- NotificationChannelGroup topology changes.

## Capabilities

### New Capabilities
- None. This is presentation-only wiring; no new user-facing capability requirement is introduced.

### Modified Capabilities
- None. No spec-level behavior of `alarm-pre-notice-countdown` changes — timing, scheduling, and countdown text are untouched. Only icon/color presentation is altered.

## Approach

Hand-author one `<vector>` drawable (equalizer bars adapted from Material's Apache-2.0 `graphic_eq`, bold enough to read at status-bar size) since no image-generation tooling is available and vector XML is density-independent (no mipmap variants needed). Reference it from all 4 call sites via generic `drawable/ic_stat_pluriwave` resolution. Define the color literal once per Kotlin file (or a shared `@ColorInt` constant) and reuse across the 3 builders rather than duplicating. Extract the Dart icon string to a named top-level const so the existing `notification_color_test.dart` pattern extends cleanly.

Single shared cyan across all 3 alarm builders (not a second coral "meaning"): pre-notice and snooze already share one channel, and matching the shipped audio-notification cyan keeps the whole shade coherent. `setColor` edits are applied per-file (builders differ: `setSilent` vs `setFullScreenIntent`, distinct priorities) — no shared helper.

## Affected Areas

| Area | Impact | Description |
|------|--------|-------------|
| `android/app/src/main/res/drawable/ic_stat_pluriwave.xml` | New | Monochrome equalizer-bars vector, white fill, transparent bg. |
| `.../PluriWaveAlarmReceiver.kt:184` | Modified | Swap `ic_dialog_info` → `R.drawable.ic_stat_pluriwave`; add `.setColor()`. |
| `.../AlarmScheduler.kt:580` | Modified | Swap `ic_lock_idle_alarm` → new icon; add `.setColor()`. |
| `.../PluriWaveAlarmService.kt:390` | Modified | Swap `ic_lock_idle_alarm` → new icon; add `.setColor()`. |
| `lib/main.dart:17-23` | Modified | Add `androidNotificationIcon: 'drawable/ic_stat_pluriwave'` (via named const). |
| `test/tema/notification_color_test.dart` | Modified/New sibling | Assert new `androidNotificationIcon` field. |

## Risks

| Risk | Likelihood | Mitigation |
|------|------------|------------|
| Hand-authored glyph looks poor at small/low-DPI status-bar size | Med | On-device/emulator status-bar QA before ship; use bold bars, avoid thin strokes. |
| `setColor()` is advisory — OS may not fully tint | Med | Set expectation: best-effort branding, not pixel-exact across OS versions. |
| `R.drawable.ic_stat_pluriwave` not in scope in a Kotlin file | Low | All 3 files already use package-local `R`; confirm at apply (no `flutter build`). |
| No Kotlin test harness — native change unverifiable by unit test | High | Manual/on-device QA for the 3 Kotlin call sites; Dart test covers only config field. |

## Rollback Plan

Fully reversible via `git revert` of the change commit. Icon asset is a single additive file (deleting it restores prior state). Each Kotlin edit restores the original system drawable + removes `.setColor()`. The Dart edit removes one config field + its const. No migrations, no persisted state, no schema changes — nothing to undo beyond source reversion.

## Dependencies

- None external. Glyph derived from Material Design open-source icon (Apache 2.0), hand-transcribed as XML path data — no new package or asset dependency.

## Success Criteria

- [ ] `ic_stat_pluriwave.xml` exists and is a valid monochrome vector drawable.
- [ ] All 4 notification builders reference `drawable/ic_stat_pluriwave`.
- [ ] The 3 Kotlin alarm builders apply cyan `#21D4D9` via `.setColor()`.
- [ ] Dart test asserts `configuracionAudioService.androidNotificationIcon` equals the expected resource string; `flutter test` passes.
- [ ] `flutter analyze` clean; on-device QA confirms legible branded icons in status bar and shade.