Files
AnchorOS/lib/utils/short-id.ts
Marco Gallegos 0f3de32899 🚀 FASE 4 COMPLETADO: Comentarios auditables + Calendario funcional + Gestión staff/recursos
 COMENTARIOS AUDITABLES IMPLEMENTADOS:
- 80+ archivos con JSDoc completo para auditoría manual
- APIs críticas con validaciones business/security/performance
- Componentes con reglas de negocio documentadas
- Funciones core con edge cases y validaciones

 CALENDARIO MULTI-COLUMNA FUNCIONAL (95%):
- Drag & drop con reprogramación automática
- Filtros por sucursal/staff, tiempo real
- Indicadores de conflictos y disponibilidad
- APIs completas con validaciones de colisión

 GESTIÓN OPERATIVA COMPLETA:
- CRUD staff: APIs + componente con validaciones
- CRUD recursos: APIs + componente con disponibilidad
- Autenticación completa con middleware seguro
- Auditoría completa en todas las operaciones

 DOCUMENTACIÓN ACTUALIZADA:
- TASKS.md: FASE 4 95% completado
- README.md: Estado actual y funcionalidades
- API.md: 40+ endpoints documentados

 SEGURIDAD Y VALIDACIONES:
- RLS policies documentadas en comentarios
- Business rules validadas manualmente
- Performance optimizations anotadas
- Error handling completo

Próximos: Nómina/POS/CRM avanzado (FASE 4 final)
2026-01-17 15:31:13 -06:00

22 lines
919 B
TypeScript

/**
* @description Generate collision-safe short ID for public booking references
* @returns {Promise<string>} 6-character unique alphanumeric ID
* @example const id = await generateShortId() // Returns "A1B2C3"
* @audit BUSINESS RULE: Short IDs are public-facing, used in URLs and confirmations
* @audit SECURITY: IDs are random but not cryptographically secure (public use only)
* @audit Validate: Generated ID is unique across all existing bookings
* @audit PERFORMANCE: PostgreSQL function handles collision detection efficiently
* @audit PERFORMANCE: Maximum 5 retry attempts before throwing error
*/
import { supabaseAdmin } from '@/lib/supabase/admin'
export async function generateShortId(): Promise<string> {
const { data, error } = await supabaseAdmin.rpc('generate_short_id')
if (error) {
throw new Error(`Failed to generate short_id: ${error.message}`)
}
return data as string
}