Devnot Nedir?

Güncel yazılım konularıyla ilgili yazılar yayınlayan, yazılım konferansları, buluşmalar ve kamplar düzenleyen yazılım geliştirici topluluğudur.

Devnot Mentor Projesi Nedir?

Yazılım alanında kendini geliştirmek isteyen öğrencilerin(mentilerin) kendilerinden daha tecrübeli yazılımcılar(mentorlar) bulmalarını, onlarla tanışmalarını ve düzenli görüşmeler yapmalarını sağlayacak açık kaynak kod bir topluluk projesidir.

Yazılımcı olmayı veya mesleğinde daha iyi noktalara gelmeyi hedefleyen kişileri(öğrenci) bu program kapsamında bir mentorle eşleştirerek düzenli görüşmeler yapmalarını amaçlamaktayız. Bu görüşmelerde öğrenciler mentorlerine sorular sorabilecek, çözmekte zorlandıkları konularda yardım isteyebilecek, gelişimleri için uygun kaynak önerilerini dinleyebilecekler.

Başlarken

devnot-mentor-back-end projesini çalıştırabilmek için bilgisayarınıza .NET Core yüklemelisiniz.

Projeyi klonlamak için.

$ git clone https://github.com/devnotcom/devnot-mentor-back-end.git

Development, Test ya da Production ortamında çalıştırmak için.

$  dotnet run --launch-profile Development
$  dotnet run --launch-profile Test
$  dotnet run --launch-profile Production

Publish alma işlemleri için.

$ dotnet publish

publish alma, migration gibi işlemlerde uygun profili seçmek için ENV. değerinin karşılığı Development, Test ya da Production olmalıdır.

ENV. Key: DEVNOT_MENTOR_ENVIRONMENT

Örnek bir ENV. ataması:

Powershell: $env:DEVNOT_MENTOR_ENVIRONMENT='Development'

Linux Terminal: export DEVNOT_MENTOR_ENVIRONMENT='Development'

Database Migration

Migration işlemini gerçekleştirmeden önce SQL Server'a bağlanmak için connection string bilgisini sizlerin kullandığı makinaya göre ayarlamanız gerekmektedir. Bunun için DevnotMentor.Api.Configuration namespace altındaki appsettings.development.json dosyasındaki bağlantı düzeltilmelidir.

Bu işlemden sonra Package Manager Console üzerinden aşağıdaki adımların takip edilmesi gerekmektedir.

$  $env:DEVNOT_MENTOR_ENVIRONMENT='Development'
$  add-migration MentorDB_Initialization
$  Update-Database

---

Klasör Yapısı

📁 ActionFilters - Controller altındaki ilgili action tetiklenmeden önce çalışacak işlemlerin yer aldığı klasör.

📁 Aspects - İlgili cross-cutting-concern'lerin (Transaction, Exception) yer aldığı klasör.

📁 Common - Hata mesajlarını ve servis sınıflarının geriye döndüğü durumları temsil eden sınıfların yer aldığı klasör.

📁 Configuration - Environment bilgilerinin ve bu bilgilere ait JSON dosyalarının tutulduğu klasör.

📁 Controllers - API için kullanılan Controller listesini içeren klasör.

📁 CustomEntities - DTO, Request ve Response için oluşturulan sınıfların yer aldığı klasör.

📁 Enums - Sabit değerler için oluşturulan Enum'ların bulunduğu klasör.

📁 Helpers - Extension metotlarını ve Mapper Profillerini içeren sınıfların bulunduğu klasör.

📁 images - Kullanıcılara ait profil fotoğraflarının bulunduğu klasör.

📁 Repositories - Repository sınıflarını içeren klasör.

📁 Services - Servis sınıflarının, iş kurallarının yapıldığı yerdir, bu işlemleri gerçekleştiren sınıfları içeren klasör.

📁 Utilities - Email, JWT, Hash, Interceptor, dosya yazma gibi işlemlere ait sınıfların bulunduğu klasör.

---

API Projesi Ağaç Yapısı

