erp-platform/api/README.md

# Yeni Modul Ekleme

`abp new Erp.Notification -t module --no-ui -m none --database-provider ef --version 7.2.2 --old`

# Code Format

`dotnet format --include .\modules\Erp.Notification\ --folder`

# Migrations

-   Yeni migration ekleme
    `EntityFrameworkCore projesine gir`
    `dotnet ef migrations add ""`
    `dotnet ef database update`

-   Son migrationi siler ve snapshot revert eder
    `dotnet ef migrations remove`
    `dotnet ef database update "20240822114716_ABP_822"`

-   SQL Veritabanını Entity Class oluştur.
    `dotnet ef dbcontext scaffold "Server=SERVERNAME;Database=DBNAME;User ID=USERNAME;Password=PASSWORD;TrustServerCertificate=True;" Microsoft.EntityFrameworkCore.SqlServer --context MyDbContext --output-dir Models --data-annotations --force`

# Custom Endpoints

```
Token İsteği Örnek:
POST /connect/token HTTP/1.1
Host: localhost:44344
Content-Type: application/x-www-form-urlencoded

username=system%40sozsoft.com
&password=...
&grant_type=password
&client_id=Platform_PublicApi
&scope=offline_access%20Platform
```

## Whatsapp Ayarları

-   Normal facebook üyeliği yapılır.
-   https://developers.facebook.com/ sitesinden yeni developer üyeliği oluşturulur. Developer üyeliği seçilir.
-   CreateApp butonu ile yeni uygulama oluşturulur. Uygulama adı belirlenir. 'Erp Messenger'
-   AppType olarak İşletme seçilir ve App oluşturulur.
-   Add Products kısmında WhatsApp seçilir ve Business Account oluşturulur.
-   3 noktadan (menüden) WhatsApp Manager sayfasına gidilir. Manage Templates seçilir, istenirse yeni template oluşturulur. 'hello_world'
-   WhatsApp Manager üzerinde menüden Settings -> Users -> System Users eklenir. Kullanıcı adı 'admin' ve Role ise 'Admin' seçilir.
-   Eklenen 'admin' kullanıcısında 'Assign Assets' seçilir ve full yetki verilir.
-   admin kullanıcısı üzerinden 'Generate Token' seçilir ve aşağıdaki yetkiler verilir.

```
- whatsapp_business_management'
- 'whatsapp_business_messaging'
```

-   WhatsApp -> API Setup kısmından "From" kısmında yeni telefon numarası eklenir.
-   WhatsApp -> API Setup kısmından Generate Access Token oluşturulur.

-   token: EAASM83pDJf0BO0ZCYBr3Fx4SES0ox8XiZCgP3FIteprYpwawZCkGYjpMlKk4OZCWgRNZC2Ttofgf8amMf929ZBuDcgYIOsXkPMGBNmVxm2czipzq63LmtbYfyCWsKVy0q1jtay0nRoeDuO2FKhqCfLLtNn9cSWjINVLcz26ptK8a2Oko83cZBzrNsp3cpIECnzqRfEjHdEz1U73y3ZB1MZBOhHilax7yZALf4ZA1Tmk
-   WhatsApp telefon numarasını Register etmek için aşağıdaki postman Curl gönderilir.

```
  curl --location 'https://graph.facebook.com/v21.0/521106361082067/register' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <access token>' \
  --data '{
    "messaging_product": "whatsapp",
    "pin": "238567"
  }'
```

-   Message göndermek için url : https://graph.facebook.com/v21.0/521106361082067/messages

```
{
    "messaging_product": "whatsapp",
    "to": "{+gönderilecek gsm numarası}",
    "type": "template",
    "template": {
        "name": "{message_template_name}",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Test mesajı"
                    }
                ]
            }
        ]
    }
}
```

# ABP Update
- https://abp.io/docs/latest/release-info/upgrading
- https://abp.io/docs/9.0/release-info/migration-guides/abp-9-0
- https://learn.microsoft.com/en-us/aspnet/core/migration/80-90?view=aspnetcore-9.0&tabs=visual-studio-code
- Adımlar:  
  - abp cli güncellenir dotnet tool update --global Volo.Abp.Cli
  - abp update ile sln içindeki referanslar update edilir
  - modules/ klasörü *.csproj içinde ara&düzenle ile update edilir (örn. 8.3.4 -> 9.0.2)
  - .net sürümü arttıysa Microsoft'un dotnet upgrade dokümanı takip edilir
    - Yeni dotnet sdk kurulumu yapılır (örn dotnet 9 sdk)
    - ef tools güncellenir (dotnet tool update --global dotnet-ef)
  - Dockerfile dosyalarındaki base imajlar yeni dotnet sürümüne güncellenir
  - Abp upgrade dokümanı takip edilir
  - Proje build olmuyorsa hatalar çözülür
  - Yeni migration eklenir (varsa). Migration boş çıkıyorsa kaldırılır. (Örn dotnet ef migrations add Abp902 ve dotnet ef migrations remove)
    - Migration boş değilse çalıştırılır (dotnet ef database update)