# API plan — DELETE /api/v1/provider/account   (audience: `provider` · flow: `auth`)

> مكتفٍ بذاته. ابنِ من هذا الملف عبر `docs/build/build-api.md`. لا تجمع خطوات فلو متعدّد في endpoint واحد.

## 1) Identity
- **Endpoint:** `DELETE /api/v1/provider/account`
- **Audience / platform:** `provider` — `app`
- **Flow / screen:** `auth` — Figma: Settings 2 — **screen link:** https://www.figma.com/design/pIFyEHCimnG9rIRh3TMnHC/HR?node-id=17121-1444&m=dev — **action:** حذف الحساب
- **Auth / guard:** `auth:provider`
- **Rate limit:** none
- **Ownership:** self
- **Consumer:** إعدادات أعمال

## 2) How it works — logic
- Soft delete Provider + ابطل التوكنات.

## 3) Request
- Path / query: —
- Body: —
- Files: —
- **Form Request:** `App\Http\Requests\Api\Provider\Auth\DeleteAccountRequest` (extends `BaseApiRequest`).
- [x] no client-only rules
- [x] enum via Rule::enum
- [x] unique/exists soft-delete-aware
- [x] phone country_code+PhoneNormalizer
- [x] messages in validation.php

## 4) Response
- **Success:** 200
- **UI copy:** ar `تم حذف الحساب` · en `Account deleted`
- **Shape:** flat `data` · enums `{value,label}` · token داخل Resource إن وُجد.
- **Errors:** 422 · 401 · 403 · 404

## 5) Postman
- **Folder path:** `Settings` / `account` · **Request name:** `provider-delete`
- **URL:** `{{base_url}}provider/account` · **DELETE**
- **Auth:** Bearer {{provider_token}}
- **Body:** قيم عربية واقعية (محمد العلي / 0551112233 / الرياض)
- **Examples:** ✅ success · ⚠️ 422 · ❌ 401

## 6) Build checklist
- [ ] route + thin controller + service + Form Request + Resource
- [ ] lang ar+en · tests · Postman من §5