Skip to content

CodeStrong2023/CodeHive-EC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

🐝 CodeHive ecommerce 🐝

CodeHive es una plataforma de comercio electrónico desarrollada con Django que permite a los usuarios navegar, buscar y comprar productos. La aplicación incluye funcionalidades como carrito de compras y autenticación de usuario. Esta plataforma está diseñada para ser fácil de usar y expandir, ideal para negocios pequeños y medianos que desean tener presencia en línea. ¡Espero que disfrutes tanto de ella utilizandola como nosotros desarrollandola!


Características

  • Autenticación de usuarios: Registro, inicio de sesión, cierre de sesión y recuperación de contraseña para usuarios registrados.
  • Gestión de productos: Posibilidad de agregar, editar y eliminar productos (solo accesible para administradores desde el panel admin de Django).
  • Carrito de compras: Los usuarios pueden añadir productos al carrito, ver el resumen de su carrito y modificar la cantidad de cada artículo.
  • Interfaz de usuario intuitiva: Diseño de navegación claro y fácil de usar, adaptable a dispositivos móviles.
  • Sistema de notificaciones: Notificación de éxito al realizar una compra o completar alguna acción relevante en la plataforma.
  • Catálogo de productos: Visualización de productos organizada en categorías, con opciones de filtrado y paginación para facilitar la navegación por todo el inventario disponible.

Tecnologías Usadas

bootstrap html5 css3 python django

Instalación

  1. Clona este repositorio:

    git clone https://github.com/CodeStrong2023/CodeHive-EC.git
    
  2. Navega al directorio del proyecto:

    cd CodeHive-EC
    
  3. Entrar al entorno virtual desde PowerShell:

    source .\.venv\Scripts\activate.ps1 
    
  4. Ingresar a la carpeta "ecommerce":

    cd ecommerce
    
  5. Aplica las migraciones para configurar la base de datos:

    python manage.py migrate
    
  6. Cargar archivos estáticos (opcional):

    python manage.py collectstatic
    
  7. Inicia el servidor de desarrollo:

    python manage.py runserver
    

Guía de uso

  • Acceso al proyecto: Una vez que el servidor esté corriendo (python manage.py runserver), abre tu navegador y navega a http://127.0.0.1:8000/ para acceder a la aplicación.

  • Registrar una cuenta: Para poder acceder a funcionalidades como el carrito de compras, es necesario registrarse. Haz clic en "Sign In" para crear una cuenta de usuario.

  • Explorar el catálogo: Navega por el catálogo de productos en la sección "Productos". Aquí puedes ver todos los productos disponibles, con la opción de filtrarlos por categoría y por precio.

  • Agregar productos al carrito: Cuando encuentres productos de interés, puedes añadirlos a tu carrito de compras para continuar con la compra. Accede al carrito en cualquier momento desde el menú principal.

  • Realizar un pedido: Después de agregar productos al carrito, ve a la página del carrito y sigue el proceso para realizar un pedido.

  • Cerrar sesión: Si has iniciado sesión, puedes cerrar sesión desde el menú en la parte superior derecha de la página haciendo clic en "Log Out".

Contribución

  1. Fork este repositorio

    Haz un "fork" del repositorio para tener una copia personal del proyecto.

  2. Clona tu fork

    Clona tu repositorio forked a tu máquina local:

    git clone https://github.com/CodeStrong2023/CodeHive-EC.git
    
  3. Crea una nueva rama

    Antes de hacer cambios, crea una nueva rama:

    git checkout -b nombre-de-tu-rama
    
  4. Realiza tus cambios

    Haz las modificaciones que desees en el código.

  5. Haz commit de tus cambios

    Una vez hayas terminado, haz commit de tus cambios con un mensaje descriptivo:

    git commit -m "Descripción de los cambios realizados"
    
  6. Sube tus cambios a tu fork

    Sube tus cambios a tu fork en GitHub:

    git push origin nombre-de-tu-rama
    
  7. Envía un pull request

    Ve a la página de tu repositorio en GitHub y haz un pull request para que tus cambios sean revisados y fusionados con el repositorio principal.

  8. Reportar issues

    Si encuentras algún error o problema, abre un "issue" en GitHub detallando el problema encontrado.

Estructura del Proyecto

