{"id":22221286,"url":"https://github.com/jerry-felipe/inventory-api","last_synced_at":"2025-10-13T06:31:53.156Z","repository":{"id":263462250,"uuid":"890488457","full_name":"jerry-felipe/Inventory-API","owner":"jerry-felipe","description":"A backend service for managing and tracking inventory in real time. Features include real-time stock updates, product management, low stock alerts, and reporting on inventory movements. Supports multiple warehouses and integrates with secure authentication methods for efficient access.","archived":false,"fork":false,"pushed_at":"2024-11-18T17:30:52.000Z","size":4,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-02T23:13:11.176Z","etag":null,"topics":["ci-cd","docker","java","jwt","logging","microservices","oracle","resilience4j","scalability","spring-boot"],"latest_commit_sha":null,"homepage":"https://jerry-felipe.github.io/Inventory-API/","language":"HTML","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/jerry-felipe.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":"2024-11-18T16:49:13.000Z","updated_at":"2024-11-22T02:37:43.000Z","dependencies_parsed_at":"2024-11-18T18:05:00.124Z","dependency_job_id":"87da5eba-c5c7-442d-9fba-c88e422b440a","html_url":"https://github.com/jerry-felipe/Inventory-API","commit_stats":null,"previous_names":["jerry-felipe/inventory-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry-felipe%2FInventory-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry-felipe%2FInventory-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry-felipe%2FInventory-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry-felipe%2FInventory-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jerry-felipe","download_url":"https://codeload.github.com/jerry-felipe/Inventory-API/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236309834,"owners_count":19128390,"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","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":["ci-cd","docker","java","jwt","logging","microservices","oracle","resilience4j","scalability","spring-boot"],"created_at":"2024-12-02T23:12:57.320Z","updated_at":"2025-10-13T06:31:47.864Z","avatar_url":"https://github.com/jerry-felipe.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Inventory-API\nA backend service for managing and tracking inventory in real time. Features include real-time stock updates, product management, low stock alerts, and reporting on inventory movements. Supports multiple warehouses and integrates with secure authentication methods for efficient access.\n\n# Features  \n- Real-Time Inventory Tracking: Monitor stock levels and updates across multiple locations.  \n- Product Management: Add, update, and remove products with detailed information.  \n- Low Stock Alerts: Notifications when inventory is low or needs to be reordered.  \n- Reporting: Generate reports on stock levels, product movements, and trends.  \n- Multi-Warehouse Support: Manage inventory across multiple warehouses or stores.\n\n# Technologies Used  \n- Backend Framework: Spring Boot  \n- Database: Oracle Database (Oracle XE)  \n- JDBC Driver: Oracle JDBC Driver ('ojdbc8.jar')  \n- Authentication: JWT for secure access  \n- API Documentation: Swagger/OpenAPI  \n- Caching: Redis (optional)  \n\n# Set Up the Environment  \n1. Install Oracle XE (Oracle Database Express Edition):  \n   - Download from [Oracle XE Downloads](https://www.oracle.com/database/technologies/xe-downloads.html).  \n\n2. Configure Database:  \n   - Create the necessary database schema and tables for the inventory system.  \n   - Example connection URL:  \n     '''env\n     DATABASE_URL=jdbc:oracle:thin:@localhost:1521:xe\n     '''\n\n3. Set up the environment variables:  \n   - Create a '.env' file or set system environment variables for the Oracle database connection:  \n     '''env\n     DATABASE_URL=jdbc:oracle:thin:@localhost:1521:xe\n     DB_USERNAME=your_username\n     DB_PASSWORD=your_password\n     REDIS_URL=redis://localhost:6379  # optional\n     JWT_SECRET_KEY=your_jwt_secret_key\n     '''\n\n4. Add Oracle JDBC Driver:  \n   - Ensure you have the Oracle JDBC Driver ('ojdbc8.jar') in your classpath or add it as a dependency in 'pom.xml' if you're using Maven:  \n     '''xml\n     \u003cdependency\u003e\n         \u003cgroupId\u003ecom.oracle.database.jdbc\u003c/groupId\u003e\n         \u003cartifactId\u003eojdbc8\u003c/artifactId\u003e\n         \u003cversion\u003e19.8.0.0\u003c/version\u003e\n     \u003c/dependency\u003e\n     '''\n\n5. Run the Application:  \n   - To start the Spring Boot application:  \n     '''bash\n     mvn spring-boot:run\n     '''\n\n# Usage  \n- Start the API server using Spring Boot:  \n  '''bash\n  mvn spring-boot:run\n  '''  \n- Access the API documentation at:  \n  '''\n  http://localhost:8080/swagger-ui.html\n  '''\n\n# Endpoints  \n| Endpoint                     | Method | Description                            |  \n|------------------------------|--------|----------------------------------------|  \n| '/inventory/add'             | POST   | Add a new product to the inventory.    |  \n| '/inventory/update/{id}'     | PUT    | Update product details by ID.          |  \n| '/inventory/delete/{id}'     | DELETE | Remove a product from the inventory.   |  \n| '/inventory/track/{id}'      | GET    | Get current stock level for a product. |  \n| '/inventory/reports'         | GET    | Generate inventory reports.            |  \n\n# Contributing  \nContributions are welcome! Please fork the repository and submit a pull request with detailed notes.\n\n# License  \nThis project is licensed under the MIT License.\n\n---  \nFor more information, contact jerry.felipe@gmail.com.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjerry-felipe%2Finventory-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjerry-felipe%2Finventory-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjerry-felipe%2Finventory-api/lists"}