feat: customer groups for people and companies with tahesab group sync and bulk register

Multiple groups per contact, legacy group text migrated, excel import/export, contacts filter and column, richer create-in-tahesab, match-first bulk export

apps/api/src/contacts/dto.ts

@@ -86,6 +86,12 @@ export class ListQueryDto {
   @IsString()
   @MaxLength(12)
   disc?: string;
+
+  /** فیلتر گروه مشتری */
+  @IsOptional()
+  @IsString()
+  @MaxLength(40)
+  groupId?: string;
 }
 
 class CompanyExtraFieldsDto {
@@ -153,6 +159,11 @@ class CompanyExtraFieldsDto {
   @ValidateIf((_, v) => v !== '' && v != null)
   @IsString()
   registeredAt?: string | null;
+
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  groupIds?: string[];
 }
 
 export class CreateCompanyDto extends CompanyExtraFieldsDto {
@@ -370,6 +381,11 @@ export class CreatePersonDto {
   @IsOptional()
   @IsString()
   registeredAt?: string | null;
+
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  groupIds?: string[];
 }
 
 export class UpdatePersonDto {
@@ -478,4 +494,9 @@ export class UpdatePersonDto {
   @ValidateIf((_, v) => v !== '' && v != null)
   @IsString()
   ownerId?: string | null;
+
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  groupIds?: string[];
 }