uaxi-shared-entities 1.0.0

package/src/entities/camping_coupons.entity.ts

@@ -0,0 +1,60 @@
+// =============================================
+// CAMPAIGN COUPON MAPPING MODEL
+// =============================================
+
+import {
+  BelongsTo,
+  Column,
+  DataType,
+  ForeignKey,
+  Model,
+  Table,
+} from 'sequelize-typescript';
+import { PromotionCampaign } from './promotion_camping';
+import { Coupon } from './coupon.entity';
+
+@Table({
+  tableName: 'campaign_coupons',
+  timestamps: true,
+})
+export class CampaignCoupon extends Model<CampaignCoupon> {
+  @Column({
+    type: DataType.UUID,
+    defaultValue: DataType.UUIDV4,
+    primaryKey: true,
+  })
+  declare id: string;
+
+  @ForeignKey(() => PromotionCampaign)
+  @Column({
+    type: DataType.UUID,
+    allowNull: false,
+  })
+  campaignId: string;
+
+  @ForeignKey(() => Coupon)
+  @Column({
+    type: DataType.UUID,
+    allowNull: false,
+  })
+  couponId: string;
+
+  @Column({
+    type: DataType.INTEGER,
+    defaultValue: 0,
+  })
+  distributedCount: number; // Cuántos cupones se han distribuido
+
+  @Column({
+    type: DataType.INTEGER,
+    defaultValue: 0,
+  })
+  redeemedCount: number; // Cuántos cupones se han canjeado
+
+  // Associations
+  @BelongsTo(() => PromotionCampaign)
+  campaign: PromotionCampaign;
+
+  @BelongsTo(() => Coupon)
+  coupon: Coupon;
+}

package/src/entities/coupon.entity.ts

@@ -0,0 +1,167 @@
+// =============================================
+// COUPON MODEL
+// =============================================
+
+import { Column, DataType, HasMany, Table, Model } from "sequelize-typescript";
+import { CouponUsage } from "./coupon_usages.entity";
+import { CouponUserMapping } from "./coupon_user_mappings.entity";
+import { CouponApplicability, CouponStatus, CouponType } from "../enums";
+
+@Table({
+  tableName: "coupons",
+  timestamps: true,
+})
+export class Coupon extends Model<Coupon> {
+  @Column({
+    type: DataType.UUID,
+    defaultValue: DataType.UUIDV4,
+    primaryKey: true,
+  })
+  declare id: string;
+
+  @Column({
+    type: DataType.STRING,
+    allowNull: false,
+    unique: true,
+  })
+  code: string; // Código del cupón (ej: "WELCOME20", "FIRSTRIDE")
+
+  @Column({
+    type: DataType.STRING,
+    allowNull: false,
+  })
+  name: string; // Nombre descriptivo del cupón
+
+  @Column({
+    type: DataType.TEXT,
+    allowNull: true,
+  })
+  description: string;
+
+  @Column({
+    type: DataType.ENUM(...Object.values(CouponType)),
+    allowNull: false,
+  })
+  type: CouponType;
+
+  @Column({
+    type: DataType.DECIMAL(10, 2),
+    allowNull: true,
+  })
+  discountValue: number; // Valor del descuento (porcentaje o cantidad fija)
+
+  @Column({
+    type: DataType.DECIMAL(10, 2),
+    allowNull: true,
+  })
+  maxDiscountAmount: number; // Monto máximo de descuento (para porcentajes)
+
+  @Column({
+    type: DataType.DECIMAL(10, 2),
+    allowNull: true,
+  })
+  minimumTripAmount: number; // Monto mínimo del viaje para aplicar cupón
+
+  @Column({
+    type: DataType.DECIMAL(10, 2),
+    allowNull: true,
+  })
+  maximumTripAmount: number; // Monto máximo del viaje para aplicar cupón
+
+  @Column({
+    type: DataType.ENUM(...Object.values(CouponApplicability)),
+    defaultValue: CouponApplicability.ALL_USERS,
+  })
+  applicability: CouponApplicability;
+
+  @Column({
+    type: DataType.INTEGER,
+    allowNull: true,
+  })
+  totalUsageLimit: number; // Límite total de usos del cupón
+
+  @Column({
+    type: DataType.INTEGER,
+    defaultValue: 0,
+  })
+  currentUsageCount: number; // Contador actual de usos
+
+  @Column({
+    type: DataType.INTEGER,
+    defaultValue: 1,
+  })
+  usagePerUser: number; // Cuántas veces puede usar un usuario este cupón
+
+  @Column({
+    type: DataType.DATE,
+    allowNull: false,
+  })
+  validFrom: Date;
+
+  @Column({
+    type: DataType.DATE,
+    allowNull: false,
+  })
+  validUntil: Date;
+
+  @Column({
+    type: DataType.ENUM(...Object.values(CouponStatus)),
+    defaultValue: CouponStatus.ACTIVE,
+  })
+  status: CouponStatus;
+
+  @Column({
+    type: DataType.JSON,
+    allowNull: true,
+  })
+  vehicleTypes: string[]; // Tipos de vehículos aplicables
+
+  @Column({
+    type: DataType.JSON,
+    allowNull: true,
+  })
+  geofenceData: any; // Datos de geofencing (ciudades, zonas específicas)
+
+  @Column({
+    type: DataType.JSON,
+    allowNull: true,
+  })
+  dayOfWeekRestrictions: number[]; // Días de la semana aplicables (0=domingo, 6=sábado)
+
+  @Column({
+    type: DataType.TIME,
+    allowNull: true,
+  })
+  validFromTime: string; // Hora de inicio de validez diaria
+
+  @Column({
+    type: DataType.TIME,
+    allowNull: true,
+  })
+  validUntilTime: string; // Hora de fin de validez diaria
+
+  @Column({
+    type: DataType.UUID,
+    allowNull: true,
+  })
+  createdByAdminId: string; // ID del admin que creó el cupón
+
+  @Column({
+    type: DataType.BOOLEAN,
+    defaultValue: false,
+  })
+  isAutoApplicable: boolean; // Si se aplica automáticamente
+
+  @Column({
+    type: DataType.JSON,
+    allowNull: true,
+  })
+  metadata: any; // Información adicional del cupón
+
+  // Associations
+  @HasMany(() => CouponUsage, "couponId")
+  usages: CouponUsage[];
+
+  @HasMany(() => CouponUserMapping, "couponId")
+  userMappings: CouponUserMapping[];
+}

