# mail-app-identity — Recipe Book (placeholder)

**Module ID:** `mail-app-identity`
**Namespace:** `FreshCloud\Mail\Identity\`
**Lifecycle phase:** formation → planning → building (in progress)
**Status:** Module shell created 2026-07-22. Code moved from avidtech6/freshmail-2/src/Identity/.

**Description:** App-layer identity provider. Looks up users by credentials, returns user_id

---

## What this module is

- PHP app module, MIT-licensed
- PSR-4 autoloaded as `FreshCloud\Mail\Identity\`
- Code lives in `src/Identity/`
- Tests in `tests/Identity/` (PHPUnit)
- Consumed by Oscar via `oscar-platform/api/email/` bridge
- The bridge's `_bootstrap.php` wires the Composer that uses this module

## See also

- `module.json` — identity
- `module-meta.json` — metadata
- `composer.json` — autoload
- `oscar-platform/bundles/freshcloud-mail/bundle-manifest.json` — bundle