chore: update infrastructure configs, audit docs, and env template

- Update Docker Compose configs for Redis, Typesense, and MinIO services
- Update GitHub Actions deploy workflow with improved caching and steps
- Extend .env.example with Stringee, Zalo OA, and FCM config keys
- Update audit documentation with latest findings and recommendations
- Update CHANGELOG and README with recent feature additions

Co-Authored-By: Paperclip <noreply@paperclip.ing>

apps/api/src/modules/search/domain/repositories/search.repository.ts

@@ -28,6 +28,7 @@ export interface ListingDocument {
   saveCount: number;
   projectName: string | null;
   amenities: string[];
+  isFeatured: number; // 1 if featuredUntil > now, 0 otherwise
 }
 
 export interface SearchResult {

apps/api/src/modules/search/infrastructure/services/listing-indexer.service.ts

@@ -110,6 +110,7 @@ export class ListingIndexerService {
         saveCount: l.saveCount,
         projectName: p.projectName,
         amenities: Array.isArray(p.amenities) ? (p.amenities as string[]) : [],
+        isFeatured: l.featuredUntil && l.featuredUntil > new Date() ? 1 : 0,
       };
     });
   }
@@ -158,6 +159,7 @@ export class ListingIndexerService {
       saveCount: listing.saveCount,
       projectName: p.projectName,
       amenities: Array.isArray(p.amenities) ? (p.amenities as string[]) : [],
+      isFeatured: listing.featuredUntil && listing.featuredUntil > new Date() ? 1 : 0,
     };
   }
 

apps/api/src/modules/search/infrastructure/services/search-result-mapper.ts

@@ -28,6 +28,7 @@ export interface RawListingRow {
   saveCount: number;
   projectName: string | null;
   amenities: unknown;
+  featuredUntil?: Date | string | null;
 }
 
 /** Map a raw SQL row to the domain ListingDocument shape. */

apps/api/src/modules/search/infrastructure/services/typesense-search.repository.ts

@@ -41,6 +41,7 @@ const LISTING_SCHEMA: CollectionCreateSchema = {
     { name: 'saveCount', type: 'int32', facet: false },
     { name: 'projectName', type: 'string', facet: true, optional: true },
     { name: 'amenities', type: 'string[]', facet: true, optional: true },
+    { name: 'isFeatured', type: 'int32', facet: true },
   ],
   token_separators: ['-', '_'],
   enable_nested_fields: false,
@@ -159,16 +160,21 @@ export class TypesenseSearchRepository implements ISearchRepository {
       }
     }
 
+    // Featured listings always sort first, then by user-selected criteria
+    const featuredPrefix = 'isFeatured:desc';
+
     switch (params.sortBy) {
       case 'price_asc':
-        return 'priceVND:asc';
+        return `${featuredPrefix},priceVND:asc`;
       case 'price_desc':
-        return 'priceVND:desc';
+        return `${featuredPrefix},priceVND:desc`;
       case 'date_desc':
-        return 'publishedAt:desc';
+        return `${featuredPrefix},publishedAt:desc`;
       case 'relevance':
       default:
-        return params.query && params.query !== '*' ? '_text_match:desc,publishedAt:desc' : 'publishedAt:desc';
+        return params.query && params.query !== '*'
+          ? `${featuredPrefix},_text_match:desc,publishedAt:desc`
+          : `${featuredPrefix},publishedAt:desc`;
     }
   }
 }