package/src/entities/coupon_usages.entity.ts

@@ -0,0 +1,108 @@
+// =============================================
+// COUPON USAGE MODEL
+// =============================================
+
+import {
+  BelongsTo,
+  Column,
+  DataType,
+  ForeignKey,
+  Model,
+  Table,
+} from "sequelize-typescript";
+import { Coupon } from "./coupon.entity";
+import { User } from "./user.entity";
+import { Trip } from "./trips.entity";
+import { UsageStatus } from "../enums";
+
+@Table({
+  tableName: "coupon_usages",
+  timestamps: true,
+})
+export class CouponUsage extends Model<CouponUsage> {
+  @Column({
+    type: DataType.UUID,
+    defaultValue: DataType.UUIDV4,
+    primaryKey: true,
+  })
+  declare id: string;
+
+  @ForeignKey(() => Coupon)
+  @Column({
+    type: DataType.UUID,
+    allowNull: false,
+  })
+  couponId: string;
+
+  @ForeignKey(() => User)
+  @Column({
+    type: DataType.UUID,
+    allowNull: false,
+  })
+  userId: string;
+
+  @ForeignKey(() => Trip)
+  @Column({
+    type: DataType.UUID,
+    allowNull: false,
+  })
+  tripId: string;
+
+  @Column({
+    type: DataType.DECIMAL(10, 2),
+    allowNull: false,
+  })
+  originalAmount: number; // Monto original del viaje
+
+  @Column({
+    type: DataType.DECIMAL(10, 2),
+    allowNull: false,
+  })
+  discountAmount: number; // Monto del descuento aplicado
+
+  @Column({
+    type: DataType.DECIMAL(10, 2),
+    allowNull: false,
+  })
+  finalAmount: number; // Monto final después del descuento
+
+  @Column({
+    type: DataType.ENUM(...Object.values(UsageStatus)),
+    defaultValue: UsageStatus.APPLIED,
+  })
+  status: UsageStatus;
+
+  @Column({
+    type: DataType.DATE,
+    allowNull: true,
+  })
+  redeemedAt: Date;
+
+  @Column({
+    type: DataType.DATE,
+    allowNull: true,
+  })
+  reversedAt: Date;
+
+  @Column({
+    type: DataType.STRING,
+    allowNull: true,
+  })
+  reversalReason: string;
+
+  @Column({
+    type: DataType.JSON,
+    allowNull: true,
+  })
+  metadata: any; // Información adicional del uso
+
+  // Associations
+  @BelongsTo(() => Coupon)
+  coupon: Coupon;
+
+  @BelongsTo(() => User)
+  user: User;
+
+  @BelongsTo(() => Trip)
+  trip: Trip;
+}

