lib-common-angular 0.0.9 → 0.0.11

package/lib-core-dtos/mcs-bussines-n/productos/monedaDTO.raml

@@ -0,0 +1,29 @@
+#%RAML 1.0 DataType
+type: object
+properties:
+  id:
+    type: integer
+    required: false
+    description: ID opcional de la moneda
+    example: 5
+  codigo_iso:
+    type: string
+    required: true
+    description: Código ISO de la moneda
+    example: "USD"
+  nombreMoneda:
+    type: string
+    required: true
+    description: Nombre de la moneda
+    example: "Dólar americano"
+  precio:
+    type: number
+    required: true
+    description: Precio del producto en esta moneda
+    example: 100.50
+
+example:
+  id: 5
+  codigo_iso: "USD"
+  nombreMoneda: "Dólar americano"
+  precio: 100.50

package/lib-core-dtos/mcs-bussines-n/productos/pedidoproductos/pedido.raml

@@ -0,0 +1,77 @@
+#%RAML 1.0 DataType
+uses:
+  PedidoProductoDTO: ./pedidoProducto.raml
+  MediosPagosDTO: ../../mediosPagosDTO.raml
+  MonedaDTO: ./monedaDTO.raml
+
+type: object
+properties:
+  id:
+    type: integer
+    required: false
+    description: ID del pedido
+    example: 15
+
+  idBusiness:
+    type: integer
+    required: false
+    description: ID del negocio o comercio que recibe el pedido
+    example: 3
+
+  comentario:
+    type: string
+    required: false
+    description: Comentario del usuario para el pedido
+    example: "Entregar entre 9 y 12hs"
+
+  cantidad:
+    type: integer
+    required: true
+    description: Total de unidades o líneas de productos
+    example: 4
+
+  total:
+    type: number
+    required: true
+    description: Total general del pedido
+    example: 1250.75
+
+  datosUsuario:
+    type: string
+    required: true
+    description: ID del usuario que realizó el pedido
+    example: "user-550e8400-e29b-41d4-a716-123456789000"
+
+  medioPago:
+    type: MediosPagosDTO
+    required: true
+    description: Medio de pago seleccionado para el pedido
+
+  facturasUrl:
+    type: string
+    required: false
+    description: URL de la factura o comprobante
+    example: "https://cdn.tuservidor.com/facturas/15.pdf"
+
+  monedaTotal:
+    type: MonedaDTO
+    required: false
+    description: Moneda en la que se calcula el total del pedido
+
+  productos:
+    type: array
+    required: true
+    description: Lista de productos incluidos en el pedido
+    items: PedidoProductoDTO
+
+  fechaCreacion:
+    type: string
+    required: false
+    description: Fecha de creación del pedido
+    example: "2025-11-13T12:00:00.000Z"
+
+  fechaActualizacion:
+    type: string
+    required: false
+    description: Fecha de última actualización del pedido
+    example: "2025-11-13T12:30:00.000Z"

package/lib-core-dtos/mcs-bussines-n/productos/pedidoproductos/pedidoProducto.raml

@@ -0,0 +1,28 @@
+#%RAML 1.0 DataType
+uses:
+  ProductoDTO: ./productoDTO.raml
+
+type: object
+properties:
+  id:
+    type: integer
+    required: false
+    description: ID del detalle del producto en el pedido
+    example: 1
+
+  producto:
+    type: ProductoDTO
+    required: true
+    description: Producto incluido en el pedido
+
+  estado:
+    type: integer
+    required: true
+    description: Estado del producto en el pedido (0=pendiente, 1=pagado, 2=enviado, 3=entregado)
+    example: 0
+
+  pedidoId:
+    type: string
+    required: false
+    description: UUID del pedido al que pertenece el producto
+    example: "ped-550e8400-e29b-41d4-a716-123456789000"

package/lib-core-dtos/mcs-bussines-n/productos/productoDTO.raml

