πŸ›’ Super Mercado EconΓ³mico 🏬

✨ Descripción

Β‘Bienvenido al proyecto Super Mercado EconΓ³mico! πŸ›’

Este proyecto Django te permite gestionar de manera eficiente todos los aspectos de tu supermercado, desde los productos hasta los proveedores. Con un diseΓ±o minimalista y elegante, la aplicaciΓ³n es intuitiva y fΓ‘cil de usar.

πŸš€ CaracterΓ­sticas Principales

  • Productos: πŸ“¦ Agrega, edita y elimina productos con facilidad. Incluye detalles como imΓ‘genes, descripciones, precios y stock.
  • Marcas: 🏷️ Organiza tus productos por marcas reconocidas para una mejor gestiΓ³n y visualizaciΓ³n.
  • Proveedores: 🀝 MantΓ©n un registro completo de tus proveedores, con informaciΓ³n de contacto y detalles relevantes.
  • CategorΓ­as: πŸ—‚οΈ Clasifica tus productos en categorΓ­as para facilitar la bΓΊsqueda y la organizaciΓ³n.
  • AutenticaciΓ³n: πŸ” Protege el acceso a las funciones de administraciΓ³n con un sistema seguro de registro e inicio de sesiΓ³n.

🎨 Diseño Minimalista y Oscuro

La interfaz de usuario estΓ‘ diseΓ±ada con un estilo minimalista y una paleta de colores oscura, que brinda una experiencia visual moderna y elegante.

πŸ› οΈ TecnologΓ­as Utilizadas

  • Backend:
    • Django: El sΓ³lido framework web de Python que impulsa la aplicaciΓ³n.
    • SQLite: Base de datos ligera y eficiente para almacenar los datos.
  • Frontend:
    • HTML, CSS, JavaScript: Lenguajes esenciales para crear la interfaz de usuario.
    • Bootstrap: Framework CSS para un diseΓ±o responsivo y estilizado.
    • Font Awesome: Biblioteca de iconos para aΓ±adir elementos visuales atractivos.