package/src/entities/coupon_user_mappings.entity.ts

@@ -0,0 +1,89 @@
+// =============================================
+// COUPON USER MAPPING MODEL
+// =============================================
+
+import {
+  BelongsTo,
+  Column,
+  DataType,
+  ForeignKey,
+  Index,
+  Model,
+  Table,
+} from 'sequelize-typescript';
+import { Coupon } from './coupon.entity';
+import { User } from './user.entity';
+
+@Table({
+  tableName: 'coupon_user_mappings',
+  timestamps: true,
+})
+export class CouponUserMapping extends Model {
+  @Column({
+    type: DataType.UUID,
+    defaultValue: DataType.UUIDV4,
+    primaryKey: true,
+  })
+  declare id: string;
+
+  @ForeignKey(() => Coupon)
+  @Column({
+    type: DataType.UUID,
+    allowNull: false,
+  })
+  couponId: string;
+
+  @ForeignKey(() => User)
+  @Column({
+    type: DataType.UUID,
+    allowNull: false,
+  })
+  userId: string;
+
+  @Column({
+    type: DataType.INTEGER,
+    defaultValue: 0,
+  })
+  usageCount: number; // Cuántas veces ha usado este cupón el usuario
+
+  @Column({
+    type: DataType.DATE,
+    allowNull: true,
+  })
+  firstUsedAt: Date;
+
+  @Column({
+    type: DataType.DATE,
+    allowNull: true,
+  })
+  lastUsedAt: Date;
+
+  @Column({
+    type: DataType.BOOLEAN,
+    defaultValue: true,
+  })
+  isEligible: boolean; // Si el usuario es elegible para usar este cupón
+
+  @Column({
+    type: DataType.DATE,
+    allowNull: true,
+  })
+  assignedAt: Date; // Cuando se le asignó el cupón al usuario
+
+  @Column({
+    type: DataType.UUID,
+    allowNull: true,
+  })
+  assignedByAdminId: string;
+
+  // Associations
+  @BelongsTo(() => Coupon)
+  coupon: Coupon;
+
+  @BelongsTo(() => User)
+  user: User;
+
+  // Unique constraint
+  @Index({ unique: true })
+  static couponUserIndex = ['couponId', 'userId'];
+}

package/src/entities/driver.entity.ts