@@ -0,0 +1,103 @@
+#%RAML 1.0 DataType
+uses:
+  MonedaDTO: ./monedaDTO.raml
+  ImagenDTO: ../imagenDTO.raml
+
+type: object
+properties:
+  id:
+    type: string
+    required: false
+    description: UUID del producto
+    example: "550e8400-e29b-41d4-a716"
+  name:
+    type: string
+    required: true
+    description: Nombre del producto
+    example: "producto 1"
+  precios:
+    type: MonedaDTO[]
+    required: true
+    description: Lista de precios del producto en diferentes monedas
+  descuento:
+    type: integer
+    required: false
+    description: Descuento aplicado al producto en porcentaje
+    example: 10
+  cantidad:
+    type: integer
+    required: false
+    description: Cantidad de productos disponibles
+    example: 10
+  idBusiness:
+    type: integer
+    required: false
+    description: ID del negocio
+    example: 1
+  idCategoria:
+    type: string
+    required: true
+    description: ID de la categoría del producto
+    example: "550e8400-e29b-41d4-a716"
+  nombreCategoria:
+    type: string
+    required: false
+    description: Nombre de la categoría del producto
+    example: "Electrónica"
+  imagen:
+    type: ImagenDTO[]
+    required: true
+    description: Array de imágenes del producto
+  estado:
+    type: string
+    required: true
+    description: Estado del producto
+    example: "disponible"
+  descripcion:
+    type: string
+    required: false
+    description: Descripción del producto
+    example: "producto de alta calidad a un precio accesible"
+  comision:
+    type: number
+    required: false
+    description: Comisión que se le asigna al producto
+    example: 50
+  fechaCreacion:
+    type: string
+    required: false
+    description: Fecha de creación del producto en formato ISO
+    example: "2025-03-25T14:30:45.000Z"
+  fechaActualizacion:
+    type: string
+    required: false
+    description: Fecha de última actualización del producto en formato ISO
+    example: "2025-03-25T14:30:45.000Z"
+  idDatosUsuario:
+    type: string
+    required: true
+    description: ID del usuario que creó o actualizó el producto
+    example: "550e8400-e29b-41d4-a716-446655440000"
+
+example:
+  id: "550e8400-e29b-41d4-a716"
+  name: "producto 1"
+  precios: 
+    - id: 5
+      codigo_iso: "USD"
+      nombreMoneda: "Dólar americano"
+      precio: 100
+  cantidad: 10
+  idBusiness: 1
+  idCategoria: "550e8400-e29b-41d4-a716"
+  imagen: 
+    - id: "img-550e8400"
+      url: "https://example.com/image.jpg"
+      alt: "Imagen del producto"
+      idComponente: 1
+  estado: "disponible"
+  descripcion: "producto de alta calidad a un precio accesible"
+  comision: 50
+  fechaCreacion: "2025-03-25T14:30:45.000Z"
+  fechaActualizacion: "2025-03-25T14:30:45.000Z"
+  idDatosUsuario: "550e8400-e29b-41d4-a716-446655440000"

package/lib-core-dtos/mcs-bussines-n/request/create.bussinesRq.DTO.raml

@@ -0,0 +1,19 @@
+#%RAML 1.0 DataType
+uses: 
+  BusinessDTO: ../../mcs-bussines-n/bussines/businessDTO.raml
+  RegisterUserDTO: ../../mcs-usuarios-Sp/request/registerUserDTO.raml
+type: object
+properties:
+  id:
+    type: integer
+    required: true
+    description: Identificador único del negocio.
+    example: 1
+  business:
+    type: BusinessDTO
+    required: true
+    description: Información del negocio.
+  usuario:
+    type: RegisterUserDTO
+    required: true
+    description: Usuario asociado al negocio.

package/lib-core-dtos/mcs-usuarios-Sp/request/registerUserDTO.raml

