Karşılaşılan zorluk
Bulunması zor, dağınık belgeler; iş sahibi, müteahhit ve mühendislik ofisi arasında sınırlı koordinasyon ve kaynak israfına yol açan çakışan işler.
Geliştirdiklerimiz
İş akışındaki parçalı belgelendirmeyi ele alarak, işleri düzenlemek ve üç tarafın faaliyetlerini koordine etmek için bir sistem geliştirdik.
Uygulama kapsamı
- İş sahibi, müteahhit ve mühendislik ofisi arasındaki çalışmayı koordine etmek.
- Belgeleri iş akışı içinde düzenleme ve takiplerini kolaylaştırma.
- İş alanı mantığının, uygulama katmanının ve altyapının ayrılması.
Teknik mimari
Sistem; backend hizmetleri ve API’ler için C# ve .NET 10, web arayüzü ve backend-for-frontend (BFF) katmanı için TypeScript, Next.js ve React 19, veri yönetimi için PostgreSQL ve veri erişimi için EF Core kullanılarak geliştirildi.
Mimari etki alanı mantığını, uygulama katmanını ve altyapıyı ayırır. Ayrıca otomasyon, güvenlik ve operasyonel kontroller için veritabanı satır düzeyinde erişim ilkelerini ve Python ve Bash komut dosyalarını kullanır.
- Web arayüzü ve BFFNext.js · React 19 · TypeScript
- Sistem hizmetleri ve API’lerC# · .NET 10
- Veri erişimiEF Core
- Veritabanı ve satır düzeyinde erişim politikalarıPostgreSQL
Uygulama katmanları ve teknolojiler
| Katman | Teknolojiler |
|---|---|
| Backend hizmetleri ve API’ler | C# · .NET 10 · EF Core |
| Web arayüzü ve BFF | TypeScript · Next.js · React 19 · TSX |
| Veri | PostgreSQL · SQL |
| Arayüz yapısı ve biçimlendirmesi | HTML · CSS · CSS Modules |
| İşletim ve güvenlik betikleri | JavaScript / MJS · Python · Bash / Shell |
| Derleme ve dağıtım yapılandırması | GitHub Actions · YAML · JSON |
Uygulamaya ilişkin bir karar
Mimari, etki alanı mantığını uygulama katmanından ve altyapıdan ayırır. Bu, arayüzden verilere doğru bir değişikliğin izini sürerken her sorumluluğu açıkça ortaya koyarken BFF, web arayüzünün ihtiyaçlarını sistem hizmetlerine bağlar.
Sonuç ve deneyim
Sistem koordinasyonu iyileştirmeye yardımcı oldu, belgelerin takibini kolaylaştırdı ve kaynakların boşa harcanmasına yol açan iş çakışmalarını giderdi.