chore: phase 1 nativephp foundation setup

phase-1-foundation.md

@@ -0,0 +1,55 @@
+# Phase 1 Foundation Notes
+
+## Scaffold status
+
+- App path: `app/`
+- Framework: Laravel 12
+- Native package: `nativephp/desktop` installed
+- Native scaffolding generated:
+  - `app/config/nativephp.php`
+  - `app/app/Providers/NativeAppServiceProvider.php`
+
+## Local run commands
+
+From `app/`:
+
+- Web/Laravel dev:
+  - `composer run dev`
+- Native desktop dev:
+  - `composer run native:dev`
+
+## Environment strategy (initial)
+
+Use `app/.env` for local only, and keep production secrets out of git.
+
+Planned env groups:
+
+1. App base
+- `APP_NAME`, `APP_ENV`, `APP_DEBUG`, `APP_URL`
+
+2. API compatibility
+- `API_BASE_PATH=/v1`
+- `API_RATE_LIMIT_PER_MINUTE`
+
+3. Licensing
+- `LICENSE_PROVIDER`
+- `LICENSE_VERIFY_ENDPOINT`
+- `LICENSE_VERIFY_SECRET`
+
+4. NativePHP metadata
+- `NATIVEPHP_APP_ID`
+- `NATIVEPHP_APP_VERSION`
+- `NATIVEPHP_APP_AUTHOR`
+
+## Canonical data source decision
+
+Start migration from:
+- `../dewemoji-api/data/emojis.json`
+
+Rationale:
+- Most complete enriched dataset currently available.
+- Already includes fields extension needs (`supports_skin_tone`, categories, subcategories, etc.).
+
+## Known local prerequisite note
+
+- Current machine Node is `v20.19.3`; it is enough for current scaffold, but we may upgrade to Node 22 later for stricter parity with newer NativePHP docs.