Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/abrahamuchos/inventory-api

API inventory system developed in Laravel under the TDD methodology.
https://github.com/abrahamuchos/inventory-api

Last synced: 6 days ago
JSON representation

API inventory system developed in Laravel under the TDD methodology.

Awesome Lists containing this project

README

        

# Inventory API

This is an experimental API to manage inventory and stock. All this by managing your users (they must log in).

Rest API for managing items, repurchase, users and stock.

## โœ… Features

- Add item
- Update item
- Get items by filters
- Get item (by sku)
- Get stock and reorder status
- Add stock
- Reduce stock
- Register user
- Login user

## โš™๏ธ Tech Stack

- Laravel 11.9
- SqLite
- Pest 2.0

## ๐Ÿ’พ Installation

Install and run

1. Clone and move to folder
```bash
$ git clone [email protected]:abrahamuchos/inventory-api.git
$ cd inventory-api
```

2. Install dependecies
```bash
$ composer install
```

3. Create a copy of the `.env.example` file and rename it to `.env`. Next, configure the necessary environment variables.

4. Generate an application key by running `php artisan key:generate`.

5. Run `php artisan migrate` to create the database tables.

6. Run `php artisandb:seed` to create dummy data and admin user.

7. Run `php artisan serve` to start the Laravel development server.

## ๐Ÿงช Tests
To run all the tests

```bash
$ php artisan test
```

To run a specific test
```bash
$ php artisan test --filter test_name_example
```

## ๐Ÿ“„ Docs

[Invoice API Collection - Postman](https://documenter.getpostman.com/view/6168326/2sAYJ3DLtQ)

[Invoice API Collection - Postman](https://www.postman.com/abrahamuchos/workspace/public-projects/collection/6168326-0da64ad0-4488-42d8-bd8a-6b72b4e5023c?action=share&creator=6168326)

You can find a .json with the endpoints in `/docs/Inventory API.postman_collection.json`

## ๐Ÿง‘โ€๐Ÿ’ป Authors

- [@abrahamuchos](https://github.com/abrahamuchos)
- [Contact mail](mailto:[email protected])

## ๐Ÿ“„ License

[MIT](https://choosealicense.com/licenses/mit/)