masoodafar-web
119e870a26
- Added FINAL-STATUS.md detailing project completion and key metrics - Created QUICK-REFERENCE.md for quick access to essential documents - Updated README.md with project overview and quick start guide - Established STRUCTURE.md outlining the final documentation structure - Organized and archived old files, ensuring a clean and efficient directory - Enhanced documentation quality with comprehensive metrics and checklists
132 lines
3.7 KiB
Markdown
132 lines
3.7 KiB
Markdown
# راهنمای پیکربندی Email و SMS
|
|
|
|
## تنظیمات Email (Gmail)
|
|
|
|
### مرحله 1: ایجاد App Password در Gmail
|
|
|
|
1. به [Google Account Security](https://myaccount.google.com/security) بروید
|
|
2. گزینه "2-Step Verification" را فعال کنید
|
|
3. به بخش "App passwords" بروید
|
|
4. یک App Password جدید با نام "FourSat CMS" ایجاد کنید
|
|
5. پسورد 16 رقمی را در `appsettings.Production.json` در فیلد `SmtpPassword` قرار دهید
|
|
|
|
### مرحله 2: تنظیم appsettings.Production.json
|
|
|
|
```json
|
|
"Email": {
|
|
"Enabled": true,
|
|
"SmtpHost": "smtp.gmail.com",
|
|
"SmtpPort": 587,
|
|
"SmtpUsername": "your-email@gmail.com", // ایمیل Gmail خود
|
|
"SmtpPassword": "your-16-digit-app-password", // App Password از مرحله 1
|
|
"FromEmail": "noreply@foursat.com", // ایمیل فرستنده (میتواند همان Gmail باشد)
|
|
"FromName": "FourSat CMS",
|
|
"EnableSsl": true
|
|
}
|
|
```
|
|
|
|
### سایر سرویسهای SMTP:
|
|
|
|
#### Outlook/Microsoft 365:
|
|
```json
|
|
"SmtpHost": "smtp.office365.com",
|
|
"SmtpPort": 587
|
|
```
|
|
|
|
#### Yahoo Mail:
|
|
```json
|
|
"SmtpHost": "smtp.mail.yahoo.com",
|
|
"SmtpPort": 587
|
|
```
|
|
|
|
---
|
|
|
|
## تنظیمات SMS (کاوه نگار)
|
|
|
|
### مرحله 1: ثبتنام در کاوه نگار
|
|
|
|
1. به [Kavenegar.com](https://panel.kavenegar.com/client/membership/register) بروید
|
|
2. ثبتنام کنید و حساب خود را تأیید کنید
|
|
3. از پنل، API Key خود را کپی کنید
|
|
|
|
### مرحله 2: تنظیم appsettings.Production.json
|
|
|
|
```json
|
|
"Sms": {
|
|
"Enabled": true,
|
|
"Provider": "Kavenegar",
|
|
"KavenegarApiKey": "YOUR_KAVENEGAR_API_KEY", // API Key از پنل کاوه نگار
|
|
"Sender": "10008663" // شماره ارسالکننده (از پنل کاوه نگار)
|
|
}
|
|
```
|
|
|
|
### نکات مهم:
|
|
- شماره `Sender` باید از پنل کاوه نگار تهیه شود
|
|
- برای تست میتوانید از شمارههای رایگان استفاده کنید
|
|
- هزینه هر پیامک بسته به نوع خط متفاوت است
|
|
|
|
---
|
|
|
|
## تست کردن
|
|
|
|
### تست Email:
|
|
```bash
|
|
# در محیط Development
|
|
curl -X POST "http://localhost:5133/api/admin/trigger-weekly-calculation"
|
|
```
|
|
|
|
### تست SMS:
|
|
همان دستور بالا را اجرا کنید. سیستم به صورت خودکار:
|
|
- Email ارسال میکند (اگر User.Email پر باشد)
|
|
- SMS ارسال میکند (اگر User.Mobile پر باشد)
|
|
|
|
### بررسی Log ها:
|
|
```bash
|
|
# در ترمینال سرویس CMS
|
|
# پیامهای زیر را مشاهده کنید:
|
|
# 📧 Email sent to {Email}: {Subject}
|
|
# 📱 SMS sent to {PhoneNumber}: {MessageId}
|
|
```
|
|
|
|
---
|
|
|
|
## امنیت
|
|
|
|
### ⚠️ مهم:
|
|
1. فایل `appsettings.Production.json` را به Git اضافه نکنید
|
|
2. از Environment Variables یا Azure Key Vault استفاده کنید
|
|
3. API Key ها را هرگز در کد سورس قرار ندهید
|
|
|
|
### استفاده از Environment Variables:
|
|
|
|
```bash
|
|
# Linux/Mac
|
|
export Email__SmtpPassword="your-app-password"
|
|
export Sms__KavenegarApiKey="your-api-key"
|
|
|
|
# Windows
|
|
set Email__SmtpPassword=your-app-password
|
|
set Sms__KavenegarApiKey=your-api-key
|
|
```
|
|
|
|
---
|
|
|
|
## خطایابی (Troubleshooting)
|
|
|
|
### Email ارسال نمیشود:
|
|
1. App Password را صحیح وارد کردهاید؟
|
|
2. 2-Step Verification در Gmail فعال است؟
|
|
3. Port 587 باز است؟
|
|
4. `EnableSsl: true` تنظیم شده؟
|
|
|
|
### SMS ارسال نمیشود:
|
|
1. API Key صحیح است؟
|
|
2. اعتبار حساب کاوه نگار کافی است؟
|
|
3. شماره `Sender` معتبر است؟
|
|
4. فرمت شماره موبایل صحیح است؟ (09xxxxxxxxx)
|
|
|
|
### Log ها را بررسی کنید:
|
|
```bash
|
|
tail -f /tmp/cms_run.log
|
|
```
|