ecommerce
│
├── manage.py              # Archivo principal para interactuar con el proyecto Django
├── requirements.txt       # Lista de dependencias del proyecto
├── db.sqlite3             # Base de datos SQLite (utilizada durante el desarrollo)
│
├── ecommerce              # Carpeta principal del proyecto con la configuración de Django
│   ├── __init__.py        # Marca la carpeta como un paquete Python
│   ├── settings.py        # Configuraciones generales del proyecto
│   ├── urls.py            # Definición de rutas de la aplicación
│   ├── wsgi.py            # Archivo de punto de entrada para WSGI (Web Server Gateway Interface)
│   └── asgi.py            # Archivo de punto de entrada para ASGI (para despliegue en servidores asíncronos)
│
├── media/                 # Archivos multimedia subidos por los usuarios, como imágenes de productos
│   └── tienda/            # Carpeta donde se almacenan las imágenes de productos
│    
└── apps/                      # Carpeta que contiene las aplicaciones del proyecto
    ├── carrito/               # Aplicación relacionada con la gestión del carrito de compras
    │   ├── migrations/        # Archivos de migración para la base de datos
    │   ├── __init__.py        # Marca la carpeta como un paquete Python
    │   ├── admin.py           # Configuración del panel de administración de Django
    │   ├── apps.py            # Configuración de la aplicación
    │   ├── models.py          # Modelos de datos relacionados con el carrito
    │   ├── views.py           # Lógica de las vistas de la aplicación
    │   ├── urls.py            # Rutas específicas de esta aplicación
    │   └── templates/         # Plantillas HTML específicas de la aplicación
    ├── gestionusuario/        # Aplicación relacionada con la gestión de usuarios
    │   ├── __init__.py        # Marca la carpeta como un paquete Python
    │   ├── admin.py           # Configuración del panel de administración de Django
    │   ├── models.py          # Modelos de datos relacionados con los usuarios
    │   ├── views.py           # Lógica de vistas de esta aplicación
    │   ├── urls.py            # Rutas específicas de esta aplicación
    │   └── templates/         # Plantillas HTML específicas de esta aplicación
    ├── interfazgeneral/       # Aplicación relacionada con la interfaz de usuario general
    │   ├── __init__.py        # Marca la carpeta como un paquete Python
    │   ├── admin.py           # Configuración del panel de administración de Django
    │   ├── models.py          # Modelos de datos específicos para la interfaz
    │   ├── views.py           # Lógica de vistas de esta aplicación
    │   ├── urls.py            # Rutas específicas de esta aplicación
    │   └── templates/         # Plantillas HTML específicas de esta aplicación
    │   └── static/                # Archivos estáticos como imágenes, JavaScript y CSS
    │       ├── css/               # Estilos CSS
    │       └── vendor/ 
    │           ├── bootstrap        # Carpeta que incluye los archivos de Bootstrap.
    │           │   ├── css          Dentro encontrarás los subdirectorios css/ y js/, 
    │           │   └── js           que contienen los archivos CSS y JS de Bootstrap. 
    │           ├── font-awesome
    │           └── jquery             
    ├── pagos/                 # Aplicación relacionada con el proceso de pagos
    │   ├── __init__.py        # Marca la carpeta como un paquete Python
    │   ├── admin.py           # Configuración del panel de administración de Django
    │   ├── models.py          # Modelos de datos relacionados con los pagos
    │   ├── views.py           # Lógica de vistas de esta aplicación
    │   ├── urls.py            # Rutas específicas de esta aplicación
    │   └── templates/         # Plantillas HTML específicas de esta aplicación
    ├── pagosypedidos/         # Aplicación relacionada con pagos y pedidos
    │   ├── __init__.py        # Marca la carpeta como un paquete Python
    │   ├── admin.py           # Configuración del panel de administración de Django
    │   ├── models.py          # Modelos de datos relacionados con los pagos y pedidos
    │   ├── views.py           # Lógica de vistas de esta aplicación
    │   ├── urls.py            # Rutas específicas de esta aplicación
    │   └── templates/         # Plantillas HTML específicas de esta aplicación
    └── productos/             # Aplicación relacionada con la gestión de productos
        ├── __init__.py        # Marca la carpeta como un paquete Python
        ├── admin.py           # Configuración del panel de administración de Django
        ├── models.py          # Modelos de datos relacionados con los productos
        ├── views.py           # Lógica de vistas de esta aplicación
        ├── urls.py            # Rutas específicas de esta aplicación
        └── templates/         # Plantillas HTML específicas de esta aplicación

Videos Presentación

Dream Team

Este proyecto fue desarrollado como parte del proyecto final para la Tecnicatura Universitaria en Programación dada por la UTN FRSR.

¡Agradecemos a todos los involucrados por su esfuerzo y dedicación en el desarrollo de este proyecto!🫶

About

Proyecto Final CodeHive

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published