biproberkay / portalstore

.Net Core (3.1 ve üstü) Restful API Repository Pattern SOLID prensiplerine uygun Unit Test Entity Framework Core (CodeFirst)

PortalStore

.Net Core (3.1 ve üstü) Restful API Repository Pattern SOLID prensiplerine uygun Unit Test Entity Framework Core (CodeFirst)

Glad to see you here!  

portalstore's Issues

solution file location

i want this
RepositoryName

• Source Folder
  • Project folder
  • Project folder
  • Project folder
  • Project folder
• SolutionName.sln
• .git
• .vs

Önce Domain projesi açar modelleri kodlarım.

#7 (comment)
#7 (comment)

• #11

.Net Core (3.1 ve üstü) Restful Web API

System Analysis

bu analiz bir iş analisti perspektifinden yazılacak

SENARYO
PortalStore adında teknolojik ürün satan bir mağazanın dijital dönüşümünü sağlayan bir sistem dizayn edilecek.

Restful mimari kullanılarak geliştirilecek olan bu API’da; @projectmanager

• SKU (Product)
• Category
• Customer
• Order
• OrderItem
• Address

Servislerinin olmasını istiyoruz.

• Mevcutta sisteme eklenen Customer’ların mernis doğrulaması yapılarak tüzel kişi oldukları tespit edilmelidir. (TC no doğrulaması)

Mernis dogrulaması için kullanılacak SOAP service adresi aşağıdaki gibidir.
https://tckimlik.nvi.gov.tr/service/kpspublic.asmx?wsdl

**Controller Class**ının metodları ve metodların geri dönüş tipleri araştırması

  **Controller Class**ının metodları ve metodların geri dönüş tipleri araştırması

📌 The IActionResult return type is appropriate when multiple ActionResult return types are possible in an action.¹

📌return BadRequest(); is a shorthand form of return new BadRequestResult();

Originally posted by @biproberkay in #20 (comment)

Category

public class Category : CategoryCore 
{
    public string Name { get; set; }
    public Status Status { get; set; }
    public virtual ICollection<Product> Products { get; set; }
}

public class CategoryCore : BaseEntity<int>
{
    public string Name { get; set; }
    public Status Status { get; set; }
}

public enum Status 
{
    draft, root, leaf, branch
}

BaseController sınıfında hangi endpointler olmalı?

getall
getbyid
...
bir kere endpointlerin hepsine bir ad vermem gerekmiyor.

📌 rest apiye göre get post put delete HttpAttributeleri var. mümkün olduğunca bunların dışına çıkmamak gerekiyor.

bana neler genel olarak lazım olabilir?

• getbyId kesin lazım olur?
• bi şunu deneyelim:
  • EntityFramework kullanmadan controller scafold edelim.

what than... CostumResult class. the issue in agenda now

  what than... the costumresult class. the issue in agenda

Originally posted by @biproberkay in #23 (comment)

bu modelleri ikişer ikişer gruplayıp 3 sprintte tamamlayayım.

    bu modelleri ikşer ikişer gruplayıp 3 sprintte tamamlayayım. 

şimdilik..

• #15

• bi deniyim bakıyım

• tasarımım çalışıyor mu çalışmıyor mu ?

Originally posted by @biproberkay in #11 (comment)

UnitOfWork

Unit Test

Unit test
SQLite InMemory kullandım.

forgotten `git flow init`

git flow init komutunu unutup kodlamaya devam ettim. main de işlem yaptım. mainin içinde release olmayan komit olsun istemiyorum

product ve category için ilk sprint olarak apiyi ve infrastructureını yazıyım.

• #16

SOLID prensipleri

OrderItem

Mernis

reuse types in referenced assemblies ? .... 🔗 ...
WCF servis Namespace .... 🔗 ...
validate a property
validation via WCF service x

SKU(Product)

• Name
• Description
• Price
• OldPrice
• CategoryId

#13 (comment)
📌 Status de hepsinde var

