https://github.com/watson-clara/inventoryapppublic
A full-stack inventory management system using Flask, React, and PostgreSQL. Features user authentication, real-time inventory tracking, reporting, and database management with SQLAlchemy. Docker-ready for deployment. Secure, efficient, and scalable.
https://github.com/watson-clara/inventoryapppublic
docker flask inventory-management postgresql python react sqlalchemy
Last synced: 3 months ago
JSON representation
A full-stack inventory management system using Flask, React, and PostgreSQL. Features user authentication, real-time inventory tracking, reporting, and database management with SQLAlchemy. Docker-ready for deployment. Secure, efficient, and scalable.
- Host: GitHub
- URL: https://github.com/watson-clara/inventoryapppublic
- Owner: watson-clara
- Created: 2024-10-18T16:55:11.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-07T22:09:26.000Z (over 1 year ago)
- Last Synced: 2025-06-03T16:53:26.704Z (about 1 year ago)
- Topics: docker, flask, inventory-management, postgresql, python, react, sqlalchemy
- Language: HTML
- Homepage:
- Size: 44.9 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Inventory Management Web Application
A full-stack inventory management system designed to streamline inventory tracking and management processes.
## Features
- **User Authentication**: Secure login system with role-based access control.
- **Inventory Tracking**: Add, update, and delete inventory items with real-time data synchronization.
- **Reporting**: Generate reports on inventory levels, sales, and other key metrics.
## Technologies Used
- **Backend**: Flask (Python)
- **Frontend**: React (JavaScript)
- **Database**: PostgreSQL
- **ORM**: SQLAlchemy
- **Deployment**: Docker
## Installation
### 1. Clone the repository
```bash
git clone https://github.com/watson-clara/InventoryAppPublic.git
cd InventoryAppPublic
```
### 2. Set up the backend
- Navigate to the `backend` directory:
```bash
cd backend
```
- Create a virtual environment and activate it:
```bash
python3 -m venv env
source env/bin/activate # On Windows use `env\Scripts\activate`
```
- Install the required packages:
```bash
pip install -r requirements.txt
```
- Set up the PostgreSQL database:
```bash
psql -U your_username -d inventory_db -f schema.sql
```
Ensure that `SQLALCHEMY_DATABASE_URI` in `config.py` is correctly set:
```python
SQLALCHEMY_DATABASE_URI = 'postgresql://your_username:your_password@localhost:5432/inventory_db'
```
- Apply database migrations:
```bash
flask db init
flask db migrate
flask db upgrade
```
- Run the backend server:
```bash
flask run
```
### 3. Set up the frontend
- Navigate to the `frontend` directory:
```bash
cd ../frontend
```
- Install the dependencies:
```bash
npm install
```
- Start the frontend development server:
```bash
npm start
```
## Usage
Once both the backend and frontend servers are running, you can access the application by navigating to `http://localhost:3000` in your web browser.
## Contributing
Contributions are welcome! Please fork the repository and create a pull request with your changes.
## License
This project is licensed under the MIT License.