Configuración de Backend
El backend de EZY WMS (ezy-wms-backend/Service) se configura mediante dos mecanismos:
-
appsettings.json— El archivo de configuración principal de .NET que controla la configuración del host, registro, conexiones de bases de datos, secretos JWT, gestión de sesiones, licencias, SMTP y parámetros de servicios de fondo. -
Carpeta
Service/config/— Un conjunto de archivos YAML que definen el comportamiento empresarial, el manejo de datos y el área de superficie de la interfaz de usuario. Estos archivos se recargan al inicio del servicio.
Archivos de Configuración
Sección titulada «Archivos de Configuración»| Archivo | Propósito |
|---|---|
appsettings.json | Host de .NET, registro, base de datos, JWT, sesiones, licencias, SMTP, servicios de fondo |
config/Configurations.yaml | Obligatorio. Opciones empresariales principales, filtros de datos, asignaciones de almacenes, detalles de conexión SAP B1 |
config/CustomFields.yaml | Campos adicionales de artículos y documentos expuestos en la interfaz de usuario |
config/Item.yaml | Definiciones de metadatos de artículos editables |
config/Package.yaml | Configuración de etiqueta de paquete, código de barras y metadatos |
config/ExternalCommands.yaml | Exportaciones XML/JSON activadas por eventos o botones manuales |
config/PickingPostProcessing.yaml | Procesadores personalizados de .NET que se ejecutan después de operaciones de picking |
Valores Predeterminados e Inicialización
Sección titulada «Valores Predeterminados e Inicialización»La carpeta Service/init/ contiene copias predeterminadas de todos los archivos de configuración. Estos valores predeterminados se utilizan para inicializar la carpeta Service/config/ en la primera ejecución. Durante la implementación, coloque sus anulaciones específicas del entorno en Service/config/ — la carpeta init no se modifica.
Convenciones
Sección titulada «Convenciones»- Recarga al inicio: Todos los archivos de configuración YAML se analizan cuando se inicia el servicio. Los cambios de configuración requieren un reinicio del servicio.
- Sensibilidad a mayúsculas y minúsculas: YAML es sensible a mayúsculas y minúsculas. Los nombres de propiedades y valores de enumeración deben coincidir exactamente con sus definiciones.
- Sin credenciales en control de versiones: Nunca confirme contraseñas reales de bases de datos, claves API, credenciales SMTP o inicios de sesión de SAP B1 en el repositorio. Utilice variables de entorno o prácticas de implementación segura para inyectarlas en tiempo de ejecución.