bench get-app https://github.com/aaabriceno/Proyecto_Inventario_CEDHI

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=aaabriceno%2FProyecto_Inventario_CEDHI)](https://frappegems.com/gems/apps/aaabriceno/Proyecto_Inventario_CEDHI)

Sistema de Inventario CEDHI Nueva Arequipa

Aplicacion Frappe/ERPNext para gestionar el inventario del CEDHI Nueva Arequipa. El MVP organiza articulos por modulo:

• TI
• Gastronomia
• General

El proyecto incluye carga inicial desde Excel/CSV, roles del PRD, permisos por modulo, reportes iniciales y un workspace de trabajo dentro de Frappe.

Que se sube a este repo

Este repositorio contiene solo la app custom:

apps/inventario_cedhi

No se debe subir todo my-bench. Las carpetas env, sites, logs, config, apps/frappe y apps/erpnext son parte de la instalacion local o dependencias externas.

Que NO viene incluido al clonar

Al clonar este repositorio no se obtiene la base de datos local de Anthony ni el contenido ya cargado en su sitio inventario.local.

Este repo SI incluye:

• Codigo de la app inventario_cedhi.
• Scripts para crear/configurar campos, roles, permisos, reportes y workspace.
• Excel originales y CSV preparados para importacion.
• Documentacion del proyecto.

Este repo NO incluye:

• Usuarios creados en la maquina de Anthony.
• Contrasenas.
• Sesiones iniciadas.
• Articulos ya importados dentro de MariaDB.
• Archivos cargados en sites/inventario.local/private/files.
• Backups o configuracion local de sites.

Cada integrante debe crear su propio sitio local, instalar la app, ejecutar los scripts de configuracion y luego importar los CSV.

Requisitos

• Frappe Bench instalado
• ERPNext instalado en el bench
• Python, Node, Redis y MariaDB configurados segun la guia oficial de Frappe/ERPNext

Instalacion en un bench existente

Desde la carpeta del bench:

cd ~/frappe/my-bench
bench get-app https://github.com/aaabriceno/Proyecto_Inventario_CEDHI.git --branch develop
bench --site inventario.local install-app inventario_cedhi

Si el sitio todavia no existe, primero crear e instalar ERPNext:

bench new-site inventario.local
bench --site inventario.local install-app erpnext
bench --site inventario.local install-app inventario_cedhi

Configuracion inicial del MVP

Ejecutar estos comandos desde la raiz del bench:

bench --site inventario.local execute inventario_cedhi.setup_inventory.add_gastronomy_catalog_fields
bench --site inventario.local execute inventario_cedhi.setup_inventory.add_import_traceability_fields
bench --site inventario.local execute inventario_cedhi.setup_inventory.configure_module_specific_article_form
bench --site inventario.local execute inventario_cedhi.setup_inventory.create_alerta_inventario_doctype
bench --site inventario.local execute inventario_cedhi.setup_inventory.create_basic_inventory_reports
bench --site inventario.local execute inventario_cedhi.setup_inventory.configure_inventory_list_views
bench --site inventario.local execute inventario_cedhi.setup_inventory.create_inventory_workspace
bench --site inventario.local execute inventario_cedhi.setup_inventory.configure_inventory_role_permissions
bench --site inventario.local clear-cache

Si bench start estaba corriendo, reiniciarlo despues de cambios en hooks.py.

Al terminar esta configuracion, el sitio tendra la estructura del MVP:

• DocTypes y campos necesarios.
• Roles y permisos del PRD.
• Reportes iniciales.
• Workspace Inventario CEDHI.

Pero todavia no tendra los articulos cargados. Los articulos se cargan importando los CSV.

Datos iniciales

Los Excel originales estan en:

datos_iniciales/

Los CSV preparados para importar estan en:

datos_iniciales/csv/

Archivos principales:

• import_articulos_gastronomia.csv
• import_articulos_gastronomia_licores.csv
• import_articulos_ti_sala_computo.csv

La importacion se realiza desde Frappe en:

Importacion de Datos

Tipo de documento:

Articulo de Inventario

Tipo de importacion:

Insertando nuevos registros

No usar archivos dentro de sites/inventario.local/private/files como fuente del repo. Esos son archivos locales cargados en un sitio.

Carga de articulos

Despues de ejecutar la configuracion inicial, importar los CSV desde Frappe:

1. Abrir Importacion de Datos.
2. Crear una nueva importacion.
3. En Tipo de Documento, elegir Articulo de Inventario.
4. En Tipo de importacion, elegir Insertando nuevos registros.
5. Subir uno de los CSV de datos_iniciales/csv/.
6. Revisar la vista previa.
7. Iniciar importacion.

Repetir el proceso para:

• datos_iniciales/csv/import_articulos_gastronomia.csv
• datos_iniciales/csv/import_articulos_gastronomia_licores.csv
• datos_iniciales/csv/import_articulos_ti_sala_computo.csv

Estos CSV son la fuente compartida del equipo. La importacion que ya existe en la maquina de Anthony no se copia automaticamente al clonar GitHub.

Roles del sistema

Roles definidos para el MVP:

• SuperAdministrador Inventario: acceso total al inventario y usuarios del proyecto.
• Admin TI: gestiona solo articulos del modulo TI.
• Admin Cocina: gestiona solo articulos del modulo Gastronomia.
• Admin General: edita General y puede visualizar los otros modulos.
• Revisor: solo lectura.
• Reportante: crea alertas/incidencias y ve solo sus propios reportes.

Las reglas por modulo estan en:

inventario_cedhi/permissions.py

Los hooks de permisos estan en:

inventario_cedhi/hooks.py

Usuarios de prueba

Los usuarios tambien viven en la base local de cada sitio. Por eso, al clonar el repo no apareceran automaticamente los usuarios de Anthony.

Cada integrante puede crear usuarios de prueba desde Frappe y asignarles roles. Ejemplos:

superadmin@cedhi.local    -> SuperAdministrador Inventario
admin.ti@cedhi.local      -> Admin TI
admin.cocina@cedhi.local  -> Admin Cocina
admin.general@cedhi.local -> Admin General
revisor@cedhi.local       -> Revisor
profesor@cedhi.local      -> Reportante

Como los correos @cedhi.local no existen realmente, la contrasena temporal se puede establecer desde consola:

bench --site inventario.local execute frappe.utils.password.update_password --args '["usuario@cedhi.local", "Cedhi12345"]'

No guardar contrasenas reales en codigo ni en documentacion.

Reportes y workspace

Workspace:

Inventario CEDHI

Reportes iniciales:

• Resumen Inventario por Modulo
• Stock Critico Gastronomia
• Inventario TI por Ubicacion
• Gastronomia sin Stock Critico

Flujo de alertas

Las alertas no nacen principalmente desde los administradores. El flujo esperado del MVP es:

Profesor o usuario reportante
-> crea una Alerta de Inventario
-> el sistema toma modulo y ubicacion desde el articulo
-> Admin TI / Admin Cocina / Admin General revisa segun su modulo
-> SuperAdministrador Inventario puede ver todas las alertas

Permisos principales:

• Reportante: puede crear alertas y ver sus propias alertas.
• Admin TI: recibe y gestiona alertas del modulo TI.
• Admin Cocina: recibe y gestiona alertas del modulo Gastronomia.
• Admin General: recibe y gestiona alertas del modulo General.
• Revisor: puede leer alertas, sin resolverlas.
• SuperAdministrador Inventario: ve y gestiona todas.

Al crear una alerta, el sistema completa automaticamente:

• Reportado por
• Fecha de reporte
• Modulo
• Ubicacion

Los usuarios con rol Reportante deben tener configurado en su ficha de usuario:

• Modulo asignado
• Ubicacion asignada

Esto permite representar PCs o usuarios de reporte ubicados en un laboratorio, cocina o ambiente especifico. Por ejemplo:

profesor.lab01@cedhi.local
Rol: Reportante
Modulo asignado: TI
Ubicacion asignada: Laboratorio 1

Con esa configuracion, el reportante solo puede seleccionar articulos de su ubicacion asignada al crear alertas.

Flujo de trabajo con Git

La rama compartida principal del proyecto es:

develop

Antes de trabajar:

git checkout develop
git pull

Crear una rama por tarea:

git checkout -b feature/nombre-de-la-tarea

Ejemplos:

feature/dashboard-inventario
feature/alertas-stock
feature/reportes-gastronomia
feature/documentacion-video

Al terminar:

git add .
git commit -m "Descripcion breve del cambio"
git push -u origin feature/nombre-de-la-tarea

Luego abrir un Pull Request hacia develop.

Documentacion del proyecto

• docs/guia_inicio_proyecto.md
• docs/analisis_datos_iniciales.md
• PRD_ Sistema de Inventario Integral1.pdf
• Defincion MVP Proyecto de Prácticas Sociales ABS 2026-01 (1).pdf

Licencia

MIT