feat: Implement SMS sending functionality with KavehNegar and Rangineh providers

- Add SendSmsMessage class for encapsulating SMS message data. - Create KavehNegarProvider and RanginehProvider classes implementing SmsProviderInterface for sending SMS. - Implement SmsLogRepository and SmsTemplateRepository for managing SMS logs and templates. - Develop SendSmsHandler for handling SMS sending messages. - Create SmsService to manage SMS dispatching and logging. - Add UserProfileController for managing user profiles with CRUD operations. - Implement UserProfile entity and repository for user profile data management. - Update symfony.lock and bootstrap.php for project dependencies and environment setup.
2026-06-09 22:00:34 +03:30
commit de1a78a235
222 changed files with 36388 additions and 0 deletions
@@ -0,0 +1,149 @@
+# معماری — تسک ۰۱: راه‌اندازی پروژه
+
+## ساختار پوشه‌های پروژه
+```
+clinic-pro-symfony/
+├── .ddev/
+│   ├── config.yaml
+│   └── docker-compose.redis.yaml
+├── config/
+│   ├── packages/
+│   │   ├── doctrine.yaml
+│   │   ├── lexik_jwt_authentication.yaml
+│   │   ├── nelmio_cors.yaml
+│   │   ├── framework.yaml
+│   │   ├── cache.yaml
+│   │   └── security.yaml
+│   ├── routes/
+│   │   └── api.yaml
+│   └── services.yaml
+├── src/
+│   ├── Module/
+│   │   ├── Auth/
+│   │   ├── UserProfile/
+│   │   ├── Blog/
+│   │   ├── Doctor/
+│   │   ├── Clinic/
+│   │   ├── Agent/
+│   │   ├── Category/
+│   │   ├── AppointmentSettings/
+│   │   ├── Appointment/
+│   │   ├── Insurance/
+│   │   ├── Rating/
+│   │   ├── Comment/
+│   │   ├── Like/
+│   │   ├── Secretary/
+│   │   ├── Payment/
+│   │   └── Representation/
+│   └── Shared/
+│       ├── Response/
+│       │   └── ApiResponse.php
+│       ├── Exception/
+│       │   ├── ValidationException.php
+│       │   └── NotFoundException.php
+│       ├── Trait/
+│       │   └── TimestampableTrait.php
+│       └── EventSubscriber/
+│           └── ExceptionSubscriber.php
+├── migrations/
+├── tests/
+├── public/
+│   └── index.php
+└── .env
+```
+
+## ساختار داخلی هر ماژول
+```
+src/Module/{ModuleName}/
+├── Controller/
+│   └── {Name}Controller.php      ← دریافت request، فراخوانی service، بازگشت response
+├── Service/
+│   └── {Name}Service.php         ← منطق تجاری
+├── Repository/
+│   └── {Name}Repository.php      ← کوئری‌های پایگاه داده
+├── Entity/
+│   └── {Name}.php                ← Doctrine ORM mapping
+├── DTO/
+│   ├── Request/
+│   │   └── Create{Name}Request.php   ← validation ورودی
+│   └── Response/
+│       └── {Name}Response.php        ← شکل‌دهی خروجی JSON
+└── Voter/
+    └── {Name}Voter.php           ← بررسی مجوزها
+```
+
+## مسئولیت هر لایه
+
+| لایه | مسئولیت |
+|------|---------|
+| Controller | دریافت HTTP، اعتبارسنجی DTO، فراخوانی Service، بازگشت ApiResponse |
+| Service | منطق تجاری، فراخوانی Repository، dispatch Event |
+| Repository | تمام کوئری‌های Doctrine، بدون منطق تجاری |
+| Entity | تعریف ساختار جداول با ORM Attribute |
+| DTO | اعتبارسنجی ورودی و شکل‌دهی خروجی |
+| Voter | بررسی اینکه چه کسی به چه چیزی دسترسی دارد |
+
+## فرمت استاندارد پاسخ (ApiResponse)
+
+> **⚠ فرمت رسمی از task.md است — این فایل با آن sync شده.**
+
+### موفق (بدون صفحه‌بندی)
+```json
+{
+  "success": true,
+  "data": { "..." }
+}
+```
+
+### موفق (با صفحه‌بندی)
+```json
+{
+  "success": true,
+  "data": [ "..." ],
+  "meta": {
+    "totalRecords": 47,
+    "totalPages": 5,
+    "currentPage": 1
+  }
+}
+```
+
+### خطا
+```json
+{
+  "success": false,
+  "data": null,
+  "errors": [
+    {
+      "code": "ERR_VALIDATION_001",
+      "field": "mobile_number",
+      "message": "فرمت شماره موبایل نادرست است"
+    }
+  ]
+}
+```
+
+## نمودار ارتباط لایه‌ها
+```
+HTTP Request
+     │
+     ▼
+┌─────────────┐
+│ Controller  │  ← Route, DTO bind, Validate
+└──────┬──────┘
+       │
+       ▼
+┌─────────────┐
+│   Service   │  ← Business logic, Events
+└──────┬──────┘
+       │
+       ▼
+┌─────────────┐
+│ Repository  │  ← Doctrine queries
+└──────┬──────┘
+       │
+       ▼
+┌─────────────┐
+│   Entity    │  ← Database row
+└─────────────┘
+```