Estándares de Nomenclatura de Objetos de Base de Datos Omnicanal
GERENCIA DE DESARROLLO Y AYQUITECTURA
Historial de Revisión
| Fecha | Versión | Descripción | Autor |
|---|---|---|---|
| 16-06-2026 | 1.1 | Revisor | 1. Javier Hernández Barraza 2. Eduardo Tovar López |
1. Objetivo
Definir un estándar de nomenclatura para los objetos de base de la base de datos Omnicanal con el fin de:
- Mantener consistencia en el modelo de datos.
- Facilitar la identificación del propósito de cada objeto.
- Mejorar la mantenibilidad y administración de la base de datos.
- Simplificar las tareas de desarrollo, soporte y auditoría.
- Facilitar la integración entre aplicaciones y equipos de trabajo.
2. Convenciones Generales
2.1 Formato de nombres
Todos los objetos deberán cumplir las siguientes reglas:
- Utilizar únicamente letras minúsculas.
- Separar palabras mediante guion bajo (
_). - Evitar espacios, caracteres especiales y acentos.
- Utilizar nombres descriptivos y orientados al negocio.
- Evitar abreviaturas ambiguas.
Correcto
trx_sales_order
cat_country
fn_calculate_tax
Incorrecto
SalesOrder
CAT_PAIS
fnCalcTax
tbl1
2.2 Idioma
Se recomienda utilizar un único idioma para todo el schema de cada aplicativo.
No se deben mezclar idiomas.
Correcto
cat_country
trx_invoice
o
cat_pais
trx_factura
Incorrecto
cat_country
trx_factura
3. Nomenclatura de Tablas
Las tablas deberán identificarse según su propósito funcional.
| Prefijo | Tipo | Descripción |
|---|---|---|
cat_ | Catálogo | Información maestra o de referencia utilizada por múltiples procesos. |
cfg_ | Configuración | Parámetros y configuraciones de los sistemas. |
trx_ | Transaccional | Información generada por las operaciones del negocio. |
hist_ | Histórico | Información histórica o archivada. |
tmp_ | Temporal | Datos temporales utilizados durante procesos o cargas. |
log_ | Bitácora | Registro de eventos, ejecuciones, errores y monitoreo. |
3.1 Tablas de Catálogo
Contienen información relativamente estática y reutilizable.
Ejemplos
cat_country
cat_currency
cat_status
cat_document_type
3.2 Tablas de Configuración
Almacenan parámetros configurables del sistema.
Ejemplos
cfg_system_parameter
cfg_email_template
cfg_company
3.3 Tablas Transaccionales
Contienen la información operativa del negocio.
Ejemplos
trx_sales_order
trx_invoice
trx_payment
trx_purchase_order
3.4 Tablas Históricas
Almacenan información consolidada o archivada.
Ejemplos
hist_sales_order
hist_invoice
hist_inventory
3.5 Tablas Temporales
Utilizadas para procesos ETL, integraciones o cálculos intermedios.
Ejemplos
tmp_customer_load
tmp_invoice_validation
tmp_process_data
3.6 Tablas de Bitácora
Almacenan eventos técnicos o funcionales.
Ejemplos
log_process_execution
log_api_request
log_system_error
4. Nomenclatura de Vistas
Vistas
Prefijo:
vw_
Ejemplos
vw_customer_summary
vw_sales_report
vw_active_users
Vistas Materializadas
Prefijo:
mv_
Ejemplos
mv_monthly_sales
mv_customer_balance
mv_inventory_summary
5. Nomenclatura de Secuencias
Prefijo:
seq_
Formato:
seq_<tabla>
Ejemplos
seq_trx_sales_order
seq_trx_invoice
seq_cat_country
6. Nomenclatura de Funciones
Prefijo:
fn_
Formato:
fn_<objeto>
Ejemplos
fn_calculate_tax
fn_get_customer_balance
fn_validate_order
7. Nomenclatura de Procedimientos
Prefijo:
sp_
Formato recomendado:
sp_<objeto>
Ejemplos
sp_process_invoice
sp_generate_report
sp_close_accounting_period
8. Nomenclatura de Triggers
Prefijo:
trg_
Formato:
trg_<tabla>
Ejemplos
trg_trx_invoice
trg_trx_invoice
trg_trx_sales_order
9. Nomenclatura de Índices
Prefijo:
idx_
Formato:
idx_<tabla>_<consecutivo>
Ejemplos
idx_trx_invoice_1
idx_trx_invoice_2
idx_cat_country_1
10. Nomenclatura de Restricciones
Llaves Primarias
Prefijo:
pk_<tabla>
Ejemplos
pk_trx_invoice
pk_cat_country
Llaves Foráneas
Prefijo:
fk_
Formato recomendado:
fk_<tabla_padre>_<columna>
Ejemplos
fk_trx_invoice_customer
fk_trx_order_company
Restricciones Únicas
Prefijo:
uk_<tabla_padre>_<columna>
Ejemplos
uk_cat_country_code
uk_cfg_parameter_key
Restricciones Check
Prefijo:
chk_
Ejemplos
chk_trx_invoice_amount
chk_customer_status
11. Nomenclatura de Tipos de Datos
Prefijo:
typ_
Ejemplos
typ_address
typ_customer
typ_audit_record
12. Ejemplo Integrado
cat_country
cfg_system_parameter
trx_customer
trx_sales_order
trx_invoice
hist_trx_invoice
vw_invoice_summary
mv_monthly_sales
seq_trx_invoice
fn_calculate_tax
fn_get_customer_balance
sp_process_invoice
trg_trx_invoice_biu
pk_trx_invoice
fk_trx_invoice_customer
uk_trx_invoice_number
chk_trx_invoice_amount
idx_trx_invoice_1
idx_trx_invoice_2
log_process_execution
tmp_invoice_load