Enhance lifecycle state management: add icon and color properties to states, implement updateLifecycle method in service, and update DTOs accordingly

Author: tacxou

defaults/lifecycle/states.yml

@@ -4,21 +4,25 @@ states:
     label: "En Attente"
     description: "supannRessourceEtat : {COMPTE} A SupannAnticipe"
     icon: "mdi-account-clock"
+    color: "#f0ad4e"
 
   # PROV -> supannResourceEtat : {COMPTE} A SupannSursis et supannRessourceEtatDate: Date de passage en PROV
   - key: P
     label: "Provisoire"
     description: "supannResourceEtat : {COMPTE} A SupannSursis et supannRessourceEtatDate: Date de passage en PROV"
     icon: "mdi-account-alert"
+    color: "#5bc0de"
 
   # A Détruire -> supannRessourceEtat : {COMPTE} I SupannSupprCompte
   - key: D
     label: "A Détruire"
     description: "supannRessourceEtat : {COMPTE} I SupannSupprCompte"
     icon: "mdi-account-remove"
+    color: "#d9534f"
 
   # Verrouillé -> supannRessourceEtat : {COMPTE} S SupannVerrouille
   - key: V
     label: "Verrouillé"
     description: "supannRessourceEtat : {COMPTE} S SupannVerrouille"
     icon: "mdi-account-lock"
+    color: "#292b2c"

src/management/identities/identities-crud.controller.ts

@@ -264,6 +264,25 @@ export class IdentitiesCrudController extends AbstractController {
     });
   }
 
+  @Patch(':_id([0-9a-fA-F]{24})/lifecycle')
+  @ApiParam({ name: '_id', type: String })
+  @ApiUpdateDecorator(IdentitiesUpdateDto, IdentitiesDto)
+  public async updateLifecycle(
+    @Param('_id', ObjectIdValidationPipe) _id: Types.ObjectId,
+    @Body() body: IdentitiesUpdateDto,
+    @Res() res: Response,
+  ): Promise<Response> {
+    const identity = await this._service.findById<Identities>(_id);
+    if (!identity) {
+      throw new BadRequestException('Identity not found');
+    }
+    const data = await this._service.updateLifecycle(_id, body.lifecycle);
+    return res.status(HttpStatus.OK).json({
+      statusCode: HttpStatus.OK,
+      data,
+    });
+  }
+
   @Patch('state')
   @ApiOperation({ summary: "Met à jour l'état d'une ou plusieurs <Identitées> en masse" })
   public async updateStateMany(

src/management/identities/identities-crud.service.ts

@@ -6,6 +6,7 @@ import { IdentityState } from '~/management/identities/_enums/states.enum';
 import { Identities } from '~/management/identities/_schemas/identities.schema';
 import { BadRequestException, HttpException } from '@nestjs/common';
 import { CountOptions } from 'mongodb';
+import { IdentityLifecycleDefault, IdentityLifecycleState } from './_enums/lifecycle.enum';
 
 export const COUNT_ALL_MAX_ITERATIONS = 500;
 
@@ -128,6 +129,15 @@ export class IdentitiesCrudService extends AbstractIdentitiesService {
     return await this.generateFingerprint(updated as unknown as Identities);
   }
 
+  public async updateLifecycle<T extends AbstractSchema | Document>(
+    _id: Types.ObjectId | any,
+    lifecycle: IdentityLifecycleDefault | string,
+    options?: QueryOptions<T> & { rawResult: true },
+  ): Promise<ModifyResult<Query<T, T, any, T>>> {
+    const updated = await super.update(_id, { lifecycle }, options);
+    return updated;
+  }
+
   public async updateState<T extends AbstractSchema | Document>(
     _id: Types.ObjectId | any,
     state: IdentityState,
@@ -136,6 +146,7 @@ export class IdentitiesCrudService extends AbstractIdentitiesService {
     const updated = await super.update(_id, { state }, options);
     return updated;
   }
+
   public async updateStateMany<T extends AbstractSchema | Document>(body: {
     ids: Types.ObjectId[];
     targetState: IdentityState;

src/management/lifecycle/_dto/config-states.dto.ts

@@ -47,6 +47,16 @@ export class LifecycleStateDTO {
     required: false,
   })
   public icon?: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty({
+    type: String,
+    description: 'Couleur associée à l\'état (optionnel, en hexadécimal)',
+    example: '#f0ad4e',
+    required: false,
+  })
+  public color?: string;
 }
 
 /**