πŸ“‚ Estructura del Proyecto

 proy_sales_may
 β”œβ”€β”€ core
 β”‚   β”œβ”€β”€ migrations
 β”‚   β”œβ”€β”€ __init__.py
 β”‚   β”œβ”€β”€ admin.py
 β”‚   β”œβ”€β”€ apps.py
 β”‚   β”œβ”€β”€ forms.py
 β”‚   β”œβ”€β”€ models.py
 β”‚   β”œβ”€β”€ serializers.py
 β”‚   β”œβ”€β”€ tests.py
 β”‚   β”œβ”€β”€ urls.py
 β”‚   └── views.py
 β”œβ”€β”€ media
 β”‚   β”œβ”€β”€ products
 β”‚   └── cocacola.jpg
 β”œβ”€β”€ proy_sales_may
 β”‚   β”œβ”€β”€ __init__.py
 β”‚   β”œβ”€β”€ asgi.py
 β”‚   β”œβ”€β”€ settings.py
 β”‚   β”œβ”€β”€ urls.py
 β”‚   β”œβ”€β”€ utils.py
 β”‚   └── wsgi.py
 β”œβ”€β”€ static
 β”‚   β”œβ”€β”€ css
 β”‚   β”œβ”€β”€ base.css
 β”‚   β”‚   β”œβ”€β”€ components
 β”‚   β”‚   β”‚  β”œβ”€β”€ buttons.css
 β”‚   β”‚   β”‚  β”œβ”€β”€ form.css
 β”‚   β”‚   β”‚  β”œβ”€β”€ footer.css
 β”‚   β”‚   β”‚  β”œβ”€β”€ modal.css
 β”‚   β”‚   β”‚  β”œβ”€β”€ table.css
 β”‚   β”‚   β”œβ”€β”€ layout
 β”‚   β”‚   β”‚  β”œβ”€β”€ navigation.css
 β”‚   β”‚   β”‚  β”œβ”€β”€ header.css
 β”‚   β”‚   β”œβ”€β”€ pages
 β”‚   β”œβ”€β”€ images
 β”‚   β”‚   β”œβ”€β”€ favicon-001.png    
 β”‚   β”œβ”€β”€ media
 β”‚   β”‚   β”œβ”€β”€ products
 β”‚   β”‚   β”‚  β”œβ”€β”€ cocacola.jpg
 β”œβ”€β”€ staticfiles
 β”œβ”€β”€ templates
 β”‚   β”œβ”€β”€ base.html
 β”‚   β”œβ”€β”€ signin.html
 β”‚   β”œβ”€β”€ signup.html
 β”‚   β”œβ”€β”€ profile.html
 β”‚   β”œβ”€β”€ partials
 β”‚   β”‚  β”œβ”€β”€ footer.html
 β”‚   β”‚  β”œβ”€β”€ header.html
 β”‚   β”‚  β”œβ”€β”€ navigation.html
 β”‚   β”œβ”€β”€ core
 β”‚   β”‚  β”œβ”€β”€ brand
 β”‚   β”‚  β”‚  β”œβ”€β”€ brand_list.html
 β”‚   β”‚  β”‚  β”œβ”€β”€ brand_form.html
 β”‚   β”‚  β”‚  β”œβ”€β”€ brand_delete.html
 β”‚   β”‚  β”œβ”€β”€ categorys
 β”‚   β”‚  β”‚  β”œβ”€β”€ category_list.html
 β”‚   β”‚  β”‚  β”œβ”€β”€ category_form.html
 β”‚   β”‚  β”‚  β”œβ”€β”€ category_delete.html
 β”‚   β”‚  β”œβ”€β”€ products
 β”‚   β”‚  β”‚  β”œβ”€β”€ list.html
 β”‚   β”‚  β”‚  β”œβ”€β”€ form.html
 β”‚   β”‚  β”‚  β”œβ”€β”€ delete.html
 β”‚   β”‚  β”œβ”€β”€ suppliers
 β”‚   β”‚  β”‚  β”œβ”€β”€ supplier_list.html
 β”‚   β”‚  β”‚  β”œβ”€β”€ supplier_form.html
 β”‚   β”‚  β”‚  β”œβ”€β”€ supplier_delete.html
 β”‚   β”‚  β”œβ”€β”€ home.html
 β”œβ”€β”€ .gitignore
 β”œβ”€β”€ factur.sqlite3
 β”œβ”€β”€ manage.py
 β”œβ”€β”€ orm.py
 β”œβ”€β”€ README.md
 β”œβ”€β”€ requirements.txt

βš™οΈ CΓ³mo Ejecutar la AplicaciΓ³n

  1. Clonar el repositorio:

    git clone https://github.com/fborjaz/proy_sales_may.git 
    cd proy_sales_may
  2. Crear (o activar) un entorno virtual::

    python -m venv venv  
    source venv/bin/activate  # En macOS/Linux
    venv\Scripts\activate    # En Windows
    . venv/bin/activate     # Activa el entorno virtual
  3. Instalar las dependencias:

    pip install -r requirements.txt
  4. Aplicar las migraciones:

    python manage.py migrate
  5. Crear un superusuario:

    python manage.py createsuperuser
  6. Ejecutar el servidor de desarrollo:

    python manage.py runserver
  7. Acceder a la aplicaciΓ³n en tu navegador:

    Abre tu navegador web y ve a http://127.0.0.1:8000/.
    
  8. Iniciar sesiΓ³n en el panel de administraciΓ³n:

    Accede a http://127.0.0.1:8000/admin/ y utiliza las credenciales del superusuario que creaste en el paso 5.
    

Explora y disfruta de Super Mercado EconΓ³mico!** πŸŽ‰

🀝 Contribuciones Β‘Las contribuciones son bienvenidas! Si encuentras algΓΊn error o quieres agregar nuevas funcionalidades, no dudes en abrir un issue o enviar un pull request. πŸ™Œ

Copyright Β© 2024 Frank Borja. Todos los derechos reservados.