56 lines
1.3 KiB
Markdown
56 lines
1.3 KiB
Markdown
# 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.
|