{"id":19260265,"url":"https://github.com/eser/karma-points","last_synced_at":"2025-08-20T06:14:45.345Z","repository":{"id":260900585,"uuid":"835657867","full_name":"eser/karma-points","owner":"eser","description":null,"archived":false,"fork":false,"pushed_at":"2024-11-03T12:54:28.000Z","size":3970,"stargazers_count":8,"open_issues_count":44,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-08T20:59:12.608Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eser.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-30T09:22:03.000Z","updated_at":"2025-02-03T05:47:39.000Z","dependencies_parsed_at":"2024-11-03T13:40:55.012Z","dependency_job_id":null,"html_url":"https://github.com/eser/karma-points","commit_stats":null,"previous_names":["eser/karma-points"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/eser/karma-points","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eser%2Fkarma-points","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eser%2Fkarma-points/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eser%2Fkarma-points/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eser%2Fkarma-points/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eser","download_url":"https://codeload.github.com/eser/karma-points/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eser%2Fkarma-points/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266753979,"owners_count":23979145,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T19:19:36.187Z","updated_at":"2025-07-23T21:39:09.127Z","avatar_url":"https://github.com/eser.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Karma Points Developer Document\n\n\u003cp align=\"center\"\u003e\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://discord.com/invite/ckS4huSvEk\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/Join%20us%20on%20Discord-7289DA?style=for-the-badge\u0026logo=discord\u0026logoColor=white\" alt=\"Join us on Discord\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://x.com/eserozvataf\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/@eserozvataf-000000?style=for-the-badge\u0026logo=x\u0026logoColor=white\" alt=\"X Logo\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://x.com/sameterkanboz\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/@sameterkanboz-000000?style=for-the-badge\u0026logo=x\u0026logoColor=white\" alt=\"X Logo\" /\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n---\n\n- [Karma Points Developer Document](#karma-points-developer-document)\n  - [Beginner's Guide](#beginners-guide)\n    - [Introduction](#introduction)\n    - [Installation Instructions](#installation-instructions)\n    - [Getting Started](#getting-started)\n  - [Features and Usage](#features-and-usage)\n    - [Key Features](#key-features)\n    - [step-by-step usage](#step-by-step-usage)\n    - [Commands and Params](#commands-and-params)\n  - [Contribution Guide](#contribution-guide)\n    - [Contribution Process](#contribution-process)\n    - [Coding Standards](#coding-standards)\n    - [Tests and Verifications](#tests-and-verifications)\n  - [FAQ](#faq)\n    - [Common Questions and Issues](#common-questions-and-issues)\n    - [Troubleshooting](#troubleshooting)\n    - [License](#license)\n\n## Beginner's Guide\n\n### Introduction\n\n- **Projenin Amacı ve Genel Tanıtımı:**\n  Karma Points, kişilerin birbirlerine yaptıkları takdirleri iletebilmeleri ve bu takdirler üzerinden rozetler kazanabilecekleri bir ödüllendirme sistemidir. Uygulama, kullanıcıların olumlu davranışlarını teşvik eder ve topluluk içinde pozitif bir atmosfer yaratır. Takdirler, belirli etkinlikler ve başarılar üzerine verilebilir ve bu sayede kullanıcılar, toplulukları içinde tanınma ve motivasyon kazanırlar.\n\n- **Projenin Hedef Kitlesi ve Çözdüğü Problemler:**\n  Karma-Points, özellikle kurumsal şirketler, eğitim kurumları ve büyük topluluklar için tasarlanmıştır. Hedef kitlesi, takım çalışmasını teşvik etmek, çalışan veya öğrenci motivasyonunu artırmak isteyen organizasyonlardır. Uygulama, kişisel çabaların fark edilmemesi, düşük motivasyon ve takım içi iletişim sorunları gibi problemleri çözmeyi amaçlar. Karma-Points, kullanıcıların birbirlerine verdikleri takdirler ile daha güçlü bir bağ kurmalarına ve daha verimli çalışmalara olanak tanır.\n\n### Installation Instructions\n\n- **Gerekli Ön Koşullar:**\n\n  - [Git](https://git-scm.com/) v2.46+\n  - [Node.js](https://nodejs.org/) v22.0+\n  - [pre-commit](https://pre-commit.com/) v3.6+\n\n- **Clone Aşamaları:**\n\n  ```bash\n  git clone https://github.com/eser/karma-points.git\n  cd karma-points\n  ```\n\n- **Clone aşamaları:**\n\n  ```bash\n  corepack up\n  node --run dev\n  ```\n\n### Getting Started\n\nörnek yapılandırma .env dosyaları\n\n```bash\nDB_HOST=localhost\nDB_USER=root\nDB_PASS=password\n```\n\n## Features and Usage\n\n### Key Features\n\n- Kullanıcıların birbirlerine takdir gönderebilmesi.\n- Rozet yönetimi.\n- Etkinlik tabanlı ödüllendirme sistemi.\n\n### step-by-step usage\n\nnasıl kullanılacağına dair detaylı açıklamalar ve usa cases\n\n### Commands and Params\n\neğer cli ise komut ve parametre açıklamaları\n\n## Contribution Guide\n\n### Contribution Process\n\nKatkıda bulunmak isteyenler için adım adım talimatlar:\n\n1. **Proje Fork'lama:**\n\n   - GitHub hesabınıza giriş yapın.\n   - Karma-Points projesinin GitHub sayfasına gidin.\n   - Sağ üst köşedeki \"Fork\" butonuna tıklayarak projeyi kendi hesabınıza fork'layın.\n\n2. **Bilgisayarınızda Çalışma Ortamı Oluşturma:**\n\n   - Forkladığınız projeyi `git` aracıyla kendi bilgisayarınıza indirin.\n\n     ```bash\n     git clone git@github.com:kullanici/karma-points.git\n     cd karma-points\n     ```\n\n   - Proje içerisinde [pre-commit](https://pre-commit.com/)'i aktif hale getirin.\n\n     ```bash\n     pre-commit install\n     ```\n\n3. **Yeni Bir Branch Oluşturma:**\n\n   - Yeni bir branch oluşturun ve bu branch'e geçin:\n\n     ```bash\n     git checkout -B feat/yeni-ozellik\n     ```\n\n4. **Değişiklikleri Yapma:**\n\n   - Kendi branch'inizde gerekli değişiklikleri yapın.\n\n   - Değişikliklerinizi commit edin:\n\n     ```bash\n     git add -A\n     git commit -m 'feat: Yeni özellik eklendi.'\n     ```\n\n5. **Branch'i Push'lama:**\n\n   - Değişikliklerinizi uzak depoya gönderin:\n\n     ```bash\n     git push -u origin feat/yeni-ozellik\n     ```\n\n6. **Pull Request Açma:**\n   - GitHub sayfanıza gidin ve fork'ladığınız repository'yi açın.\n   - \"New Pull Request\" butonuna tıklayarak yeni bir pull request oluşturun.\n   - Yapılan değişikliklerin detaylarını açıklayan bir açıklama yazın ve pull request'i gönderin.\n\n### Coding Standards\n\nProje için geçerli olan kodlama standartları ve en iyi uygulamalar:\n\n- **Kodlama Stili:**\n\n  - Kod yazarken anlaşılır ve tutarlı bir stil kullanın.\n  - Kodunuzun okunabilir olmasına dikkat edin ve açıklayıcı yorumlar ekleyin.\n  - Değişken ve fonksiyon isimlendirmelerinde anlamlı ve açıklayıcı isimler kullanın.\n\n- **Linting ve Formatlama:**\n\n  - Projede kullanılan linter araçlarını kullanarak kodunuzu kontrol edin.\n  - Kod formatlama kurallarına uyun ve gerekli formatlama araçlarını kullanarak kodunuzu formatlayın.\n\n- **Fonksiyon ve Modül Tasarımı:**\n  - Fonksiyonlarınızı ve modüllerinizi küçük, anlaşılır ve tek bir iş yapacak şekilde tasarlayın.\n  - Kod tekrarından kaçının ve yeniden kullanılabilir kod yazmaya özen gösterin.\n\n### Tests and Verifications\n\nTestlerin nasıl yazılacağı ve doğrulama süreçleri:\n\n- **Test Yazma:**\n\n  - Proje için belirlenen test çerçevesini kullanarak testlerinizi yazın (örneğin, Jest, Mocha).\n  - Birim testleri ve entegrasyon testleri yazarak kodunuzun doğruluğunu kontrol edin.\n  - Test kapsamını artırmak için her yeni özellik veya değişiklik için test yazmayı ihmal etmeyin.\n\n- **Test Çalıştırma:**\n\n  - Testleri çalıştırmak için proje kök dizininde aşağıdaki komutu kullanın:\n\n    ```bash\n    node --test\n    ```\n\n- **Doğrulama ve İnceleme:**\n  - Değişikliklerinizi göndermeden önce tüm testlerin geçtiğinden emin olun.\n  - Kodunuzun gözden geçirilmesi için pull request açın ve diğer geliştiricilerin incelemesine sunun.\n  - Gözden geçirme sırasında yapılan geri bildirimleri dikkate alarak gerekli düzeltmeleri yapın.\n\n## FAQ\n\n### Common Questions and Issues\n\n- Sıkça sorulan sorular ve genel sorunlar.\n\n### Troubleshooting\n\n- Hata ayıklama ve sorun giderme ipuçları.\n\n### License\n\n- Apache 2.0, [LICENSE](LICENSE) dosyasına göz gezdirebilirsiniz.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feser%2Fkarma-points","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feser%2Fkarma-points","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feser%2Fkarma-points/lists"}