{"id":15101823,"url":"https://github.com/blackmarllborooo/building-materials-market-API","last_synced_at":"2026-01-20T16:01:27.876Z","repository":{"id":194097413,"uuid":"687469285","full_name":"blackmarllborooo/building-materials-market-API","owner":"blackmarllborooo","description":"API for online building materials store (framework can be reused for different turnover platforms)","archived":false,"fork":false,"pushed_at":"2023-11-07T08:42:43.000Z","size":959,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-23T12:50:35.676Z","etag":null,"topics":["bunjs","clean-architecture","docker","docker-compose","express","javascript","jwt-authentication","migrations","nodejs","oop","oop-principles","oracle","solid","sql","swagger","swagger-ui","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/blackmarllborooo.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":"2023-09-05T12:23:13.000Z","updated_at":"2024-11-05T14:24:48.000Z","dependencies_parsed_at":"2024-12-18T17:51:12.479Z","dependency_job_id":null,"html_url":"https://github.com/blackmarllborooo/building-materials-market-API","commit_stats":{"total_commits":126,"total_committers":1,"mean_commits":126.0,"dds":0.0,"last_synced_commit":"4e85235e9aef10d44e5d7a6ec9634d8dee718406"},"previous_names":["blackmarllbor0/building-materials-market-api","blackmarllborooo/building-materials-market-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/blackmarllborooo/building-materials-market-API","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackmarllborooo%2Fbuilding-materials-market-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackmarllborooo%2Fbuilding-materials-market-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackmarllborooo%2Fbuilding-materials-market-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackmarllborooo%2Fbuilding-materials-market-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blackmarllborooo","download_url":"https://codeload.github.com/blackmarllborooo/building-materials-market-API/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackmarllborooo%2Fbuilding-materials-market-API/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28606288,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T14:45:23.139Z","status":"ssl_error","status_checked_at":"2026-01-20T14:44:16.929Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["bunjs","clean-architecture","docker","docker-compose","express","javascript","jwt-authentication","migrations","nodejs","oop","oop-principles","oracle","solid","sql","swagger","swagger-ui","typescript"],"created_at":"2024-09-25T18:41:20.009Z","updated_at":"2026-01-20T16:01:27.432Z","avatar_url":"https://github.com/blackmarllborooo.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Builder Materials Market - Online Store for Construction Materials\n\nWelcome to the Builder Materials Market, your one-stop online shop for construction materials. This README.md file provides essential information to get you started with our application.\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Environment Variables](#environment-variables)\n- [npm Scripts](#npm-scripts)\n- [Getting Started](#getting-started)\n- [Current State](#current-state)\n- [Contact Us](#contact-us)\n\n## Introduction\n\nBuilder Materials Market is an online store for construction materials. This application is designed to provide a convenient platform for customers to browse and purchase various construction supplies. Below, you will find information on setting up and running the application.\n\n## Environment Variables\n\nBefore running the application, make sure to set up the following environment variables. These variables are essential for configuring the application properly.\n\n```shell\nSERVER_PORT=8080\n\nDOCKER_CONTAINER_NAME=builder_materials_market\nDOCKER_APP_CONTAINER_NAME=builder_materials_market_app\n\nORACLE_SID=bmm\nORACLE_PDB=builder_materials_market\nORACLE_PWD=pwd\nORACLE_PORT=1521\nORACLE_EDITION=enterprise\nORACLE_USER=builder_materials_market\nORACLE_CONN_STRING=localhost:1521/blackmarllbor0\n\nTOKEN_LIVE_TIME_IN_HOURS=10\nTOKEN_SECRET=auevoramjizn\n```\n\n## npm Scripts\n\nWe have included several npm scripts to help you manage the application. Here are the available scripts and their descriptions:\n\n- `npm start`: Build the application and start the server.\n- `npm run dev`: Run the application in development mode with hot-reloading.\n- `npm run debug`: Run the application in debug mode.\n- `npm run build`: Compile TypeScript code.\n- `npm run up_db`: Start the Docker container for the database.\n- `npm run migrate_up`: Run database migrations to the latest version.\n- `npm run migrate_down`: Rollback the latest database migration.\n- `npm run lint`: Run ESLint for code linting.\n- `npm run format`: Format code using Prettier.\n- `npm run gen:spec`: Generate a single OpenAPI specification file from multiple YAML files.\n\n## Getting Started\n\n### To get started with the Builder Materials Market application, follow these steps:\n\n1. Clone the repository to your local machine.\n\n`git clone https://github.com/blackmarllbor0/building-materials-market-API.git`\n\n2. Install all dependencies.\n\n`npm install`\n\n3. Configure the necessary environment variables in the .env file as mentioned in the previous section.\n\n4. If you've made changes to the OpenAPI specification in YAML files, compile them into a single file using the following command:\n\n`npm run gen:spec`\n\n5. If you want your user to be automatically created when building the database, and also create data to be filled in, then go to the `migrations` folder and in all `.sql` files, on the first lines, change the names of your PDB and USER_NAME.\n\n6. Start the application:\n\n`npm start`\n\n### Or you can launch a docker image with a ready-made app using the command `npm run app:up`\n\nIf you decide to run the application via docker image, then in your `.env` file change the `ORACLE_CONN_STRING` value to `ORACLE_CONN_STRING=${DOCKER_DB_CONTAINER_NAME}`.\n\n### Your Builder Materials Market online store should now be up and running.\n\n## Current State\n\nPlease note that the application is currently in development, and further updates and improvements will be made. Don't forget to check for updates and ensure that you have the latest dependencies installed.\n\nThank you for choosing Builder Materials Market for your construction material needs! If you have any questions or encounter any issues, please feel free to reach out to us.\n\nHappy shopping!\n\n## Contact Us\n\nIf you have any questions, suggestions, or encounter any issues, please feel free to reach out to us:\n\n- Telegram: @blackmarllbor0\n- Email: 3100194@gmail.com\n\nThank you for choosing Builder Materials Market for your construction material needs! Happy shopping!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackmarllborooo%2Fbuilding-materials-market-API","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackmarllborooo%2Fbuilding-materials-market-API","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackmarllborooo%2Fbuilding-materials-market-API/lists"}