hamed
de1a78a235
- 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.
4.3 KiB
4.3 KiB
معماری — تسک ۰۱: راهاندازی پروژه
ساختار پوشههای پروژه
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 شده.
موفق (بدون صفحهبندی)
{
"success": true,
"data": { "..." }
}
موفق (با صفحهبندی)
{
"success": true,
"data": [ "..." ],
"meta": {
"totalRecords": 47,
"totalPages": 5,
"currentPage": 1
}
}
خطا
{
"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
└─────────────┘