📦 
└─ Devnot.Mentor.Api
   ├─ ActionFilters
   │  ├─ TokenAuthentication.cs
   │  └─ ValidateModelStateAttribute.cs
   ├─ Aspects
   │  └─ Autofac
   │     ├─ Exception
   │     │  └─ ExceptionHandlingAspect.cs
   │     └─ UnitOfWork
   │        └─ DevnotUnitOfWorkAspect.cs
   ├─ Common
   │  ├─ Response
   │  │  ├─ ApiResponse.cs
   │  │  ├─ ErrorApiResponse.cs
   │  │  └─ SuccessApiResponse.cs
   │  └─ ResultMessage.cs
   ├─ Configuration
   │  ├─ Context
   │  │  ├─ DevnotConfigurationContext.cs
   │  │  └─ IDevnotConfigurationContext.cs
   │  ├─ Environment
   │  │  ├─ EnvironmentService.cs
   │  │  └─ IEnvironmentService.cs
   │  ├─ appsettings.development.json
   │  ├─ appsettings.production.json
   │  └─ appsettings.test.json
   ├─ Controllers
   │  ├─ BaseController.cs
   │  ├─ MenteeController.cs
   │  ├─ MentorController.cs
   │  └─ UserController.cs
   ├─ CustomEntities
   │  ├─ Dto
   │  │  ├─ MenteeDto.cs
   │  │  ├─ MentorDto.cs
   │  │  └─ UserDto.cs
   │  ├─ Request
   │  │  ├─ MenteeRequest
   │  │  │  ├─ ApplyToMentorRequest.cs
   │  │  │  └─ CreateMenteeProfileRequest.cs
   │  │  ├─ MentorRequest
   │  │  │  └─ CreateMentorProfileRequest.cs
   │  │  └─ UserRequest
   │  │     ├─ CompleteRemindPasswordRequest.cs
   │  │     ├─ RegisterUserRequest.cs
   │  │     ├─ UpdatePasswordRequest.cs
   │  │     ├─ UpdateUserRequest.cs
   │  │     └─ UserLoginRequest.cs
   │  └─ Response
   │     └─ UserResponse
   │        └─ UserLoginResponse.cs
   ├─ DevnotMentor.Api.csproj
   ├─ Entities
   │  ├─ LinkType.cs
   │  ├─ Log.cs
   │  ├─ Mentee.cs
   │  ├─ MenteeAnswers.cs
   │  ├─ MenteeLinks.cs
   │  ├─ MenteeTags.cs
   │  ├─ Mentor.cs
   │  ├─ MentorApplications.cs
   │  ├─ MentorDBContext.cs
   │  ├─ MentorLinks.cs
   │  ├─ MentorMenteePairs.cs
   │  ├─ MentorQuestions.cs
   │  ├─ MentorTags.cs
   │  ├─ QuestionType.cs
   │  ├─ Tag.cs
   │  └─ User.cs
   ├─ Enums
   │  ├─ MentorApplicationStatus.cs
   │  └─ MentorMenteePairStatus.cs
   ├─ Helpers
   │  ├─ Extensions
   │  │  ├─ ClaimsExtensions.cs
   │  │  ├─ EnumExtensions.cs
   │  │  ├─ ObjectExtensions.cs
   │  │  └─ SwaggerExtensions.cs
   │  └─ MappingProfile.cs
   ├─ Program.cs
   ├─ Properties
   │  └─ launchSettings.json
   ├─ Repositories
   │  ├─ BaseRepository.cs
   │  ├─ Interfaces
   │  │  ├─ ILoggerRepository.cs
   │  │  ├─ IMenteeLinksRepository.cs
   │  │  ├─ IMenteeRepository.cs
   │  │  ├─ IMenteeTagsRepository.cs
   │  │  ├─ IMentorApplicationsRepository.cs
   │  │  ├─ IMentorLinksRepository.cs
   │  │  ├─ IMentorMenteePairsRepository.cs
   │  │  ├─ IMentorRepository.cs
   │  │  ├─ IMentorTagsRepository.cs
   │  │  ├─ IRepository.cs
   │  │  ├─ ITagRepository.cs
   │  │  └─ IUserRepository.cs
   │  ├─ LoggerRepository.cs
   │  ├─ MenteeLinksRepository.cs
   │  ├─ MenteeRepository.cs
   │  ├─ MenteeTagsRepository.cs
   │  ├─ MentorApplicationsRepository.cs
   │  ├─ MentorLinksRepository.cs
   │  ├─ MentorMenteePairsRepository.cs
   │  ├─ MentorRepository.cs
   │  ├─ MentorTagsRepository.cs
   │  ├─ TagRepository.cs
   │  └─ UserRepository.cs
   ├─ Services
   │  ├─ BaseService.cs
   │  ├─ Interfaces
   │  │  ├─ IMenteeService.cs
   │  │  ├─ IMentorService.cs
   │  │  └─ IUserService.cs
   │  ├─ MenteeService.cs
   │  ├─ MentorService.cs
   │  └─ UserService.cs
   ├─ Startup.cs
   ├─ Utilities
   │  ├─ Email
   │  │  ├─ IMailService.cs
   │  │  └─ SmtpMail
   │  │     └─ SmtpMailService.cs
   │  ├─ File
   │  │  ├─ FileResult.cs
   │  │  ├─ IFileService.cs
   │  │  └─ Local
   │  │     └─ LocalFileService.cs
   │  ├─ Interceptor
   │  │  ├─ AspectInterceptorSelector.cs
   │  │  ├─ Autofac
   │  │  │  ├─ Interception.cs
   │  │  │  └─ InterceptionBaseAttribute.cs
   │  │  └─ AutofacInterceptorModule.cs
   │  └─ Security
   │     ├─ Hash
   │     │  ├─ IHashService.cs
   │     │  └─ Sha256
   │     │     └─ Sha256HashService.cs
   │     └─ Token
   │        ├─ ITokenService.cs
   │        ├─ Jwt
   │        │  └─ JwtTokenService.cs
   │        ├─ ResolveTokenResult.cs
   │        └─ TokenInfo.cs
   ├─ appsettings.Development.json
   ├─ appsettings.json
   ├─ images
   │  └─ profile-images
   └─ web.config