{"id":25268211,"url":"https://github.com/mcyldz/gallerist","last_synced_at":"2026-04-09T18:56:23.442Z","repository":{"id":276853172,"uuid":"929790105","full_name":"mcyldz/gallerist","owner":"mcyldz","description":"Gallerist is a car dealership management system built with Java and Spring Boot. It supports vehicle sales in both TL and USD, dynamically fetching real-time exchange rates from the Central Bank of Turkey (TCMB) API. The project utilizes PostgreSQL for data storage.","archived":false,"fork":false,"pushed_at":"2025-03-14T18:07:37.000Z","size":75,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-06T04:19:28.115Z","etag":null,"topics":["car-dealership","hibernate","java","java-17","maven","postgresql","rest-api","spring","spring-boot","spring-data","spring-mvc","spring-security"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mcyldz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-09T12:12:19.000Z","updated_at":"2025-03-14T18:07:40.000Z","dependencies_parsed_at":"2025-03-11T12:21:35.499Z","dependency_job_id":"35899b58-6678-48ae-8650-06e4918bbb09","html_url":"https://github.com/mcyldz/gallerist","commit_stats":null,"previous_names":["mcyldz/gallerist"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mcyldz/gallerist","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcyldz%2Fgallerist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcyldz%2Fgallerist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcyldz%2Fgallerist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcyldz%2Fgallerist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mcyldz","download_url":"https://codeload.github.com/mcyldz/gallerist/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcyldz%2Fgallerist/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274095023,"owners_count":25221430,"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-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["car-dealership","hibernate","java","java-17","maven","postgresql","rest-api","spring","spring-boot","spring-data","spring-mvc","spring-security"],"created_at":"2025-02-12T10:24:18.844Z","updated_at":"2026-04-09T18:56:18.422Z","avatar_url":"https://github.com/mcyldz.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Car Sales Management\nGallerist is a car dealership management system built with Java and Spring Boot. It enables vehicle sales in both Turkish Lira (TL) and US Dollars (USD) by dynamically fetching real-time exchange rates from the Central Bank of Turkey (TCMB) API. The system ensures data integrity and security using PostgreSQL, Spring Security, and JWT Authentication. Exception management is implemented for error handling and a seamless user experience.\n\n## 💻 Technologies\n\n- **Backend:**\n  - Java 17\n  - Spring Boot 3.x\n  - Spring Data JPA\n  - Spring Web\n  - Spring Security\n  \n- **Database:**\n  - PostgreSQL\n\n- **Security:**\n  - JWT (JSON Web Token) Authentication\n  \n- **Integrations:**\n  - TCMB API (Live currency exchange rates)\n  \n- **Testing:**\n  - JUnit 5\n  - Mockito\n  \n- **Documentation:**\n  - Swagger/OpenAPI\n\n## ⚡Features\n\n- Vehicle sales management in both TL and USD  \n- Real-time currency conversion using TCMB API  \n- Secure authentication and authorization with JWT  \n- Exception management for error handling  \n- RESTful API endpoints for easy integration  \n- Scalable and maintainable architecture\n\n## 📌 Project Scope  \nThis project is designed purely as a backend system. It does not include a frontend interface but provides well-structured APIs that can be integrated with any frontend application.  \n\n## 🔐 Security  \n- User authentication and authorization are managed with **Spring Security** and **JWT Authentication** to ensure a secure application environment.  \n\n## 🔧 Setup \u0026 Installation  \n1. Clone the repository:  \n   ```\n   git clone https://github.com/your-username/gallerist.git\n   ```\n\n2. Navigate to the project directory:\n    ```\n    cd gallerist\n    ```\n\n3. Configure the database settings in application.properties\n\n4. Run the application using:\n    ```\n    mvn spring-boot:run\n    ```\n\n## 🤝 Contributing\n\nWe welcome contributions to this project! Please:\n\nFork the project\nCreate your feature branch (git checkout -b feature/amazing-feature)\nCommit your changes (git commit -m 'Add amazing feature')\nPush to the branch (git push origin feature/amazing-feature)\nOpen a Pull Request\n\n\n## 📄 License\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n### ⭐️ If you found this project useful, please consider giving it a star!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcyldz%2Fgallerist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmcyldz%2Fgallerist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcyldz%2Fgallerist/lists"}