@@ -0,0 +1,37 @@
+#%RAML 1.0 DataType
+
+uses: 
+  
+    DatesUserDTO: ../users/datesUserDTO.raml
+    keycloakBuilderDTO:  ../users/keycloakBuilderDTO.raml
+
+type: object
+properties:
+  idBussines:
+    type: integer
+    required: false
+    description: Identificador único del negocio al que pertenece el usuario.
+    example: 1
+  email:
+    type: string
+    required: false
+    description: Correo electrónico del usuario. Debe ser único y válido.
+    example: usuario@ejemplo.com
+  password:
+    type: string
+    required: false
+    description: Contraseña del usuario. Debe cumplir con las políticas de seguridad.
+    example: P@ssw0rd123
+  DatesUser:
+    type: DatesUserDTO
+    required: false
+    description: Información adicional del usuario, nombre usuario id , y demas .
+  token:
+    type: string
+    required: false
+    description: Token de autenticación asociado al usuario.
+    example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+  KeycloakBuilderDTO:
+    type: KeycloakBuilderDTO
+    required: false
+    description: Configuración de Keycloak para la creación del usuario.

package/lib-core-dtos/mcs-usuarios-Sp/users/addresDTO.raml

@@ -0,0 +1,29 @@
+#%RAML 1.0 DataType
+
+type: object
+properties:
+  adress:
+    type: string
+    required: false
+    description: Dirección completa.
+    example: "Calle 123 #45-67"
+  propertyTypes:
+    type: array
+    items: !include ./propertyTypeDTO.raml
+    required: false
+    description: Lista de tipos de propiedad.
+  country:
+    type: !include ./countryDTO.raml
+    required: false
+    description: Información del país.
+
+example:
+  adress: "Calle 123 #45-67"
+  propertyTypes:
+    - idPropertyType: 1
+      namePropertyType: "Apartamento"
+  country:
+    idCountry: 57
+    name: "Colombia"
+    codigoIso: "CO"
+    url: "https://ejemplo.com/colombia"

package/lib-core-dtos/mcs-usuarios-Sp/users/cityDTO.raml

@@ -0,0 +1,13 @@
+#%RAML 1.0 DataType
+type: object
+properties:
+  id_city:
+    type: integer
+    required: false
+    description: Identificador de la ciudad.
+    example: 1
+  name:
+    type: string
+    required: false
+    description: Nombre de la ciudad
+    example: "Bogotá"

package/lib-core-dtos/mcs-usuarios-Sp/users/countryDTO.raml

@@ -0,0 +1,34 @@
+#%RAML 1.0 DataType
+
+type: object
+properties:
+  idCountry:
+    type: integer
+    required: false
+    description: Identificador del país.
+    example: 57
+  name:
+    type: string
+    required: false
+    description: Nombre del país.
+    example: "Colombia"
+  cities:
+    type: array
+    items: !include ./cityDTO.raml
+    required: false
+    description: Ciudades asociadas al país.
+    example:
+      - id_city: 1
+        name: "Bogotá"
+      - id_city: 2
+        name: "Medellín"
+  codigoIso:
+    type: string
+    required: false
+    description: Código ISO del país.
+    example: "CO"
+  url:
+    type: string
+    required: false
+    description: URL asociada al país.
+    example: "https://ejemplo.com/colombia"

package/lib-core-dtos/mcs-usuarios-Sp/users/datesUserDTO.raml

@@ -0,0 +1,71 @@
+#%RAML 1.0 DataType
+uses: 
+  PhoneDTO: ./phoneDTO.raml
+  AddresDTO: ./addresDTO.raml
+
+type: object
+properties:
+  id:
+    type: string
+    required: true
+    description: Identificador único del usuario en formato UUID.
+    example: "550e8400-e29b-41d4-a716-446655440000"
+  firstName:
+    type: string
+    required: false
+    description: Primer nombre del usuario.
+    example: "Juan"
+  secondName:
+    type: string
+    required: false
+    description: Segundo nombre del usuario.
+    example: "Carlos"
+  phone:
+    type: array
+    items: PhoneDTO
+    required: false
+    description: Lista de números de teléfono asociados al usuario.
+  idUrl:
+    type: string
+    required: false
+    description: Identificador único de la URL asociada al usuario en formato UUID.
+    example: "550e8400-e29b-41d4-a716-446655440000"
+  addresses:
+    type: array
+    items: AddresDTO
+    required: false
+    description: Lista de direcciones asociadas al usuario.
+  estado:
+    type: string
+    required: false
+    description: Estado actual del usuario.
+    example: "Activo"
+  nombreRol:
+    type: string
+    required: true
+    description: Nombre del rol asignado al usuario.
+    example: "Administrador"
+
+example:
+  id: "550e8400-e29b-41d4-a716-446655440000"
+  firstName: "Juan"
+  secondName: "Carlos"
+  phone:
+    - number: "+573001234567"
+      cityCode: 1
+      countryCode: 57
+      nameCity: "Bogotá"
+      nameCountry: "Colombia"
+  idUrl: "550e8400-e29b-41d4-a716-446655440000"
+  addresses:
+    - adress: "Calle 123 #45-67"
+      propertyTypes:
+        - idPropertyType: 1
+          namePropertyType: "Apartamento"
+      country:
+        idCountry: 57
+        name: "Colombia"
+        codigoIso: "CO"
+        url: "https://ejemplo.com/colombia"
+  estado: "Activo"
+  nombreRol: "Administrador"

