AMRIT - Inventory API

Inventory service acts as a medicine inventory management and dispensing unit that helps in distributing the medicine to the pateint as per the prescription. Exposes below set of features as REST APIs.

• Item tracking
• Purchase order management
• Inventory reports
• Create, read, update, and delete inventory items.
• Get inventory levels.

Building From Source

This microservice is built on Java, Spring boot framework and MySQL DB. For detailed steps, refer to the Developer Guide

Prerequisites

• JDK 17
• Wildfly 11
• MySQL
• Springboot V2

Installation

To install the inventory module, follow these steps:

1. Clone the repository to your local machine.
2. Install the dependencies mvn clean install

Creating a build configuration and running the application

1. You can copy common_example.properties to common_local.properties and edit the file accordingly. The file is under src/main/environment folder.
2. Run the spring server with local configuration mvn spring-boot:run -DENV_VAR=local

Open the application in your browser. The inventory module will be accessible at http://localhost:3000/inventory.

Setting Up Commit Hooks

This project uses Git hooks to enforce consistent code quality and commit message standards. Even though this is a Java project, the hooks are powered by Node.js. Follow these steps to set up the hooks locally:

Prerequisites

• Node.js (v18 or later)
• npm (comes with Node.js)

Setup Steps

1. Install Node.js and npm
   • Download and install from nodejs.org
   • Verify installation with:

     node --version
     npm --version
     

2. Install dependencies
   • From the project root directory, run:

     npm ci
     

   • This will install all required dependencies including Husky and commitlint
3. Verify hooks installation
   • The hooks should be automatically installed by Husky
   • You can verify by checking if the .husky directory contains executable hooks

Commit Message Convention

This project follows a specific commit message format:

• Format: type(scope): subject
• Example: feat(login): add remember me functionality Types include:
• feat: A new feature
• fix: A bug fix
• docs: Documentation changes
• style: Code style changes (formatting, etc.)
• refactor: Code changes that neither fix bugs nor add features
• perf: Performance improvements
• test: Adding or fixing tests
• build: Changes to build process or tools
• ci: Changes to CI configuration
• chore: Other changes (e.g., maintenance tasks, dependencies) Your commit messages will be automatically validated when you commit, ensuring project consistency.

Usage

Inventory module can be used to track items, create purchase orders, generate inventory reports, and scan barcodes. To access the inventory module, navigate to http://localhost:3000/inventory in your browser. You will be able to view all of the items in your inventory, create purchase orders and generate inventory reports.

All other features have been exposed as REST endpoints. Refer to the SWAGGER API specification for details.

Filing Issues

If you encounter any issues, bugs, or have feature requests, please file them in the main AMRIT repository. Centralizing all feedback helps us streamline improvements and address concerns efficiently.

Join Our Community

We’d love to have you join our community discussions and get real-time support!
Join our Discord server to connect with contributors, ask questions, and stay updated.