AYA Web Sitesi

(For English please click here)

Açık kaynak yazılımı ve açık kaynak verilerine ortak ilgi duyan bireylerden oluşan sıkı bağlı ve tutkulu bir topluluğuz. Toplumun iyileştirilmesi için teknolojiden yararlanma kararlılığımızla birleşerek, Türkiye'de meydana gelen yıkıcı Şubat 2023 depremi sonrasında güçlerimizi birleştirdik.

Depremin ardından, etkilenenlere destek olma ve aileleri ile sevdiklerini yeniden bir araya getirme sürecine yardım etme acil ihtiyacını fark ettik. Bu amaç doğrultusunda, bireyler arasındaki arama ve bağlantıyı kolaylaştırmayı hedefleyen yenilikçi araçlar ve çözümler geliştirmek için yola çıktık.

Yorulmak bilmeyen iş birliği ve kolektif çabalar sayesinde topluluğumuz ilham verici bir büyüklüğe ulaştı ve 24.000 kişiden oluşan bir topluluk haline geldik. Birlikte, aileleri yeniden bir araya getirmeye, umudu geri kazandırmaya ve depremden etkilenenlere teselli sunmaya yardımcı olmak için teknolojinin gücünden yararlanarak araçlarımızı sürekli olarak geliştiriyoruz ve genişletiyoruz.

İlerlemeye devam ederken, taahhüdümüzden sapmadan devam ediyoruz. Araçlarımızı geliştirmeye, açık kaynak projelere aktif olarak katkıda bulunmaya ve bilgi paylaşımı ve iş birliğinin geliştiği destekleyici bir ortamı teşvik etmeye çalışıyoruz. Açık kaynak topluluğunun bir parçası olmaktan gurur duyuyoruz ve sizlerle olan yolculuğumuza dört gözle devam etmek için sabırsızlanıyoruz.

Görevimiz

Açık kaynak çözümlerini kullanarak, bilgi sistemlerini uygulayarak ve mühendislik uygulamalarını hayata geçirerek, içinde yaşadığımız toplumun iyileştirilmesine aktif olarak katkıda bulunmayı hedefliyoruz. Öncelikli odak noktamız, sosyal sorumluluk ihtiyaçlarını karşılamak ve bu yollarla çeşitli toplumsal zorluklarla baş etmektir. Uzmanlığımızı ve kaynaklarımızı kullanarak, topluluğumuz içinde pozitif bir etki yaratmayı ve sürdürülebilir kalkınmayı teşvik etmeyi amaçlıyoruz.

Teknoloji

Bu bir Docker Compose tabanlı monorepo projesidir. Aşağıdaki bileşenleri içerir:

• Frontend (webclient): Next.js ve Shadcn UI kullanır
• Backend (services): Go dilinde yazılmış REST API servisleri
• Veritabanı: PostgreSQL

Önceden kurulu olması gerekenler:

• Docker (Orbstack önerilir)
• Make (Unix/macOS sistemlerde genellikle yüklüdür)
• Git

Kurulum ve Başlangıç

GitHub repository'sini klonlayın:

$ git clone git@github.com:eser/aya.is.git
$ cd aya.is

Projeyi başlatmak için Make komutlarını kullanın:

# Tüm servisleri build et ve başlat
$ make up

Diğer kullanışlı Make komutları:

$ make help      # Tüm komutları göster
$ make logs      # Container loglarını göster
$ make stop      # Servisleri durdur
$ make restart   # Servisleri yeniden başlat
$ make down      # Containerları tamamen kaldır

Proje Yönetimi ve CLI

Servis container'ına bağlanmak için:

$ make cli

Bu komut sizi backend servisinin bash shell'ine bağlar. Buradan veritabanı yönetimi ve diğer işlemleri yapabilirsiniz.

Örnek

Profil getirme:

await backend.getProfile("tr", "eser");

Veri Modeli

Proje aşağıdaki ana veri yapılarını kullanır:

• Profile: Kullanıcı profilleri (bireyler, organizasyonlar, topluluklar)
• Story: İçerik ve yazılar (blog yazıları, haberler, etkinlikler)
• User: Sistem kullanıcıları ve kimlik doğrulama bilgileri

Nasıl Katkıda Bulunabilirsin?

Herkesten katkı bekliyoruz. Başlamak için lütfen katkıda bulunma kılavuzumuzu okuyun. Yardım etmek isterseniz issue'lara göz atabilirsiniz. Herhangi bir sorunuz varsa Discord sunucumuza katılmaktan çekinmeyin. Herhangi bir noktada takılırsanız, GitHub Issues veya Discord üzerinden yardım istemekten çekinmeyin.

Lisans

Apache 2.0, detaylar için LICENSE dosyasını inceleyebilirsiniz.