package/lib-core-dtos/mcs-usuarios-Sp/users/keycloakBuilderDTO.raml

@@ -0,0 +1,18 @@
+#%RAML 1.0 DataType
+
+type: object
+properties:
+  realm:
+    type: string
+    required: false
+    description: Nombre del realm de Keycloak.
+    example: "mi-realm"
+  clientId:
+    type: string
+    required: false
+    description: Identificador del cliente en Keycloak.
+    example: "mi-client"
+
+example:
+  realm: "mi-realm"
+  clientId: "mi-client"

package/lib-core-dtos/mcs-usuarios-Sp/users/loginDTO.raml

@@ -0,0 +1,13 @@
+#%RAML 1.0 DataType
+type: object
+properties:
+  email:
+    type: string
+    required: false
+    description: Correo electrónico del usuario.
+    example: usuario@ejemplo.com
+  password:
+    type: string
+    required: false
+    description: Contraseña del usuario.
+    example: P@ssw0rd123

package/lib-core-dtos/mcs-usuarios-Sp/users/phoneDTO.raml

@@ -0,0 +1,36 @@
+#%RAML 1.0 DataType
+
+type: object
+properties:
+  number:
+    type: string
+    required: false
+    description: Número de teléfono completo.
+    example: "+573001234567"
+  cityCode:
+    type: integer
+    required: false
+    description: Código de la ciudad.
+    example: 1
+  countryCode:
+    type: integer
+    required: false
+    description: Código del país.
+    example: 57
+  nameCity:
+    type: string
+    required: false
+    description: Nombre de la ciudad.
+    example: "Bogotá"
+  nameCountry:
+    type: string
+    required: false
+    description: Nombre del país.
+    example: "Colombia"
+
+example:
+  number: "+573001234567"
+  cityCode: 1
+  countryCode: 57
+  nameCity: "Bogotá"
+  nameCountry: "Colombia"

package/lib-core-dtos/mcs-usuarios-Sp/users/propertyTypeDTO.raml

@@ -0,0 +1,18 @@
+#%RAML 1.0 DataType
+
+type: object
+properties:
+  idPropertyType:
+    type: integer
+    required: false
+    description: Identificador del tipo de propiedad.
+    example: 1
+  namePropertyType:
+    type: string
+    required: false
+    description: Nombre del tipo de propiedad.
+    example: "Apartamento"
+
+example:
+  idPropertyType: 1
+  namePropertyType: "Apartamento"

package/lib-core-dtos/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "lib-core-dtos",
+  "version": "1.0.0",
+  "description": "Librería común de DTOs para twincode",
+  "type": "module",
+  "scripts": {
+    "validate:raml": "node scripts/validate-raml.js",
+    "validate:raml:all": "find . -name '*.raml' -not -path './node_modules/*' | xargs -I {} npx raml-1-parser {} --validate",
+    "prepare": "husky install"
+  },
+  "devDependencies": {
+    "husky": "^8.0.3",
+    "lint-staged": "^15.0.0"
+  },
+  "lint-staged": {
+    "*.raml": [
+      "node scripts/validate-raml.js"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/juliaosistem/lib-core-dtos.git"
+  },
+  "author": "twincode",
+  "license": "ISC"
+}