{"id":24442070,"url":"https://github.com/sbrunomello/jchain","last_synced_at":"2025-10-09T14:50:43.225Z","repository":{"id":243592743,"uuid":"812736011","full_name":"sbrunomello/jchain","owner":"sbrunomello","description":"A prototype private blockchain system built with Java 21 and Spring Boot. Designed to simulate secure employee data tracking using cryptographic blocks.","archived":false,"fork":false,"pushed_at":"2025-04-07T18:09:57.000Z","size":41,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-03T23:31:56.072Z","etag":null,"topics":["blockchain","business","descentralized","enterprise","java"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sbrunomello.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":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-06-09T18:23:20.000Z","updated_at":"2025-04-07T18:11:21.000Z","dependencies_parsed_at":"2024-06-17T02:53:46.053Z","dependency_job_id":"4f9ea7d8-9d88-4f92-b595-38c2a6638923","html_url":"https://github.com/sbrunomello/jchain","commit_stats":null,"previous_names":["sbrunomello/jchain"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sbrunomello/jchain","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sbrunomello%2Fjchain","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sbrunomello%2Fjchain/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sbrunomello%2Fjchain/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sbrunomello%2Fjchain/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sbrunomello","download_url":"https://codeload.github.com/sbrunomello/jchain/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sbrunomello%2Fjchain/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001504,"owners_count":26083118,"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-10-09T02:00:07.460Z","response_time":59,"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":["blockchain","business","descentralized","enterprise","java"],"created_at":"2025-01-20T21:44:44.996Z","updated_at":"2025-10-09T14:50:43.219Z","avatar_url":"https://github.com/sbrunomello.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# jchain – Blockchain Private Network\n\nA prototype private blockchain system built with Java 21 and Spring Boot. This project was created as an experimental environment to explore blockchain technology and its potential applications in business contexts.\n\n## 🚀 Current Features\n\n### 1. Employee Registration\n- **Create Employees**: Register new employees with attributes such as name, email, department, position, and joining date.\n- **Unique Key**: Each employee receives a unique key generated using a cryptographic hash based on their ID and creation timestamp.\n\n### 2. Attendance Tracking\n- **Check-in API**: Employees can record their check-ins using a REST API.\n- **Key Validation**: The employee key is validated to ensure authenticity.\n- **Timestamped Records**: Each entry includes date and time of attendance.\n\n### 3. Blockchain Visualization\n- **Block View**: API endpoints to visualize all blocks in the blockchain.\n- **Attendance History**: List all check-ins by employee key.\n\n## 🧱 Data Persistence\n\nThe blockchain data is temporarily persisted in encrypted JSON files to prevent data loss. This approach is planned to evolve into a more decentralized and distributed system in future iterations.\n\n## 🔮 Upcoming Features\n\n- **Supply Chain Management** – Product tracking throughout the entire supply chain.  \n- **Document Management** – Secure storage and validation of documents.  \n- **Voting Systems** – Implementation of a transparent and secure digital voting system.  \n- **Smart Contracts** – Automation of legal agreements and business rules.  \n- **Identity Management** – Secure handling of digital identities.  \n- **Asset Monitoring** – Real-time tracking of physical and digital assets.\n\n## 🛠 Technologies Used\n\n- Java 21  \n- Spring Boot  \n- Lombok  \n- Jackson  \n- Postman (API testing)\n\n## ▶️ How to Run\n\n### Requirements\n- Java 21\n- Maven\n\n### Steps\n```bash\ngit clone https://github.com/sbrunomello/jchain.git\ncd jchain\nmvn spring-boot:run\n```\n\n## 📡 Available Endpoints\n\n### ➕ Create Employee\n```http\nPOST /api/employees\nContent-Type: application/json\n\n{\n  \"name\": \"John Doe\",\n  \"email\": \"john.doe@example.com\",\n  \"department\": \"IT\",\n  \"position\": \"Developer\",\n  \"joiningDate\": \"2023-06-01\"\n}\n```\n\n### 🕒 Register Attendance\n```http\nPOST /api/attendances\nContent-Type: application/json\n\n{\n  \"employeeKey\": \"employee-unique-key\",\n  \"attendanceTime\": \"2024-06-09T08:00:00\"\n}\n```\n\n### 📋 List Employee Attendances\n```http\nGET /api/attendances/{employeeKey}\n```\n\n### 🔗 View Blockchain\n```http\nGET /api/blockchain\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Feel free to open issues or submit pull requests.\n\n## 📬 Contact\n\n- [Instagram](https://www.instagram.com/)\n- [LinkedIn](https://www.linkedin.com/)\n\nDeveloped with ❤️ by Mello.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsbrunomello%2Fjchain","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsbrunomello%2Fjchain","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsbrunomello%2Fjchain/lists"}