https://github.com/athoi0-0/vendefacil
About Vende-Fácil es una aplicación desarrollada para facilitar la conexión entre vendedores de productos agrícolas y compradores de alimentos del campo.
https://github.com/athoi0-0/vendefacil
bash bootstrap copilot env flask git github jinja2 json mit-license postgresql postman python visual-studio-code
Last synced: 6 months ago
JSON representation
About Vende-Fácil es una aplicación desarrollada para facilitar la conexión entre vendedores de productos agrícolas y compradores de alimentos del campo.
- Host: GitHub
- URL: https://github.com/athoi0-0/vendefacil
- Owner: Athoi0-0
- License: mit
- Created: 2025-05-14T14:19:47.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-07-17T23:13:14.000Z (6 months ago)
- Last Synced: 2025-07-18T00:22:40.729Z (6 months ago)
- Topics: bash, bootstrap, copilot, env, flask, git, github, jinja2, json, mit-license, postgresql, postman, python, visual-studio-code
- Language: Python
- Size: 26.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Vende-Fácil 🌾
## Introduction
Welcome to Vende-Fácil! This application aims to bridge the gap between agricultural product sellers and food buyers. Our goal is to create a seamless connection that benefits both parties. Whether you are a farmer looking to sell your produce or a consumer seeking fresh food, Vende-Fácil is here to help.
## Table of Contents
1. [Features](#features)
2. [Technologies Used](#technologies-used)
3. [Installation](#installation)
4. [Usage](#usage)
5. [Contributing](#contributing)
6. [License](#license)
7. [Links](#links)
## Features
- **User-Friendly Interface**: Navigate easily through our intuitive design.
- **Real-Time Listings**: Sellers can post their products instantly.
- **Search Functionality**: Buyers can find products quickly using filters.
- **Secure Transactions**: We prioritize safety in every transaction.
- **Community Feedback**: Users can leave reviews and ratings.
## Technologies Used
Vende-Fácil utilizes a variety of technologies to ensure a robust and scalable application:
- **Backend**: Flask
- **Database**: PostgreSQL
- **Frontend**: Bootstrap, Jinja2
- **Development Tools**: Visual Studio Code, Git, GitHub
- **Environment Management**: dotenv (env)
- **API Testing**: Postman
- **Scripting**: Bash
- **Programming Language**: Python
## Installation
To get started with Vende-Fácil, follow these steps:
1. **Clone the Repository**:
```bash
git clone https://github.com/Athoi0-0/vendefacil.git
```
2. **Navigate to the Directory**:
```bash
cd vendefacil
```
3. **Set Up a Virtual Environment**:
```bash
python -m venv venv
source venv/bin/activate # On Windows use `venv\Scripts\activate`
```
4. **Install Dependencies**:
```bash
pip install -r requirements.txt
```
5. **Set Up the Database**:
Configure your PostgreSQL database and update the connection settings in your `.env` file.
6. **Run the Application**:
```bash
flask run
```
## Usage
Once the application is running, you can access it at `http://127.0.0.1:5000`.
### Seller Instructions
1. **Create an Account**: Sign up to start listing your products.
2. **Post Products**: Use the "Add Product" feature to list your agricultural goods.
3. **Manage Listings**: Edit or delete your products as needed.
### Buyer Instructions
1. **Browse Products**: Use the search bar to find what you need.
2. **Contact Sellers**: Reach out directly to sellers for inquiries.
3. **Leave Feedback**: Rate your experience after purchases.
## Contributing
We welcome contributions! If you would like to contribute to Vende-Fácil, please follow these steps:
1. **Fork the Repository**: Click on the "Fork" button at the top right of the page.
2. **Create a New Branch**:
```bash
git checkout -b feature/YourFeatureName
```
3. **Make Your Changes**: Implement your feature or fix.
4. **Commit Your Changes**:
```bash
git commit -m "Add Your Feature Description"
```
5. **Push to Your Fork**:
```bash
git push origin feature/YourFeatureName
```
6. **Open a Pull Request**: Go to the original repository and click "New Pull Request".
## License
Vende-Fácil is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
## Links
To download the latest version of Vende-Fácil, visit our [Releases page](https://github.com/Athoi0-0/vendefacil/releases). You can find the necessary files to download and execute the application there.
For more updates and releases, check our [Releases section](https://github.com/Athoi0-0/vendefacil/releases) regularly.
## Conclusion
Thank you for checking out Vende-Fácil! We hope this application makes it easier for sellers and buyers to connect. If you have any questions or feedback, feel free to reach out. Happy selling and buying!