feat: implement admin settings module with full CRUD functionality and integrate application configuration.

Author: beginwebdev2002

backend/package-lock.json

@@ -26,6 +26,7 @@
     "@nestjs/mapped-types": "^2.1.0",
     "@nestjs/mongoose": "^11.0.4",
     "@nestjs/platform-express": "^11.0.1",
+    "axios": "^1.13.4",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.3",
     "mongoose": "^9.1.6",

backend/package.json

@@ -13,7 +13,7 @@ export class AdminSettingsService {
   }
 
   async updateSettings(
-    settings: Omit<AdminSettings, 'id'>,
+    settings: Partial<AdminSettings>,
   ): Promise<AdminSettings> {
     return this.adminSettingsRepository.updateSettings(settings);
   }
@@ -23,4 +23,8 @@ export class AdminSettingsService {
   ): Promise<AdminSettings> {
     return this.adminSettingsRepository.createSettings(settings);
   }
+
+  async deleteSettings(): Promise<boolean> {
+    return this.adminSettingsRepository.deleteSettings();
+  }
 }

backend/src/admin-settings/application/admin-settings.service.ts

@@ -1,16 +1,15 @@
-export class AdminSettings {
+import {
+  IAdminLocation,
+  IAdminSettings,
+  IOwnerInfo,
+} from './interfaces/admin-settings.interface';
+
+export class AdminSettings implements IAdminSettings {
   constructor(
     public readonly id: string,
-    public readonly location: {
-      address: string;
-      latitude: number;
-      longitude: number;
-    },
-    public readonly socialLinks: Map<string, string>,
-    public readonly workHours: Map<string, string>, // e.g., 'Mon': '09:00-18:00'
-    public readonly ownerInfo: {
-      name: string;
-      phoneNumber: string;
-    },
+    public readonly location: IAdminLocation,
+    public readonly socialLinks: Record<string, string>,
+    public readonly workHours: Record<string, string>,
+    public readonly ownerInfo: IOwnerInfo,
   ) {}
 }

backend/src/admin-settings/domain/admin-settings.entity.ts

@@ -0,0 +1,18 @@
+export interface IAdminLocation {
+  address: string;
+  latitude: number;
+  longitude: number;
+}
+
+export interface IOwnerInfo {
+  name: string;
+  phoneNumber: string;
+}
+
+export interface IAdminSettings {
+  id: string;
+  location: IAdminLocation;
+  socialLinks: Record<string, string>;
+  workHours: Record<string, string>;
+  ownerInfo: IOwnerInfo;
+}

backend/src/admin-settings/domain/interfaces/admin-settings.interface.ts

@@ -20,28 +20,39 @@ export class AdminSettingsRepository {
   }
 
   async updateSettings(
-    settings: Omit<AdminSettings, 'id'>,
+    settings: Partial<AdminSettings>,
   ): Promise<AdminSettings> {
-    const doc = await this.settingsModel.findOneAndUpdate(
-      {},
-      { $set: settings },
-      { new: true, upsert: true },
-    );
+    const doc = await this.settingsModel
+      .findOneAndUpdate({}, { $set: settings }, { new: true, upsert: true })
+      .exec();
     return this.toDomain(doc);
   }
+
   async createSettings(
     settings: Omit<AdminSettings, 'id'>,
   ): Promise<AdminSettings> {
     const doc = await this.settingsModel.create(settings);
     return this.toDomain(doc);
   }
 
+  async deleteSettings(): Promise<boolean> {
+    const result = await this.settingsModel.deleteOne({}).exec();
+    return result.deletedCount > 0;
+  }
+
   private toDomain(doc: AdminSettingsDocument): AdminSettings {
+    const socialLinks = doc.socialLinks
+      ? (Object.fromEntries(doc.socialLinks) as Record<string, string>)
+      : {};
+    const workHours = doc.workHours
+      ? (Object.fromEntries(doc.workHours) as Record<string, string>)
+      : {};
+
     return new AdminSettings(
       doc._id.toString(),
       doc.location,
-      doc.socialLinks,
-      doc.workHours,
+      socialLinks,
+      workHours,
       doc.ownerInfo,
     );
   }

backend/src/admin-settings/infrastructure/repositories/admin-settings.repository.ts

@@ -5,6 +5,9 @@ export type AdminSettingsDocument = HydratedDocument<AdminSettingsSchemaEntity>;
 
 @Schema({ collection: 'admin_settings', timestamps: true })
 export class AdminSettingsSchemaEntity {
+  @Prop({ type: String, default: process.env.SETTINGS_ID })
+  _id: string;
+
   @Prop({ type: Object, required: true })
   location: {
     address: string;

backend/src/admin-settings/infrastructure/schemas/admin-settings.schema.ts

@@ -1,4 +1,4 @@
-import { Controller, Get, Body, Put, Post } from '@nestjs/common';
+import { Controller, Get, Body, Put, Post, Delete } from '@nestjs/common';
 import { AdminSettingsService } from '../application/admin-settings.service';
 import { AdminSettings } from '../domain/admin-settings.entity';
 import { UpdateAdminSettingsDto } from './dto/update-admin-settings.dto';
@@ -17,40 +17,28 @@ export class AdminSettingsController {
   async createSettings(
     @Body() createAdminSettingsDto: CreateAdminSettingsDto,
   ): Promise<AdminSettings> {
-    const settings = {
-      ...createAdminSettingsDto,
-      socialLinks: createAdminSettingsDto.socialLinks
-        ? new Map(Object.entries(createAdminSettingsDto.socialLinks))
-        : new Map(),
-      workHours: createAdminSettingsDto.workHours
-        ? new Map(Object.entries(createAdminSettingsDto.workHours))
-        : new Map(),
-    } as unknown as Omit<AdminSettings, 'id'>;
-
-    return this.adminSettingsService.createSettings(settings);
+    // Cast to unknown then Omit to satisfy the compiler because DTO technically doesn't have 'id'
+    // but the service expects Omit<AdminSettings, 'id'> which matches the structure of the DTO
+    return this.adminSettingsService.createSettings(
+      createAdminSettingsDto as unknown as Omit<AdminSettings, 'id'>,
+    );
   }
 
   @Put()
   async updateSettings(
     @Body() updateAdminSettingsDto: UpdateAdminSettingsDto,
   ): Promise<AdminSettings> {
-    const settings = {
-      ...updateAdminSettingsDto,
-      socialLinks: updateAdminSettingsDto.socialLinks
-        ? new Map(Object.entries(updateAdminSettingsDto.socialLinks))
-        : undefined,
-      workHours: updateAdminSettingsDto.workHours
-        ? new Map(Object.entries(updateAdminSettingsDto.workHours))
-        : undefined,
-    };
-
-    // Remove undefined keys to avoid overriding with undefined
+    // Clean up undefined values
+    const settings = { ...updateAdminSettingsDto };
     Object.keys(settings).forEach(
       (key) => settings[key] === undefined && delete settings[key],
     );
 
-    return this.adminSettingsService.updateSettings(
-      settings as unknown as Omit<AdminSettings, 'id'>,
-    );
+    return this.adminSettingsService.updateSettings(settings);
+  }
+
+  @Delete()
+  async deleteSettings(): Promise<boolean> {
+    return this.adminSettingsService.deleteSettings();
   }
 }

backend/src/admin-settings/presentation/admin-settings.controller.ts

@@ -7,8 +7,12 @@ import {
   ValidateNested,
   IsObject,
 } from 'class-validator';
+import {
+  IAdminLocation,
+  IOwnerInfo,
+} from '../../domain/interfaces/admin-settings.interface';
 
-class LocationDto {
+class LocationDto implements IAdminLocation {
   @IsString()
   @IsNotEmpty()
   address: string;
@@ -20,7 +24,7 @@ class LocationDto {
   longitude: number;
 }
 
-class OwnerInfoDto {
+class OwnerInfoDto implements IOwnerInfo {
   @IsString()
   @IsNotEmpty()
   name: string;

backend/src/admin-settings/presentation/dto/create-admin-settings.dto.ts

@@ -85,4 +85,7 @@ export class AppConfigService {
       ''
     );
   }
+  get settingsId(): string {
+    return this.configService.get<string>('SETTINGS_ID', { infer: true }) ?? '';
+  }
 }