https://github.com/eddys912/manos-que-alimentan

Sistema para la gestión y asignación de donaciones de alimentos.
https://github.com/eddys912/manos-que-alimentan

expressjs postgresql react tailwindcss typescript vite

Last synced: 13 days ago
JSON representation

Sistema para la gestión y asignación de donaciones de alimentos.

• Host: GitHub
• URL: https://github.com/eddys912/manos-que-alimentan
• Owner: Eddys912
• Created: 2025-05-05T23:16:09.000Z (14 days ago)
• Default Branch: main
• Last Pushed: 2025-05-06T02:48:26.000Z (14 days ago)
• Last Synced: 2025-05-06T03:20:21.156Z (13 days ago)
• Topics: expressjs, postgresql, react, tailwindcss, typescript, vite
• Language: JavaScript
• Homepage:
• Size: 10.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


  
🤝 Manos que Alimentan - Plataforma de Donaciones 🤝

  
Sistema para la gestión y asignación de donaciones de alimentos, desarrollado con TypeScript, Express, React, Vite, TailwindCSS y PostgreSQL.


![JavaScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)

![Express](https://img.shields.io/badge/Express.js-000?logo=express)

![React](https://img.shields.io/badge/React-61DAFB?logo=react&logoColor=black)

![Vite](https://img.shields.io/badge/Vite-646CFF?logo=vite&logoColor=white)

![TailwindCSS](https://img.shields.io/badge/TailwindCSS-38B2AC?logo=tailwind-css)

![PostgreSQL](https://img.shields.io/badge/PostgreSQL-336791?logo=postgresql&logoColor=white)



## 🌟 **Bienvenido**

Plataforma que permite gestionar la recepción, asignación y entrega de donaciones de alimentos a personas en situación de vulnerabilidad. Con este sistema, organizaciones pueden optimizar la distribución de recursos y mejorar su impacto social.

## 📂 **Módulos Principales**

| Módulo            | Descripción                                              |

| ----------------- | -------------------------------------------------------- |

| **Usuarios**      | Gestión de administradores, voluntarios y beneficiarios. |

| **Donaciones**    | Registro y seguimiento de donaciones recibidas.          |

| **Alimentos**     | Control de stock y fechas de caducidad.                  |

| **Reservaciones** | Distribución eficiente de los recursos a beneficiarios.  |

| **Reportes**      | Estadísticas y seguimiento del impacto social.           |

## 🚀 **Instalación y Configuración**

### 🛠️ **Requisitos Previos**

- **Node.js** - Descargar e instalar desde: [NodeJS](https://nodejs.org/).

- **pnpm** - Si no lo tienes, instálalo ejecuando: `npm install -g pnpm`.

- **PostgreSQL** - Descargare instalar desde: [PostgreSQL](https://www.postgresql.org/download/).

### 📥 **Instalación**

1. **Clonar el repositorio:**

   ```bash

   git clone https://github.com/Eddys912/manos-que-alimentan.git

   ```

2. **Acceder al proyecto:**

   ```bash

   cd manos-que-alimentan

   ```

3. **Configurar la base de datos:**

   - Renombra el archivo `.env.example` a `.env` y configurar las variables.

4. **Inicializar el proyecto:**

   - Inicializar el **`backend`**:

   ```bash

   cd backend

   pnpm install

   pnpm run dev

   ```

   - Inicializar el **`frontend`**:

   ```bash

   cd frontend

   pnpm install

   pnpm run dev

   ```

## 🚀 ¿Cómo Contribuir?

1. **Realizar un Fork** del proyecto haciendo clic en el botón `Fork`.

2. **Realizar los pasos de instalación.**

3. **Realiza tus cambios**:

   - Guarda los archivos.

   - Crea un commit con una descripción clara:

     ```bash

     git add .

     git commit -m "Descripción de los cambios realizados"

     ```

4. **Envíar los cambios** a tu repositorio fork:

   ```bash

   git push origin mi-nueva-funcionalidad

   ```

5. **Abre un Pull Request** 🚀:

   - Dirígete al repositorio original y crea un **Pull Request**.

   - Describe los cambios realizados.