docs: apply surgical corrections for correctness and clarity
Analysis doc improvements: - Add accuracy note for Capacitor vs Cordova runtime naming - Declare 5 required Status Matrix fields verbatim in Bridge Surface - Add Manifest Hygiene checklist to Build Configuration section Implementation plan improvements: - Fix BOOT_COMPLETED permission wiring (top-level permissions, not receiver attribute) - Add user-visible Exact-Alarm Decision Rule for QA/ops reasoning - Add 2 ops-grade error cases: E_CHANNEL_MISSING, E_BAD_CONFIG - Add Preflight Golden Path (Demo) to Runbooks for 30-second sanity checks - Clamp text lengths at JS boundary with unknown field rejection - Declare minimal Event IDs for deterministic grep operations All changes maintain existing structure with surgical precision edits.
This commit is contained in:
@@ -184,6 +184,8 @@ assets/public/
|
||||
├── index.html # Main test interface (549 lines)
|
||||
├── capacitor.js # Capacitor runtime
|
||||
├── capacitor_plugins.js # Plugin JavaScript bridge
|
||||
|
||||
> **Note:** On pure Capacitor builds, the runtime is `capacitor.js`. Only include `cordova.js/cordova_plugins.js` if Cordova-compat is enabled; otherwise remove those references for accuracy.
|
||||
└── plugins/ # Plugin JavaScript files
|
||||
```
|
||||
|
||||
@@ -363,6 +365,14 @@ android {
|
||||
**Purpose**: Auto-generated Capacitor configuration
|
||||
**Note**: Regenerated on each `npx cap sync` - should not be manually edited
|
||||
|
||||
**Manifest Hygiene (Quick Scan)**
|
||||
- [ ] `<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>`
|
||||
- [ ] `<uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM"/>` (if you truly need exact)
|
||||
- [ ] `<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>`
|
||||
- [ ] BootReceiver: `exported="true"` + BOOT_COMPLETED filter
|
||||
- [ ] Other receivers exported=false unless needed
|
||||
- [ ] No stray `android:permission=` on BootReceiver
|
||||
|
||||
## Runtime Behavior
|
||||
|
||||
### App Startup Sequence
|
||||
@@ -533,6 +543,8 @@ This architecture serves as both a practical testing tool and a reference implem
|
||||
- `requestNotificationPermissions() -> {granted: boolean, permissions: {...}}`
|
||||
- `getNotificationStatus() -> {isEnabled, isScheduled, nextNotificationTime, ...}`
|
||||
|
||||
**Status Matrix MUST include:** `postNotificationsGranted`, `exactAlarmGranted`, `channelEnabled`, `batteryOptimizationsIgnored`, `canScheduleNow`.
|
||||
|
||||
## Permission & Settings Truth Table
|
||||
|
||||
| Symptom | Likely Cause | Action |
|
||||
|
||||
Reference in New Issue
Block a user