@@ -0,0 +1,151 @@
+import {
+  BelongsTo,
+  Column,
+  DataType,
+  DeletedAt,
+  ForeignKey,
+  HasMany,
+  Model,
+  Table,
+} from "sequelize-typescript";
+import { User } from "./user.entity";
+import { Vehicle } from "./vehicle.entity";
+import { DriverStatus } from "../enums";
+
+// =============================================
+// DRIVER PROFILE MODEL - ACTUALIZADO
+// =============================================
+
+// Interfaz para crear un driver (campos requeridos)
+export interface DriverCreationAttributes {
+  userId: string;
+  licenseNumber: string;
+  licenseExpiryDate: Date;
+  licenseDocument?: string;
+  status?: DriverStatus;
+  rating?: number;
+  totalTrips?: number;
+  totalEarnings?: number;
+  isDocumentVerified?: boolean;
+  isBackgroundCheckPassed?: boolean;
+  currentLatitude?: number;
+  currentLongitude?: number;
+  currentLocation?: any; // PostGIS geometry
+  lastLocationUpdate?: Date;
+}
+
+@Table({
+  tableName: "driver_profiles",
+  timestamps: true,
+  paranoid: true, // Habilita soft delete
+})
+export class DriverProfile extends Model<
+  DriverProfile,
+  DriverCreationAttributes
+> {
+  @Column({
+    type: DataType.UUID,
+    defaultValue: DataType.UUIDV4,
+    primaryKey: true,
+  })
+  declare id: string;
+
+  @ForeignKey(() => User)
+  @Column({
+    type: DataType.UUID,
+    allowNull: false,
+    unique: true,
+  })
+  userId: string;
+
+  @Column({
+    type: DataType.STRING,
+    allowNull: false,
+    unique: true,
+  })
+  licenseNumber: string;
+
+  @Column({
+    type: DataType.DATE,
+    allowNull: false,
+  })
+  licenseExpiryDate: Date;
+
+  @Column({
+    type: DataType.STRING,
+    allowNull: true,
+  })
+  licenseDocument: string;
+
+  @Column({
+    type: DataType.ENUM(...Object.values(DriverStatus)),
+    defaultValue: DriverStatus.OFFLINE,
+  })
+  status: DriverStatus;
+
+  @Column({
+    type: DataType.DECIMAL(3, 2),
+    defaultValue: 0.0,
+  })
+  rating: number;
+
+  @Column({
+    type: DataType.INTEGER,
+    defaultValue: 0,
+  })
+  totalTrips: number;
+
+  @Column({
+    type: DataType.DECIMAL(10, 2),
+    defaultValue: 0.0,
+  })
+  totalEarnings: number;
+
+  @Column({
+    type: DataType.BOOLEAN,
+    defaultValue: false,
+  })
+  isDocumentVerified: boolean;
+
+  @Column({
+    type: DataType.BOOLEAN,
+    defaultValue: false,
+  })
+  isBackgroundCheckPassed: boolean;
+
+  @Column({
+    type: DataType.DATE,
+    allowNull: true,
+  })
+  lastLocationUpdate: Date;
+
+  // ACTUALIZADO: Usar GEOMETRY POINT para PostgreSQL
+  @Column({
+    type: DataType.GEOMETRY("POINT", 4326), // SRID 4326 (WGS84)
+    allowNull: true,
+  })
+  currentLocation: any; // Almacena POINT(longitude, latitude)
+
+  // OPCIONAL: Mantener campos individuales si necesitas consultas simples
+  @Column({
+    type: DataType.DOUBLE,
+    allowNull: true,
+  })
+  currentLatitude: number;
+
+  @Column({
+    type: DataType.DOUBLE,
+    allowNull: true,
+  })
+  currentLongitude: number;
+
+  @DeletedAt
+  declare deletedAt: Date;
+
+  // Associations
+  @BelongsTo(() => User)
+  user: User;
+
+  @HasMany(() => Vehicle, "driverId")
+  vehicles: Vehicle[];
+}

package/src/entities/farerates.entity.ts

@@ -0,0 +1,72 @@
+// =============================================
+// FARE RATE MODEL
+// =============================================
+
+import { Column, DataType, Model, Table } from 'sequelize-typescript';
+
+@Table({
+  tableName: 'fare_rates',
+  timestamps: true,
+})
+export class FareRate extends Model<FareRate> {
+  @Column({
+    type: DataType.UUID,
+    defaultValue: DataType.UUIDV4,
+    primaryKey: true,
+  })
+  declare id: string;
+
+  @Column({
+    type: DataType.STRING,
+    allowNull: false,
+  })
+  vehicleType: string;
+
+  @Column({
+    type: DataType.DECIMAL(8, 2),
+    allowNull: false,
+  })
+  baseFare: number;
+
+  @Column({
+    type: DataType.DECIMAL(8, 2),
+    allowNull: false,
+  })
+  perKilometerRate: number;
+
+  @Column({
+    type: DataType.DECIMAL(8, 2),
+    allowNull: false,
+  })
+  perMinuteRate: number;
+
+  @Column({
+    type: DataType.DECIMAL(8, 2),
+    allowNull: false,
+  })
+  minimumFare: number;
+
+  @Column({
+    type: DataType.DECIMAL(5, 2),
+    defaultValue: 1.0,
+  })
+  surgePricing: number; // multiplier for surge pricing
+
+  @Column({
+    type: DataType.BOOLEAN,
+    defaultValue: true,
+  })
+  isActive: boolean;
+
+  @Column({
+    type: DataType.DATE,
+    allowNull: true,
+  })
+  effectiveFrom: Date;
+
+  @Column({
+    type: DataType.DATE,
+    allowNull: true,
+  })
+  effectiveTo: Date;
+}