@grapadigital/shared-schemas 1.0.197 → 1.0.199

package/dist/schemas/client.schema.d.ts

@@ -122,7 +122,14 @@ export declare class Client extends Party {
      * time já resolve (padrão da maioria dos clientes). Ver GD-532/GD-535.
      */
     requiredTeams: string[];
-    hasReport: boolean;
+    /**
+     * Análise GenIA: captura de comentários, classificação por IA e tudo que
+     * depende deles (spam, taxa de engajamento qualificado, score, CPMI). Sem
+     * isso, os conteúdos do cliente só recebem as métricas base da Primetag.
+     * Também define quais clientes aparecem no hub de relatórios GenIA.
+     * (Antigo `hasReport`.)
+     */
+    hasGenIAAnalysis: boolean;
     reportResponsable?: Responsable;
 }
 export declare const ClientSchema: import("mongoose").Schema<Client, import("mongoose").Model<Client, any, any, any, import("mongoose").Document<unknown, any, Client, any, {}> & Client & Required<{

package/dist/schemas/client.schema.js

@@ -164,7 +164,7 @@ __decorate([
 __decorate([
     (0, mongoose_1.Prop)({ type: Boolean, default: false }),
     __metadata("design:type", Boolean)
-], Client.prototype, "hasReport", void 0);
+], Client.prototype, "hasGenIAAnalysis", void 0);
 __decorate([
     (0, mongoose_1.Prop)({ type: exports.ResponsableSchema, required: false }),
     __metadata("design:type", Responsable)

package/dist/schemas/comment.schema.d.ts

@@ -33,6 +33,37 @@ export declare const COMMENT_SUBJECT_VALUES: readonly ["compliment_to_person", "
 export type CommentSubject = (typeof COMMENT_SUBJECT_VALUES)[number];
 export declare const COMMENT_CLASSIFICATION_STATUS_VALUES: readonly ["pending", "processing", "completed", "failed", "not_applicable"];
 export type CommentClassificationStatus = (typeof COMMENT_CLASSIFICATION_STATUS_VALUES)[number];
+export declare const COMMENT_SPAM_RULE_VALUES: readonly ["duplicate_text", "repeat_author", "manual", "unknown"];
+export type CommentSpamRule = (typeof COMMENT_SPAM_RULE_VALUES)[number];
+export declare class CommentSpamReason {
+    rule: CommentSpamRule;
+    threshold?: number;
+    matchCount?: number;
+    groupKey?: string;
+}
+export declare const CommentSpamReasonSchema: MongooseSchema<CommentSpamReason, import("mongoose").Model<CommentSpamReason, any, any, any, import("mongoose").Document<unknown, any, CommentSpamReason, any, {}> & CommentSpamReason & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, CommentSpamReason, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<CommentSpamReason>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<CommentSpamReason> & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}>;
+export declare class CommentClassifiedBy {
+    team?: string;
+    name?: string;
+    email?: string;
+}
+export declare const CommentClassifiedBySchema: MongooseSchema<CommentClassifiedBy, import("mongoose").Model<CommentClassifiedBy, any, any, any, import("mongoose").Document<unknown, any, CommentClassifiedBy, any, {}> & CommentClassifiedBy & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, CommentClassifiedBy, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<CommentClassifiedBy>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<CommentClassifiedBy> & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}>;
 export declare class Comment {
     _id?: Types.ObjectId;
     content: Types.ObjectId | Content;
@@ -52,6 +83,11 @@ export declare class Comment {
     funnel?: 'awareness' | 'consideration' | 'conversion' | 'none' | null;
     isEmojiOnly?: boolean;
     isSpam?: boolean;
+    spamReason?: CommentSpamReason | null;
+    spamOverride?: boolean;
+    isManuallyClassified?: boolean;
+    manuallyClassifiedAt?: Date | null;
+    manuallyClassifiedBy?: CommentClassifiedBy | null;
     classificationStatus?: CommentClassificationStatus;
     classificationError?: string | null;
     classificationProcessedAt?: Date | null;

package/dist/schemas/comment.schema.js

@@ -9,7 +9,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommentModel = exports.CommentSchema = exports.Comment = exports.COMMENT_CLASSIFICATION_STATUS_VALUES = exports.COMMENT_SUBJECT_VALUES = exports.COMMENT_TARGET_VALUES = void 0;
+exports.CommentModel = exports.CommentSchema = exports.Comment = exports.CommentClassifiedBySchema = exports.CommentClassifiedBy = exports.CommentSpamReasonSchema = exports.CommentSpamReason = exports.COMMENT_SPAM_RULE_VALUES = exports.COMMENT_CLASSIFICATION_STATUS_VALUES = exports.COMMENT_SUBJECT_VALUES = exports.COMMENT_TARGET_VALUES = void 0;
 const mongoose_1 = require("@nestjs/mongoose");
 const mongoose_2 = require("mongoose");
 exports.COMMENT_TARGET_VALUES = ['brand', 'influencer', 'content', 'emoji', 'spam'];
@@ -37,6 +37,52 @@ exports.COMMENT_CLASSIFICATION_STATUS_VALUES = [
     'failed',
     'not_applicable',
 ];
+exports.COMMENT_SPAM_RULE_VALUES = ['duplicate_text', 'repeat_author', 'manual', 'unknown'];
+// Por que o comentário foi marcado como spam. `groupKey` identifica os outros
+// comentários do mesmo conteúdo que caíram na mesma regra: autor normalizado
+// (repeat_author) ou `autor::texto` normalizado (duplicate_text).
+let CommentSpamReason = class CommentSpamReason {
+};
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, enum: exports.COMMENT_SPAM_RULE_VALUES, required: true }),
+    __metadata("design:type", String)
+], CommentSpamReason.prototype, "rule", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false }),
+    __metadata("design:type", Number)
+], CommentSpamReason.prototype, "threshold", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false }),
+    __metadata("design:type", Number)
+], CommentSpamReason.prototype, "matchCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, required: false }),
+    __metadata("design:type", String)
+], CommentSpamReason.prototype, "groupKey", void 0);
+CommentSpamReason = __decorate([
+    (0, mongoose_1.Schema)({ _id: false })
+], CommentSpamReason);
+exports.CommentSpamReason = CommentSpamReason;
+exports.CommentSpamReasonSchema = mongoose_1.SchemaFactory.createForClass(CommentSpamReason);
+let CommentClassifiedBy = class CommentClassifiedBy {
+};
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, required: false }),
+    __metadata("design:type", String)
+], CommentClassifiedBy.prototype, "team", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, required: false }),
+    __metadata("design:type", String)
+], CommentClassifiedBy.prototype, "name", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, required: false }),
+    __metadata("design:type", String)
+], CommentClassifiedBy.prototype, "email", void 0);
+CommentClassifiedBy = __decorate([
+    (0, mongoose_1.Schema)({ _id: false })
+], CommentClassifiedBy);
+exports.CommentClassifiedBy = CommentClassifiedBy;
+exports.CommentClassifiedBySchema = mongoose_1.SchemaFactory.createForClass(CommentClassifiedBy);
 let Comment = class Comment {
 };
 __decorate([
@@ -131,6 +177,26 @@ __decorate([
     (0, mongoose_1.Prop)({ type: Boolean, required: false, default: false }),
     __metadata("design:type", Boolean)
 ], Comment.prototype, "isSpam", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: exports.CommentSpamReasonSchema, required: false, default: null }),
+    __metadata("design:type", Object)
+], Comment.prototype, "spamReason", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Boolean, required: false, default: false }),
+    __metadata("design:type", Boolean)
+], Comment.prototype, "spamOverride", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Boolean, required: false, default: false }),
+    __metadata("design:type", Boolean)
+], Comment.prototype, "isManuallyClassified", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Date, required: false, default: null }),
+    __metadata("design:type", Object)
+], Comment.prototype, "manuallyClassifiedAt", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: exports.CommentClassifiedBySchema, required: false, default: null }),
+    __metadata("design:type", Object)
+], Comment.prototype, "manuallyClassifiedBy", void 0);
 __decorate([
     (0, mongoose_1.Prop)({
         type: String,
@@ -174,4 +240,5 @@ exports.CommentSchema.index({ action: 1, funnel: 1 });
 exports.CommentSchema.index({ action: 1, target: 1 });
 exports.CommentSchema.index({ content: 1, parent: 1 });
 exports.CommentSchema.index({ content: 1, classificationStatus: 1 });
+exports.CommentSchema.index({ content: 1, 'spamReason.groupKey': 1 });
 exports.CommentModel = (0, mongoose_2.model)('Comment', exports.CommentSchema);

package/dist/schemas/content-capture-process.schema.d.ts

@@ -60,7 +60,7 @@ export declare const ContentCaptureProcessInfluencerSchema: MongooseSchema<Conte
     __v: number;
 }>;
 export declare class ContentCaptureProcessCommentCaptureStatus {
-    status: 'captured' | 'skipped_cooldown' | 'skipped_network' | 'out_of_scope' | 'failed';
+    status: 'captured' | 'skipped_cooldown' | 'skipped_network' | 'skipped_no_comments' | 'out_of_scope' | 'failed';
     commentsCaptured?: number;
     error?: string;
 }

package/dist/schemas/content-capture-process.schema.js

@@ -75,7 +75,7 @@ let ContentCaptureProcessCommentCaptureStatus = class ContentCaptureProcessComme
 __decorate([
     (0, mongoose_1.Prop)({
         type: String,
-        enum: ['captured', 'skipped_cooldown', 'skipped_network', 'out_of_scope', 'failed'],
+        enum: ['captured', 'skipped_cooldown', 'skipped_network', 'skipped_no_comments', 'out_of_scope', 'failed'],
         required: true,
     }),
     __metadata("design:type", String)

package/dist/schemas/content.schema.d.ts

@@ -97,6 +97,11 @@ export declare class Metrics {
     tapBackCount?: number | null;
     clickCount?: number | null;
     replyCount?: number | null;
+    tapForwardCount?: number | null;
+    swipeForwardCount?: number | null;
+    exitCount?: number | null;
+    favoriteCount?: number | null;
+    dislikeCount?: number | null;
     emv?: number | null;
     engagementCount?: number | null;
     engagementRate?: number | null;
@@ -146,6 +151,25 @@ export declare const EstimatesSchema: MongooseSchema<Estimates, import("mongoose
 } & {
     __v: number;
 }>;
+export declare const CONTENT_STATUS_VALUES: readonly ["pending", "approved", "deleted", "processing", "classified", "error", "partial_error"];
+export type ContentStatus = (typeof CONTENT_STATUS_VALUES)[number];
+export declare const CONTENT_REPORTABLE_STATUS_VALUES: ContentStatus[];
+export declare const CONTENT_METRICS_SOURCE_VALUES: readonly ["real", "organic", "estimated"];
+export type ContentMetricsSource = (typeof CONTENT_METRICS_SOURCE_VALUES)[number];
+export declare class ContentStatusChangedBy {
+    team?: string;
+    name?: string;
+    email?: string;
+}
+export declare const ContentStatusChangedBySchema: MongooseSchema<ContentStatusChangedBy, import("mongoose").Model<ContentStatusChangedBy, any, any, any, import("mongoose").Document<unknown, any, ContentStatusChangedBy, any, {}> & ContentStatusChangedBy & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, ContentStatusChangedBy, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<ContentStatusChangedBy>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<ContentStatusChangedBy> & {
+    _id: Types.ObjectId;
+} & {
+    __v: number;
+}>;
 export declare class Content {
     _id?: Types.ObjectId;
     caption?: string;
@@ -153,7 +177,11 @@ export declare class Content {
     type: 'reel' | 'carousel' | 'image' | 'story' | 'video' | 'post' | 'pin' | 'tweet';
     tagType: 'withTag' | 'withoutTag' | 'brandExposure';
     socialnetwork: 'instagram' | 'tiktok' | 'youtube' | 'pinterest' | 'linkedin' | 'twitter';
-    status: 'approved' | 'repproved' | 'deleted';
+    status: ContentStatus;
+    metricsSource?: ContentMetricsSource | null;
+    processedCommentCount?: number | null;
+    approvedAt?: Date | null;
+    approvedBy?: ContentStatusChangedBy | null;
     profile: Types.ObjectId | Profile;
     action: Types.ObjectId | Action;
     postedAt: Date;

package/dist/schemas/content.schema.js

@@ -9,7 +9,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContentModel = exports.ContentSchema = exports.Content = exports.EstimatesSchema = exports.Estimates = exports.ContentMetricsHistoryEntrySchema = exports.ContentMetricsHistoryEntry = exports.MetricsSchema = exports.Metrics = exports.SentimentAnalysisSchema = exports.SentimentAnalysis = exports.SentimentScoreSchema = exports.SentimentScore = exports.WordCloudSchema = exports.WordCloud = exports.SentimentCommentSchema = exports.SentimentComment = void 0;
+exports.ContentModel = exports.ContentSchema = exports.Content = exports.ContentStatusChangedBySchema = exports.ContentStatusChangedBy = exports.CONTENT_METRICS_SOURCE_VALUES = exports.CONTENT_REPORTABLE_STATUS_VALUES = exports.CONTENT_STATUS_VALUES = exports.EstimatesSchema = exports.Estimates = exports.ContentMetricsHistoryEntrySchema = exports.ContentMetricsHistoryEntry = exports.MetricsSchema = exports.Metrics = exports.SentimentAnalysisSchema = exports.SentimentAnalysis = exports.SentimentScoreSchema = exports.SentimentScore = exports.WordCloudSchema = exports.WordCloud = exports.SentimentCommentSchema = exports.SentimentComment = void 0;
 const mongoose_1 = require("@nestjs/mongoose");
 const mongoose_2 = require("mongoose");
 let SentimentComment = class SentimentComment {
@@ -142,6 +142,26 @@ __decorate([
     (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
     __metadata("design:type", Object)
 ], Metrics.prototype, "replyCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], Metrics.prototype, "tapForwardCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], Metrics.prototype, "swipeForwardCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], Metrics.prototype, "exitCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], Metrics.prototype, "favoriteCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], Metrics.prototype, "dislikeCount", void 0);
 __decorate([
     (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
     __metadata("design:type", Object)
@@ -229,6 +249,48 @@ Estimates = __decorate([
 ], Estimates);
 exports.Estimates = Estimates;
 exports.EstimatesSchema = mongoose_1.SchemaFactory.createForClass(Estimates);
+// error: captura de comentários falhou ou a classificação falhou por inteiro.
+// partial_error: parte dos comentários não foi classificada. Nenhum dos dois
+// volta sozinho pro pipeline — só por reenvio manual (aprovação).
+exports.CONTENT_STATUS_VALUES = [
+    'pending',
+    'approved',
+    'deleted',
+    'processing',
+    'classified',
+    'error',
+    'partial_error',
+];
+// Status que entram em relatórios/KPIs (pending e deleted ficam de fora). error
+// e partial_error entram: as métricas da Primetag são válidas, só os
+// comentários ficaram incompletos.
+exports.CONTENT_REPORTABLE_STATUS_VALUES = [
+    'approved',
+    'processing',
+    'classified',
+    'error',
+    'partial_error',
+];
+exports.CONTENT_METRICS_SOURCE_VALUES = ['real', 'organic', 'estimated'];
+let ContentStatusChangedBy = class ContentStatusChangedBy {
+};
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, required: false }),
+    __metadata("design:type", String)
+], ContentStatusChangedBy.prototype, "team", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, required: false }),
+    __metadata("design:type", String)
+], ContentStatusChangedBy.prototype, "name", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, required: false }),
+    __metadata("design:type", String)
+], ContentStatusChangedBy.prototype, "email", void 0);
+ContentStatusChangedBy = __decorate([
+    (0, mongoose_1.Schema)({ _id: false })
+], ContentStatusChangedBy);
+exports.ContentStatusChangedBy = ContentStatusChangedBy;
+exports.ContentStatusChangedBySchema = mongoose_1.SchemaFactory.createForClass(ContentStatusChangedBy);
 let Content = class Content {
 };
 __decorate([
@@ -270,12 +332,28 @@ __decorate([
 __decorate([
     (0, mongoose_1.Prop)({
         type: String,
-        enum: ['approved', 'repproved', 'deleted'],
+        enum: exports.CONTENT_STATUS_VALUES,
         required: true,
-        default: 'approved',
+        default: 'pending',
     }),
     __metadata("design:type", String)
 ], Content.prototype, "status", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, enum: exports.CONTENT_METRICS_SOURCE_VALUES, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "metricsSource", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Number, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "processedCommentCount", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: Date, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "approvedAt", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: exports.ContentStatusChangedBySchema, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "approvedBy", void 0);
 __decorate([
     (0, mongoose_1.Prop)({ type: mongoose_2.Schema.Types.ObjectId, ref: 'Profile', required: true }),
     __metadata("design:type", Object)
@@ -369,4 +447,7 @@ exports.ContentSchema.index({ action: 1, profile: 1, socialnetwork: 1 });
 exports.ContentSchema.index({ action: 1, status: 1, postedAt: 1 });
 exports.ContentSchema.index({ profile: 1 });
 exports.ContentSchema.index({ createdAt: -1, status: 1 });
+// Chave de idempotência da captura da Primetag — conteúdos manuais (sem
+// primetagId) ficam fora do índice.
+exports.ContentSchema.index({ action: 1, primetagId: 1 }, { unique: true, partialFilterExpression: { primetagId: { $type: 'string' } } });
 exports.ContentModel = (0, mongoose_2.model)('Content', exports.ContentSchema);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grapadigital/shared-schemas",
-  "version": "1.0.197",
+  "version": "1.0.199",
   "description": "Shared Mongoose Schemas",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/schemas/client.schema.ts

@@ -121,8 +121,15 @@ export class Client extends Party {
   @Prop({ type: [String], default: [] })
   requiredTeams: string[];
 
+  /**
+   * Análise GenIA: captura de comentários, classificação por IA e tudo que
+   * depende deles (spam, taxa de engajamento qualificado, score, CPMI). Sem
+   * isso, os conteúdos do cliente só recebem as métricas base da Primetag.
+   * Também define quais clientes aparecem no hub de relatórios GenIA.
+   * (Antigo `hasReport`.)
+   */
   @Prop({ type: Boolean, default: false })
-  hasReport: boolean;
+  hasGenIAAnalysis: boolean;
 
   @Prop({ type: ResponsableSchema, required: false })
   reportResponsable?: Responsable;

package/src/schemas/comment.schema.ts

@@ -41,6 +41,43 @@ export const COMMENT_CLASSIFICATION_STATUS_VALUES = [
 ] as const;
 export type CommentClassificationStatus = (typeof COMMENT_CLASSIFICATION_STATUS_VALUES)[number];
 
+export const COMMENT_SPAM_RULE_VALUES = ['duplicate_text', 'repeat_author', 'manual', 'unknown'] as const;
+export type CommentSpamRule = (typeof COMMENT_SPAM_RULE_VALUES)[number];
+
+// Por que o comentário foi marcado como spam. `groupKey` identifica os outros
+// comentários do mesmo conteúdo que caíram na mesma regra: autor normalizado
+// (repeat_author) ou `autor::texto` normalizado (duplicate_text).
+@Schema({ _id: false })
+export class CommentSpamReason {
+  @Prop({ type: String, enum: COMMENT_SPAM_RULE_VALUES, required: true })
+  rule: CommentSpamRule;
+
+  @Prop({ type: Number, required: false })
+  threshold?: number;
+
+  @Prop({ type: Number, required: false })
+  matchCount?: number;
+
+  @Prop({ type: String, required: false })
+  groupKey?: string;
+}
+
+export const CommentSpamReasonSchema = SchemaFactory.createForClass(CommentSpamReason);
+
+@Schema({ _id: false })
+export class CommentClassifiedBy {
+  @Prop({ type: String, required: false })
+  team?: string;
+
+  @Prop({ type: String, required: false })
+  name?: string;
+
+  @Prop({ type: String, required: false })
+  email?: string;
+}
+
+export const CommentClassifiedBySchema = SchemaFactory.createForClass(CommentClassifiedBy);
+
 @Schema({ timestamps: true })
 export class Comment {
   @Prop({ type: MongooseSchema.Types.ObjectId, auto: true, required: false })
@@ -117,6 +154,25 @@ export class Comment {
   @Prop({ type: Boolean, required: false, default: false })
   isSpam?: boolean;
 
+  @Prop({ type: CommentSpamReasonSchema, required: false, default: null })
+  spamReason?: CommentSpamReason | null;
+
+  // Tirado do spam manualmente: as regras automáticas de spam ignoram esse
+  // comentário (e ele sai da contagem do grupo), mas a IA continua classificando.
+  @Prop({ type: Boolean, required: false, default: false })
+  spamOverride?: boolean;
+
+  // Classificação ajustada manualmente: nenhum worker sobrescreve
+  // target/subject/polarity/funnel/isSpam desse comentário.
+  @Prop({ type: Boolean, required: false, default: false })
+  isManuallyClassified?: boolean;
+
+  @Prop({ type: Date, required: false, default: null })
+  manuallyClassifiedAt?: Date | null;
+
+  @Prop({ type: CommentClassifiedBySchema, required: false, default: null })
+  manuallyClassifiedBy?: CommentClassifiedBy | null;
+
   @Prop({
     type: String,
     enum: COMMENT_CLASSIFICATION_STATUS_VALUES,
@@ -155,5 +211,6 @@ CommentSchema.index({ action: 1, funnel: 1 });
 CommentSchema.index({ action: 1, target: 1 });
 CommentSchema.index({ content: 1, parent: 1 });
 CommentSchema.index({ content: 1, classificationStatus: 1 });
+CommentSchema.index({ content: 1, 'spamReason.groupKey': 1 });
 
 export const CommentModel = MongooseModel('Comment', CommentSchema);

package/src/schemas/content-capture-process.schema.ts

@@ -60,10 +60,10 @@ export const ContentCaptureProcessInfluencerSchema = SchemaFactory.createForClas
 export class ContentCaptureProcessCommentCaptureStatus {
   @Prop({
     type: String,
-    enum: ['captured', 'skipped_cooldown', 'skipped_network', 'out_of_scope', 'failed'],
+    enum: ['captured', 'skipped_cooldown', 'skipped_network', 'skipped_no_comments', 'out_of_scope', 'failed'],
     required: true,
   })
-  status: 'captured' | 'skipped_cooldown' | 'skipped_network' | 'out_of_scope' | 'failed';
+  status: 'captured' | 'skipped_cooldown' | 'skipped_network' | 'skipped_no_comments' | 'out_of_scope' | 'failed';
 
   @Prop({ type: Number, required: false })
   commentsCaptured?: number;

package/src/schemas/content.schema.ts

@@ -107,6 +107,21 @@ export class Metrics {
   @Prop({ type: Number, required: false, default: null })
   replyCount?: number | null;
 
+  @Prop({ type: Number, required: false, default: null })
+  tapForwardCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  swipeForwardCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  exitCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  favoriteCount?: number | null;
+
+  @Prop({ type: Number, required: false, default: null })
+  dislikeCount?: number | null;
+
   @Prop({ type: Number, required: false, default: null })
   emv?: number | null;
 
@@ -173,6 +188,48 @@ export class Estimates {
 
 export const EstimatesSchema = SchemaFactory.createForClass(Estimates);
 
+// error: captura de comentários falhou ou a classificação falhou por inteiro.
+// partial_error: parte dos comentários não foi classificada. Nenhum dos dois
+// volta sozinho pro pipeline — só por reenvio manual (aprovação).
+export const CONTENT_STATUS_VALUES = [
+  'pending',
+  'approved',
+  'deleted',
+  'processing',
+  'classified',
+  'error',
+  'partial_error',
+] as const;
+export type ContentStatus = (typeof CONTENT_STATUS_VALUES)[number];
+
+// Status que entram em relatórios/KPIs (pending e deleted ficam de fora). error
+// e partial_error entram: as métricas da Primetag são válidas, só os
+// comentários ficaram incompletos.
+export const CONTENT_REPORTABLE_STATUS_VALUES: ContentStatus[] = [
+  'approved',
+  'processing',
+  'classified',
+  'error',
+  'partial_error',
+];
+
+export const CONTENT_METRICS_SOURCE_VALUES = ['real', 'organic', 'estimated'] as const;
+export type ContentMetricsSource = (typeof CONTENT_METRICS_SOURCE_VALUES)[number];
+
+@Schema({ _id: false })
+export class ContentStatusChangedBy {
+  @Prop({ type: String, required: false })
+  team?: string;
+
+  @Prop({ type: String, required: false })
+  name?: string;
+
+  @Prop({ type: String, required: false })
+  email?: string;
+}
+
+export const ContentStatusChangedBySchema = SchemaFactory.createForClass(ContentStatusChangedBy);
+
 @Schema({ timestamps: true })
 export class Content {
   @Prop({ type: MongooseSchema.Types.ObjectId, auto: true, required: false })
@@ -205,13 +262,35 @@ export class Content {
   })
   socialnetwork: 'instagram' | 'tiktok' | 'youtube' | 'pinterest' | 'linkedin' | 'twitter';
 
+  // pending: capturado da Primetag, aguardando aprovação manual.
+  // approved: aprovado manualmente, entra no pipeline (comentários → classificação → métricas).
+  // processing: dentro do pipeline — nunca é reprocessado nem aprovado/excluído nesse estado.
+  // classified: pipeline concluído.
+  // deleted: reprovado ou excluído manualmente.
   @Prop({
     type: String,
-    enum: ['approved', 'repproved', 'deleted'],
+    enum: CONTENT_STATUS_VALUES,
     required: true,
-    default: 'approved',
+    default: 'pending',
   })
-  status: 'approved' | 'repproved' | 'deleted';
+  status: ContentStatus;
+
+  // Origem das métricas vindas da Primetag (ver metrics_snapshot):
+  // real = insights oficiais (perfil conectado), organic = métrica pública,
+  // estimated = estimada pela Primetag ou pela nossa estimativa de story.
+  @Prop({ type: String, enum: CONTENT_METRICS_SOURCE_VALUES, required: false, default: null })
+  metricsSource?: ContentMetricsSource | null;
+
+  // Contagem de comentários da Primetag no último processamento concluído —
+  // decide se há comentário novo pra recapturar/classificar.
+  @Prop({ type: Number, required: false, default: null })
+  processedCommentCount?: number | null;
+
+  @Prop({ type: Date, required: false, default: null })
+  approvedAt?: Date | null;
+
+  @Prop({ type: ContentStatusChangedBySchema, required: false, default: null })
+  approvedBy?: ContentStatusChangedBy | null;
 
   @Prop({ type: MongooseSchema.Types.ObjectId, ref: 'Profile', required: true })
   profile: Types.ObjectId | Profile;
@@ -288,5 +367,11 @@ ContentSchema.index({ action: 1, profile: 1, socialnetwork: 1 });
 ContentSchema.index({ action: 1, status: 1, postedAt: 1 });
 ContentSchema.index({ profile: 1 });
 ContentSchema.index({ createdAt: -1, status: 1 });
+// Chave de idempotência da captura da Primetag — conteúdos manuais (sem
+// primetagId) ficam fora do índice.
+ContentSchema.index(
+  { action: 1, primetagId: 1 },
+  { unique: true, partialFilterExpression: { primetagId: { $type: 'string' } } },
+);
 
 export const ContentModel = MongooseModel('Content', ContentSchema);