feat: enhance lifecycle history retrieval with optional reference ID population

- Introduced a new `populateRefId` option in the `getLifecycleHistory` method to conditionally include reference ID population in the response.
- Updated the controller to parse the `populateRefId` query parameter and pass it to the service method.
- Refactored the lifecycle history component to improve layout and user experience, including a new dialog for lifecycle event details.

Author: tacxou

apps/api/src/management/lifecycle/lifecycle-crud.service.ts

@@ -6,6 +6,10 @@ import { Lifecycle, LifecycleRefId } from './_schemas/lifecycle.schema'
 import { loadCustomStates } from './_functions/load-custom-states.function'
 import { AbstractLifecycleService } from './_abstracts/abstract.lifecycle.service'
 
+type LifecycleHistoryOptions = FilterOptions & {
+  populateRefId?: boolean
+}
+
 /**
  * Service CRUD de gestion du cycle de vie des identités
  *
@@ -201,10 +205,11 @@ export class LifecycleCrudService extends AbstractLifecycleService {
    */
   public async getLifecycleHistory(
     refId: Types.ObjectId,
-    options?: FilterOptions,
+    options?: LifecycleHistoryOptions,
   ): Promise<[number, Query<Array<Lifecycle>, Lifecycle, any, Lifecycle>[]]> {
+    const shouldPopulateRefId = options?.populateRefId !== false
     const result = await this.find<Lifecycle>({ refId }, null, {
-      populate: LifecycleRefId,
+      ...(shouldPopulateRefId ? { populate: LifecycleRefId } : {}),
       sort: {
         ...options?.sort,
         createdAt: -1,

apps/api/src/management/lifecycle/lifecycle.controller.ts

@@ -99,8 +99,13 @@ export class LifecycleController extends AbstractController {
     @Param('identityId', ObjectIdValidationPipe) identityId: Types.ObjectId,
     @Res() res: Response,
     @SearchFilterOptions() searchFilterOptions: FilterOptions,
+    @Query('populateRefId') populateRefId?: string,
   ): Promise<Response<Lifecycle[]>> {
-    const [total, data] = await this._service.getLifecycleHistory(identityId, searchFilterOptions)
+    const populateRefIdEnabled = /true|1|yes|on/i.test(populateRefId)
+    const [total, data] = await this._service.getLifecycleHistory(identityId, {
+      ...searchFilterOptions,
+      populateRefId: populateRefIdEnabled,
+    })
 
     return res.status(HttpStatus.OK).json({
       statusCode: HttpStatus.OK,