Los scopes de una app son los mismos permisos que usa una persona del equipo (módulo.acción): no hay un segundo vocabulario. Pide solo los que tu app necesita.
Un permiso abre lo mismo que le abriría a una persona con ese permiso: por ejemplo, catalog.view_costs muestra costos del mismo modo en que se los mostraría a un Encargado.
Esta tabla sale del código (libs/shared/domain) y se regenera con pnpm nx run docs:generate; un cambio en los permisos sin regenerar falla la convención del repo.
| Scope |
Qué permite |
sales.view |
Consulta el historial de ventas y el detalle de cada ticket. |
sales.create |
Cobra en Vender y usa cuentas abiertas y mesas. |
sales.edit |
Crea y cambia las salas y sus mesas. |
sales.void |
Quita salas y mesas que ya no se usan. |
sales.export |
Descarga el historial de ventas en Excel. |
| Scope |
Qué permite |
catalog.view |
Consulta productos, categorías, precios, descuentos y recargos. |
catalog.create |
Agrega productos, categorías, descuentos y recargos. |
catalog.edit |
Cambia productos, precios, categorías, descuentos y recargos. |
catalog.void |
Borra productos, categorías, descuentos y recargos. |
catalog.view_costs |
Ve costos y márgenes en Catálogo e Inventario. Hace falta para registrar compras. |
catalog.export |
Descarga productos y precios en Excel. |
| Scope |
Qué permite |
inventory.view |
Consulta existencias, movimientos, lotes y traslados. |
inventory.adjust_stock |
Registra compras, ajustes, traslados, producción y mermas. |
inventory.view_sale_value |
Ve cuánto vale el inventario a precio de venta en Existencias e Informes. |
inventory.export |
Descarga existencias, movimientos y compras en Excel. |
| Scope |
Qué permite |
contacts.view |
Consulta clientes y equipo. |
contacts.create |
Agrega clientes, también desde Vender. |
contacts.edit |
Cambia los datos de un contacto. |
contacts.void |
Borra contactos. |
contacts.view_suppliers |
Ve los proveedores y su historial de compras, y los crea o edita. |
contacts.export |
Descarga los contactos en Excel. |
| Scope |
Qué permite |
finance.view |
Consulta cuentas, saldos, gastos y pendientes. |
finance.create |
Registra gastos, pendientes, abonos, transferencias y cuentas. |
finance.edit |
Corrige gastos, pendientes, cuentas y categorías de gasto. |
finance.void |
Anula gastos, pendientes, transferencias y turnos de caja. |
finance.open_register |
Abre su turno de caja. |
finance.close_register |
Cierra su turno de caja y cuenta el efectivo. |
finance.view_register_log |
Consulta el historial de turnos de caja con sus diferencias. |
finance.export |
Descarga cuentas, movimientos, gastos y cajas en Excel. |
| Scope |
Qué permite |
reports.view |
Consulta los informes de ventas e inventario y puede recibir el resumen diario. |
reports.view_profit |
Ve resultados, utilidad neta, márgenes y el costo de lo vendido. |
reports.export |
Descarga los informes en Excel y PDF. |
Una app nunca puede pedir estos, aunque estén en la matriz de roles: administran el comercio o mueven saldo fuera de un documento.
finance.adjust_balance
settings.*
platform.*