Manage your components easily.
- A bill of materials (BOM) is a comprehensive list of parts, items, assemblies, subassemblies, intermediate assemblies, documents, drawings, and other materials required to create a product.
- BOM App is web application that developed for material tracking and management. In the app you have an inventory for your components. It uses Mouser Electronics API to fetch necessary information about component. For managing components of your project, you need to create a BOM. This process is like creating a new project. You can create components into created BOM from your inventory. It automatically adjusts quantity on hand according to look at inventory.
The project consist of two side. The backend side is developed with Java Spring Boot, the frontend side is developed with ReactJs.
- Register mouser to generate search api key.
- Go MouserAPI and create a new account.
- Go Mouser Search API to fetch data (image, description, manufacturer etc.) of components.
- Complete the online Search API Request Form
- They will email your Search API key and additional set-up information
- Change
mouser.api.search.key
with search api key atsrc/main/resources/docker/application.properties
- Change
mouser.api.search.key
with search api key atsrc/main/resources/application.properties
- For more info about Mouser Api Doc.
- Install Docker to execute
docker-compose.yml
file.
- To create jar file, type
mvn clean package -Dmaven.test.skip=true
in project root directory. - At project root directory, execute
docker-compose build
to create postgres and bomapp-backend images for docker. - To start containers, execute
docker-compose up
- The container will start after these commands, and you can reach to be server from http://locahost:8081. You can
change port from Dockerfile (
src/main/docker/Dockerfile
).
docker-compose up output:
c9b4153b2f85 bom-app "/bin/sh -c 'java -D…" 5 days ago Up 4 seconds 0.0.0.0:8081->8081/tcp bomapp-backend
76154570fc1f postgres "docker-entrypoint.s…" 5 days ago Up 5 seconds 0.0.0.0:5432->5432/tcp bomapp-db
- You can get api doc from
http://localhost:8081/api/v1/swagger-ui/
.
- Create an account with username, email and password.
- Click
Components
section then click+
button to add new components into your inventory. - In the Mouser app search any component to get mouser part number.
- Enter quantity on hand, supplier link and mouser part number to create component into your inventory. (Example
mouser part number of capacitor:
80-C1210C331KDGAUTO
) - Click BOMs then click
+
button to add a BOM. BOMs are like a new projects. - Enter title and description of the BOM.
- Click show button of newly created BOM.
- Click
+
button to add component to use for BOM. - Choose already created component from your inventory list.
- Enter quantity, cost and lead time to create component to use.
Repeat these steps and manage your components easily.
BomApp.mp4
TODO
bom-app-be
uses following technologies and frameworks:
- Spring Boot: 2.5.4
- data-jpa
- web
- security
- test
- actuator
- jsonwebtoken
- postgreSQL
- docker
- lombok
- flywaydb
- swagger
- @oktaykcr - Design and implement
- @okankocer - Idea
See also the list of contributors who participated in this project.