• BaseEntity classına ekle

🤔 Data Annotations
for decimal(16,2) https://stackoverflow.com/a/55922177/12878692
ı also tried for string property nvarchar(50)
i think is is more native to sql

Software Design

PortalStore Projesinin Yazılım Tasarımı

Temalar

• #1
• #2
• #3
• #4
• #5

Veritabanı

• SQLite
• PostgreSQL
• MS SQL

Dizaynın Hikayesi

Yazılım geliştirilirken kullanılacak tech stack zaten belirtilmiş. belirtilmeyen şeyler optional olarak düşünülebilir. Bu bi yerde "karar verme görevi sende" demek. Ben taşınabilirlik açısından SQLite kullanırım diye düşünüyorum. Tabi bu EF Core DB Provider olarak düşünülen şey.

Veri Modeli için de şema verilmiş olduğu için önemli bir struggledan daha kurtulunmuş olunuyor.
Dolayısı ile yapılacak iş:

• Entity Modelleri kodlayıp ardından istenen
• tech stacke göre projeyi tamamlamak.

işte plan

• #10
• sonra Application projesi açar soyutlamaları yaparım.
• sonra Infrastructure açar ef core ile soyutlamaların gerçekleştirmelerini yaparım.
  • repository patterni tamamladıktan sonra
  • belki bi unitofwork açıp
  • orda otomatik sınıf türetme işini unitofworke yaptırırım.
• Bu benim program.cs dosyamı temiz tutar.
• apiyi kodlarım.
  Buralarda bir sorun çıkmaz ama şu UnitTest başlığı... bunu biraz araştırmam gerekebilir.

bi sprint atar
: modelleri yazar soyutlamları yapar ef core repolarını yazarım.

• #14
  bi sprint daha atar
  : apiyi yazar db testlerini yaparım.
  en son artık
  : istenen özel şeyleri yaparım. tc doğrulama ve unit test olaylarını.
  yani 3 sprintte projeyi bitiririm.

İki önemli konu var

Birincisi
: authentication ve authorization ile ilgili case dokümanında belirtilen bir şey yok. Bu ne demek?

"E onu zaten yapman gerekiyor"

mu demek yoksa... bilmiyorum bu konuyu basic AUTH kullanarak atlayabilirim. Bi şey derlerse da belirtmemiştiniz ben de en basitini kullandım derim.

ikincisi
: Business logic _{maybe this should be considered as a topic}

Version Control

• git-flow kullanırım.
  • mainde önce readme.md dosyasında tech-stacki belirtirim.
  • hemen git-flowla developmenta geçerim. _{bunu unuttum #8}
  • developmentta proje dosyalarını(Domain ve Application) solutiona ekler
  • base classları ve interfaceleri yazarım. generic repository ya da servisleri yazar bi komit atarım.
  • entity model classlarını yazarken feature branch açarım.

references

---

metni yazarken

proje yöneticisi şapkasını takarak; yazılım tasarımının hikayesini yazmalıyım.

Repository Pattern

veri modeli aşağıda 👇

    veri modeli aşağıda 👇

• 📌 6 entity var

  • #12
  • #13
  • #27
  • Order
  • Customer
  • Address

Sistemi kurdum. şu an yapmam gereken

• modeli kodla
• mapping işlemi
• controller türet

Originally posted by @biproberkay in #7 (comment)

Infrastructure

first thought

ORM: EntityFramework Core
DB Provider: Sqlite

Tasks

• db provider seç
• DbContexti yaz
• #26
  • Repository classının implementasyonu (gerçeklemesi)

it's relatively easy to get started with SQLite, and so many users do. 🔗...

Entity Framework Core (CodeFirst)

:question: why Controller methods called as conroller actions?

  :question: why Controller methods  called as conroller actions?

BaseController class

method
actions
endpoint

📌 All the public methods of the Controller class are called Action methods.

Originally posted by @biproberkay in #20 (comment)