@axova/shared 1.0.0

package/src/schemas/compliance/compliance-schema.ts

@@ -0,0 +1,927 @@
+import { createId } from "@paralleldrive/cuid2";
+import { relations } from "drizzle-orm";
+import {
+	boolean,
+	decimal,
+	index,
+	integer,
+	jsonb,
+	pgTable,
+	text,
+	timestamp,
+	unique,
+	varchar,
+} from "drizzle-orm/pg-core";
+
+// Store Compliance Table - Enhanced
+export const storeCompliance = pgTable(
+	"store_compliance",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull().unique(),
+
+		// Verification & Compliance Status
+		isVerified: boolean("is_verified").notNull().default(false),
+		isFeatureStore: boolean("is_feature_store").notNull().default(false),
+		verificationStatus: varchar("verification_status", { length: 50 })
+			.notNull()
+			.default("STANDARD")
+			.$type<
+				"STANDARD" | "VERIFIED" | "PREMIUM_VERIFIED" | "ENTERPRISE_VERIFIED"
+			>(),
+
+		// Verification Details
+		verificationLevel: varchar("verification_level", { length: 30 })
+			.$type<"BASIC" | "ENHANCED" | "PREMIUM" | "ENTERPRISE">()
+			.default("BASIC"),
+		verificationBadges: jsonb("verification_badges")
+			.$type<string[]>()
+			.default([]),
+		verifiedAt: timestamp("verified_at", { withTimezone: true }),
+		verificationExpiry: timestamp("verification_expiry", {
+			withTimezone: true,
+		}),
+
+		// Store Status
+		isBanned: boolean("is_banned").notNull().default(false),
+		isSuspended: boolean("is_suspended").notNull().default(false),
+		isUnderReview: boolean("is_under_review").notNull().default(false),
+
+		// Ban/Suspension Details
+		banReason: text("ban_reason"),
+		banLevel: varchar("ban_level", { length: 20 }).$type<
+			"TEMPORARY" | "PERMANENT" | "CONDITIONAL"
+		>(),
+		banStartDate: timestamp("ban_start_date", { withTimezone: true }),
+		banEndDate: timestamp("ban_end_date", { withTimezone: true }),
+
+		suspensionReason: text("suspension_reason"),
+		suspensionLevel: varchar("suspension_level", { length: 20 }).$type<
+			"PARTIAL" | "FULL" | "PAYMENT_ONLY" | "LISTING_ONLY"
+		>(),
+		suspensionStartDate: timestamp("suspension_start_date", {
+			withTimezone: true,
+		}),
+		suspensionEndDate: timestamp("suspension_end_date", { withTimezone: true }),
+
+		// Compliance Metrics
+		warningCount: integer("warning_count").notNull().default(0),
+		violationCount: integer("violation_count").notNull().default(0),
+		appealCount: integer("appeal_count").notNull().default(0),
+		successfulAppealCount: integer("successful_appeal_count")
+			.notNull()
+			.default(0),
+
+		lastWarningDate: timestamp("last_warning_date", { withTimezone: true }),
+		lastViolationDate: timestamp("last_violation_date", { withTimezone: true }),
+
+		// Compliance Score (0-100)
+		complianceScore: integer("compliance_score").default(100),
+		riskLevel: varchar("risk_level", { length: 20 })
+			.$type<"LOW" | "MEDIUM" | "HIGH" | "CRITICAL">()
+			.default("LOW"),
+
+		// Trust and Safety
+		trustScore: decimal("trust_score", { precision: 5, scale: 2 }).default(
+			"100.00",
+		),
+		safetyRating: varchar("safety_rating", { length: 10 })
+			.$type<"A+" | "A" | "B" | "C" | "D" | "F">()
+			.default("A"),
+
+		// Review and Monitoring
+		nextReviewDate: timestamp("next_review_date", { withTimezone: true }),
+		reviewFrequency: varchar("review_frequency", { length: 20 })
+			.$type<"WEEKLY" | "MONTHLY" | "QUARTERLY" | "ANNUALLY" | "ON_DEMAND">()
+			.default("QUARTERLY"),
+
+		monitoringLevel: varchar("monitoring_level", { length: 20 })
+			.$type<"STANDARD" | "ENHANCED" | "INTENSIVE" | "MANUAL_ONLY">()
+			.default("STANDARD"),
+
+		// Compliance Flags
+		flags: jsonb("flags")
+			.$type<{
+				highRisk?: boolean;
+				repeatOffender?: boolean;
+				escalated?: boolean;
+				whitelisted?: boolean;
+				blacklisted?: boolean;
+				underInvestigation?: boolean;
+				requiresManualReview?: boolean;
+				autoModerationDisabled?: boolean;
+			}>()
+			.default({}),
+
+		// Return and Refund Settings
+		returnSettings: jsonb("return_settings")
+			.$type<{
+				returnWindow: number; // days
+				returnReasons: string[];
+				returnInstructions: string;
+				returnShippingPolicy: string;
+				restockingFee?: number;
+				returnConditions?: string[];
+				exchangePolicy?: string;
+				digitalReturnPolicy?: string;
+			}>()
+			.default({
+				returnWindow: 30,
+				returnReasons: [],
+				returnInstructions: "",
+				returnShippingPolicy: "",
+			}),
+
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_compliance_store_id").on(table.storeId),
+		verificationStatusIndex: index("idx_compliance_verification_status").on(
+			table.verificationStatus,
+		),
+		complianceScoreIndex: index("idx_compliance_score").on(
+			table.complianceScore,
+		),
+		riskLevelIndex: index("idx_compliance_risk_level").on(table.riskLevel),
+
+		// Status monitoring indexes
+		bannedStoresIndex: index("idx_compliance_banned").on(
+			table.isBanned,
+			table.banEndDate,
+		),
+		suspendedStoresIndex: index("idx_compliance_suspended").on(
+			table.isSuspended,
+			table.suspensionEndDate,
+		),
+		underReviewIndex: index("idx_compliance_under_review").on(
+			table.isUnderReview,
+		),
+
+		// Review workflow indexes
+		nextReviewIndex: index("idx_compliance_next_review").on(
+			table.nextReviewDate,
+			table.reviewFrequency,
+		),
+		monitoringIndex: index("idx_compliance_monitoring").on(
+			table.monitoringLevel,
+			table.riskLevel,
+		),
+	}),
+);
+
+// Compliance Violations Table - Enhanced
+export const complianceViolations = pgTable(
+	"compliance_violations",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+
+		// Violation Classification
+		violationType: varchar("violation_type", { length: 50 })
+			.notNull()
+			.$type<
+				| "CONTENT_VIOLATION"
+				| "POLICY_VIOLATION"
+				| "BEHAVIOR_VIOLATION"
+				| "PAYMENT_VIOLATION"
+				| "TECHNICAL_VIOLATION"
+				| "LEGAL_VIOLATION"
+			>(),
+
+		violationCategory: varchar("violation_category", { length: 50 }).$type<
+			| "PROHIBITED_CONTENT"
+			| "MISLEADING_INFO"
+			| "COPYRIGHT"
+			| "TRADEMARK"
+			| "FRAUD"
+			| "SPAM"
+			| "HARASSMENT"
+			| "PRIVACY"
+			| "SAFETY"
+			| "OTHER"
+		>(),
+
+		severity: varchar("severity", { length: 20 })
+			.notNull()
+			.$type<"LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | "URGENT">(),
+
+		priority: varchar("priority", { length: 20 })
+			.notNull()
+			.default("NORMAL")
+			.$type<"LOW" | "NORMAL" | "HIGH" | "URGENT" | "EMERGENCY">(),
+
+		// Violation Details
+		title: varchar("title", { length: 255 }).notNull(),
+		description: text("description").notNull(),
+		context: text("context"), // Additional context about where/how violation occurred
+
+		// Evidence and Documentation
+		evidence: jsonb("evidence").$type<{
+			screenshots?: string[];
+			urls?: string[];
+			reportedContent?: string;
+			systemLogs?: Record<string, unknown>;
+			userReports?: Array<{
+				reporterId: string;
+				reason: string;
+				timestamp: string;
+				evidence?: string;
+			}>;
+			additionalData?: Record<string, unknown>;
+		}>(),
+
+		// Detection Information
+		detectedBy: varchar("detected_by", { length: 50 })
+			.notNull()
+			.$type<
+				| "SYSTEM"
+				| "AI_MODERATION"
+				| "USER_REPORT"
+				| "ADMIN_REVIEW"
+				| "AUTOMATED_SCAN"
+				| "COMPLIANCE_AUDIT"
+			>(),
+
+		detectorId: text("detector_id"), // ID of the user, system, or AI that detected it
+		detectionMethod: varchar("detection_method", { length: 50 }).$type<
+			| "KEYWORD_FILTER"
+			| "IMAGE_RECOGNITION"
+			| "PATTERN_ANALYSIS"
+			| "USER_REPORT"
+			| "MANUAL_REVIEW"
+			| "AUTOMATED_RULE"
+		>(),
+
+		detectionConfidence: decimal("detection_confidence", {
+			precision: 5,
+			scale: 2,
+		}), // 0-100%
+
+		// Processing Status
+		status: varchar("status", { length: 20 })
+			.notNull()
+			.default("PENDING")
+			.$type<
+				| "PENDING"
+				| "UNDER_REVIEW"
+				| "ESCALATED"
+				| "RESOLVED"
+				| "DISMISSED"
+				| "APPEALED"
+				| "CLOSED"
+			>(),
+
+		// Actions and Resolution
+		actionTaken: varchar("action_taken", { length: 50 }).$type<
+			| "NONE"
+			| "WARNING"
+			| "CONTENT_REMOVAL"
+			| "LISTING_SUSPENSION"
+			| "ACCOUNT_SUSPENSION"
+			| "ACCOUNT_BAN"
+			| "FINE"
+			| "EDUCATION_REQUIRED"
+		>(),
+
+		autoActionApplied: boolean("auto_action_applied").notNull().default(false),
+		requiresManualReview: boolean("requires_manual_review")
+			.notNull()
+			.default(false),
+
+		// Resolution Details
+		resolvedBy: text("resolved_by"),
+		resolvedAt: timestamp("resolved_at", { withTimezone: true }),
+		resolutionNotes: text("resolution_notes"),
+		resolutionType: varchar("resolution_type", { length: 30 }).$type<
+			"AUTOMATED" | "MANUAL" | "ESCALATED" | "APPEALED" | "ADMIN_OVERRIDE"
+		>(),
+
+		// Impact Assessment
+		impactScore: integer("impact_score").default(1), // 1-10 scale
+		affectedUsers: integer("affected_users").default(0),
+		businessImpact: varchar("business_impact", { length: 20 }).$type<
+			"MINIMAL" | "LOW" | "MODERATE" | "HIGH" | "SEVERE"
+		>(),
+
+		// Follow-up and Monitoring
+		followUpRequired: boolean("follow_up_required").notNull().default(false),
+		followUpDate: timestamp("follow_up_date", { withTimezone: true }),
+		monitoringPeriod: integer("monitoring_period"), // days
+
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_violations_store_id").on(table.storeId),
+		statusIndex: index("idx_violations_status").on(table.status),
+		severityIndex: index("idx_violations_severity").on(table.severity),
+		detectedByIndex: index("idx_violations_detected_by").on(table.detectedBy),
+
+		// Workflow indexes
+		pendingReviewIndex: index("idx_violations_pending_review").on(
+			table.status,
+			table.requiresManualReview,
+		),
+
+		// Performance monitoring indexes
+		violationTypeIndex: index("idx_violations_type_category").on(
+			table.violationType,
+			table.violationCategory,
+		),
+
+		// Resolution tracking indexes
+		resolutionWorkflowIndex: index("idx_violations_resolution").on(
+			table.status,
+			table.resolvedAt,
+		),
+
+		// Follow-up indexes
+		followUpIndex: index("idx_violations_follow_up").on(
+			table.followUpRequired,
+			table.followUpDate,
+		),
+	}),
+);
+
+// Compliance Actions History - Enhanced
+export const complianceActions = pgTable(
+	"compliance_actions",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		violationId: text("violation_id").references(() => complianceViolations.id),
+
+		// Action Classification
+		actionType: varchar("action_type", { length: 50 })
+			.notNull()
+			.$type<
+				| "WARNING"
+				| "CONTENT_REMOVAL"
+				| "LISTING_SUSPENSION"
+				| "ACCOUNT_SUSPENSION"
+				| "ACCOUNT_BAN"
+				| "ACCOUNT_UNBAN"
+				| "VERIFICATION"
+				| "FINE"
+				| "EDUCATION_MANDATE"
+				| "MONITORING_INCREASE"
+				| "FEATURE_RESTRICTION"
+			>(),
+
+		actionCategory: varchar("action_category", { length: 30 }).$type<
+			"PREVENTIVE" | "CORRECTIVE" | "PUNITIVE" | "EDUCATIONAL" | "MONITORING"
+		>(),
+
+		severity: varchar("severity", { length: 20 })
+			.notNull()
+			.$type<"MINOR" | "MODERATE" | "MAJOR" | "SEVERE" | "CRITICAL">(),
+
+		// Action Details
+		reason: text("reason").notNull(),
+		description: text("description"),
+		justification: text("justification"),
+
+		// Duration and Scope
+		duration: integer("duration"), // Duration in hours for temporary actions
+		durationType: varchar("duration_type", { length: 20 }).$type<
+			"TEMPORARY" | "PERMANENT" | "CONDITIONAL" | "UNTIL_COMPLIANCE"
+		>(),
+
+		scope: jsonb("scope").$type<{
+			affectedFeatures?: string[];
+			affectedRegions?: string[];
+			affectedProducts?: string[];
+			limitations?: string[];
+		}>(),
+
+		// Execution Details
+		performedBy: text("performed_by").notNull(),
+		performedByType: varchar("performed_by_type", { length: 20 })
+			.notNull()
+			.$type<
+				| "SYSTEM"
+				| "AI_MODERATION"
+				| "ADMIN"
+				| "COMPLIANCE_TEAM"
+				| "LEGAL_TEAM"
+				| "ESCALATION_TEAM"
+			>(),
+
+		isAutomated: boolean("is_automated").notNull().default(false),
+		automationRule: text("automation_rule"), // Reference to the automation rule used
+
+		// Impact and Effectiveness
+		impactLevel: varchar("impact_level", { length: 20 }).$type<
+			"LOW" | "MEDIUM" | "HIGH" | "BUSINESS_CRITICAL"
+		>(),
+
+		effectiveness: varchar("effectiveness", { length: 20 }).$type<
+			| "PENDING"
+			| "EFFECTIVE"
+			| "PARTIALLY_EFFECTIVE"
+			| "INEFFECTIVE"
+			| "REQUIRES_ESCALATION"
+		>(),
+
+		// Additional Data and Context
+		additionalData: jsonb("additional_data").$type<{
+			originalValues?: Record<string, unknown>;
+			configurationChanges?: Record<string, unknown>;
+			systemParameters?: Record<string, unknown>;
+			businessMetrics?: Record<string, unknown>;
+		}>(),
+
+		notes: text("notes"),
+		internalNotes: text("internal_notes"), // Not visible to store owner
+
+		// Review and Approval
+		requiresApproval: boolean("requires_approval").notNull().default(false),
+		approvedBy: text("approved_by"),
+		approvedAt: timestamp("approved_at", { withTimezone: true }),
+		approvalNotes: text("approval_notes"),
+
+		// Execution Tracking
+		executedAt: timestamp("executed_at", { withTimezone: true }),
+		executionStatus: varchar("execution_status", { length: 20 })
+			.notNull()
+			.default("PENDING")
+			.$type<
+				| "PENDING"
+				| "IN_PROGRESS"
+				| "COMPLETED"
+				| "FAILED"
+				| "CANCELLED"
+				| "REVERSED"
+			>(),
+
+		executionNotes: text("execution_notes"),
+
+		// Reversal and Appeals
+		isReversible: boolean("is_reversible").notNull().default(true),
+		reversedBy: text("reversed_by"),
+		reversedAt: timestamp("reversed_at", { withTimezone: true }),
+		reversalReason: text("reversal_reason"),
+
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_actions_store_id").on(table.storeId),
+		actionTypeIndex: index("idx_actions_type").on(table.actionType),
+		violationIdIndex: index("idx_actions_violation_id").on(table.violationId),
+
+		// Workflow indexes
+		approvalWorkflowIndex: index("idx_actions_approval_workflow").on(
+			table.requiresApproval,
+			table.approvedAt,
+		),
+
+		executionStatusIndex: index("idx_actions_execution_status").on(
+			table.executionStatus,
+			table.executedAt,
+		),
+
+		// Performance tracking indexes
+		automationIndex: index("idx_actions_automation").on(
+			table.isAutomated,
+			table.actionType,
+		),
+
+		effectivenessIndex: index("idx_actions_effectiveness").on(
+			table.effectiveness,
+			table.impactLevel,
+		),
+	}),
+);
+
+// Store Policies Table - Enhanced
+export const storePolicies = pgTable(
+	"store_policies",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+
+		// Policy Classification
+		policyType: varchar("policy_type", { length: 50 })
+			.notNull()
+			.$type<
+				| "RETURN_POLICY"
+				| "REFUND_POLICY"
+				| "TERMS_OF_SERVICE"
+				| "PRIVACY_POLICY"
+				| "SHIPPING_POLICY"
+				| "WARRANTY_POLICY"
+				| "CANCELLATION_POLICY"
+				| "DISPUTE_RESOLUTION"
+				| "DATA_PROTECTION"
+				| "COOKIE_POLICY"
+			>(),
+
+		policyCategory: varchar("policy_category", { length: 30 }).$type<
+			"CUSTOMER_FACING" | "LEGAL_COMPLIANCE" | "OPERATIONAL" | "REGULATORY"
+		>(),
+
+		// Content and Metadata
+		title: varchar("title", { length: 255 }).notNull(),
+		content: text("content").notNull(),
+		summary: text("summary"), // Brief summary for quick reference
+
+		// Versioning
+		version: varchar("version", { length: 20 }).notNull().default("1.0"),
+		versionNotes: text("version_notes"),
+		previousVersionId: text("previous_version_id"),
+
+		// Status and Lifecycle
+		status: varchar("status", { length: 20 })
+			.notNull()
+			.default("DRAFT")
+			.$type<
+				| "DRAFT"
+				| "PENDING_REVIEW"
+				| "APPROVED"
+				| "ACTIVE"
+				| "SUPERSEDED"
+				| "ARCHIVED"
+				| "DEPRECATED"
+			>(),
+
+		isActive: boolean("is_active").notNull().default(false),
+		isMandatory: boolean("is_mandatory").notNull().default(false),
+		isPublic: boolean("is_public").notNull().default(true),
+
+		// Compliance and Legal
+		requiresAcceptance: boolean("requires_acceptance").notNull().default(false),
+		acceptanceTracking: boolean("acceptance_tracking").notNull().default(false),
+		legalReviewRequired: boolean("legal_review_required")
+			.notNull()
+			.default(false),
+
+		complianceStandards: jsonb("compliance_standards")
+			.$type<string[]>()
+			.default([]), // GDPR, CCPA, etc.
+		jurisdictions: jsonb("jurisdictions").$type<string[]>().default([]), // Countries/regions where this applies
+
+		// Approval Workflow
+		approvedBy: text("approved_by"),
+		approvedAt: timestamp("approved_at", { withTimezone: true }),
+		approvalNotes: text("approval_notes"),
+
+		legalReviewedBy: text("legal_reviewed_by"),
+		legalReviewedAt: timestamp("legal_reviewed_at", { withTimezone: true }),
+		legalReviewNotes: text("legal_review_notes"),
+
+		// Effective Dates
+		effectiveFrom: timestamp("effective_from", { withTimezone: true }),
+		effectiveUntil: timestamp("effective_until", { withTimezone: true }),
+		lastReviewDate: timestamp("last_review_date", { withTimezone: true }),
+		nextReviewDate: timestamp("next_review_date", { withTimezone: true }),
+
+		// Localization
+		language: varchar("language", { length: 10 }).default("en"),
+		localizations: jsonb("localizations")
+			.$type<
+				Record<
+					string,
+					{
+						title: string;
+						content: string;
+						summary?: string;
+						status: string;
+						effectiveFrom?: string;
+					}
+				>
+			>()
+			.default({}),
+
+		// Display and Integration
+		displayOrder: integer("display_order").default(0),
+		categoryOrder: integer("category_order").default(0),
+
+		// Templates and Customization
+		templateId: text("template_id"), // Reference to policy template
+		customFields: jsonb("custom_fields")
+			.$type<Record<string, unknown>>()
+			.default({}),
+
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_policies_store_id").on(table.storeId),
+		policyTypeIndex: index("idx_policies_type").on(table.policyType),
+		statusIndex: index("idx_policies_status").on(table.status),
+
+		// Active policies index for quick filtering
+		activePoliciesIndex: index("idx_policies_active").on(
+			table.storeId,
+			table.isActive,
+			table.policyType,
+		),
+
+		// Compliance workflow indexes
+		approvalWorkflowIndex: index("idx_policies_approval_workflow").on(
+			table.status,
+			table.legalReviewRequired,
+		),
+
+		// Review scheduling indexes
+		reviewScheduleIndex: index("idx_policies_review_schedule").on(
+			table.nextReviewDate,
+			table.isActive,
+		),
+
+		// Ensure only one active policy per type per store
+		uniqueActivePolicyPerType: unique("unique_active_policy_per_type").on(
+			table.storeId,
+			table.policyType,
+			table.isActive,
+		),
+	}),
+);
+
+// Appeals Table - Enhanced
+export const appeals = pgTable(
+	"appeals",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		userId: text("user_id").notNull(),
+
+		// Appeal Classification
+		appealType: varchar("appeal_type", { length: 50 })
+			.notNull()
+			.$type<
+				| "ACCOUNT_BAN_APPEAL"
+				| "ACCOUNT_SUSPENSION_APPEAL"
+				| "WARNING_APPEAL"
+				| "CONTENT_REMOVAL_APPEAL"
+				| "POLICY_DISPUTE"
+				| "VERIFICATION_APPEAL"
+				| "FINE_APPEAL"
+				| "FEATURE_RESTRICTION_APPEAL"
+			>(),
+
+		appealCategory: varchar("appeal_category", { length: 30 }).$type<
+			| "WRONGFUL_ACTION"
+			| "PROCEDURAL_ERROR"
+			| "NEW_EVIDENCE"
+			| "CHANGED_CIRCUMSTANCES"
+			| "POLICY_INTERPRETATION"
+			| "TECHNICAL_ISSUE"
+		>(),
+
+		priority: varchar("priority", { length: 20 })
+			.notNull()
+			.default("NORMAL")
+			.$type<"LOW" | "NORMAL" | "HIGH" | "URGENT" | "EMERGENCY">(),
+
+		// Original Action References
+		originalViolationId: text("original_violation_id").references(
+			() => complianceViolations.id,
+		),
+
+		originalActionId: text("original_action_id").references(
+			() => complianceActions.id,
+		),
+
+		// Appeal Content
+		title: varchar("title", { length: 255 }).notNull(),
+		reason: text("reason").notNull(),
+		description: text("description"),
+		requestedOutcome: text("requested_outcome"), // What the appellant wants to happen
+
+		// Evidence and Supporting Documents
+		evidence: jsonb("evidence").$type<{
+			documents?: Array<{
+				filename: string;
+				url: string;
+				type: string;
+				uploadedAt: string;
+			}>;
+			screenshots?: string[];
+			testimonials?: Array<{
+				name: string;
+				relationship: string;
+				statement: string;
+				contactInfo?: string;
+			}>;
+			externalReferences?: Array<{
+				source: string;
+				url: string;
+				description: string;
+			}>;
+			additionalData?: Record<string, unknown>;
+		}>(),
+
+		// Status and Processing
+		status: varchar("status", { length: 20 })
+			.notNull()
+			.default("SUBMITTED")
+			.$type<
+				| "SUBMITTED"
+				| "UNDER_REVIEW"
+				| "PENDING_DOCUMENTS"
+				| "ESCALATED"
+				| "APPROVED"
+				| "PARTIALLY_APPROVED"
+				| "REJECTED"
+				| "WITHDRAWN"
+				| "EXPIRED"
+			>(),
+
+		// Assignment and Review
+		assignedTo: text("assigned_to"),
+		assignedAt: timestamp("assigned_at", { withTimezone: true }),
+		reviewLevel: varchar("review_level", { length: 20 })
+			.$type<
+				"FIRST_LEVEL" | "SECOND_LEVEL" | "MANAGEMENT" | "LEGAL" | "EXECUTIVE"
+			>()
+			.default("FIRST_LEVEL"),
+
+		// Review Process
+		reviewedBy: text("reviewed_by"),
+		reviewedAt: timestamp("reviewed_at", { withTimezone: true }),
+		reviewStartedAt: timestamp("review_started_at", { withTimezone: true }),
+
+		// Decision and Outcome
+		decision: varchar("decision", { length: 20 }).$type<
+			| "APPROVED"
+			| "PARTIALLY_APPROVED"
+			| "REJECTED"
+			| "REQUIRES_MORE_INFO"
+			| "ESCALATED"
+		>(),
+
+		reasoning: text("reasoning"),
+		actionTaken: text("action_taken"),
+		compensationOffered: text("compensation_offered"),
+
+		// Review Notes and Communication
+		reviewNotes: text("review_notes"),
+		internalNotes: text("internal_notes"), // Not visible to appellant
+		communicationHistory: jsonb("communication_history")
+			.$type<
+				Array<{
+					timestamp: string;
+					from: string;
+					to: string;
+					type: "EMAIL" | "PHONE" | "CHAT" | "INTERNAL_NOTE";
+					subject?: string;
+					content: string;
+					attachments?: string[];
+				}>
+			>()
+			.default([]),
+
+		// Timeline and SLA
+		submittedAt: timestamp("submitted_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		acknowledgedAt: timestamp("acknowledged_at", { withTimezone: true }),
+		targetResolutionDate: timestamp("target_resolution_date", {
+			withTimezone: true,
+		}),
+		actualResolutionDate: timestamp("actual_resolution_date", {
+			withTimezone: true,
+		}),
+
+		// Escalation
+		escalationLevel: integer("escalation_level").default(0),
+		escalatedBy: text("escalated_by"),
+		escalatedAt: timestamp("escalated_at", { withTimezone: true }),
+		escalationReason: text("escalation_reason"),
+
+		// Follow-up and Monitoring
+		requiresFollowUp: boolean("requires_follow_up").notNull().default(false),
+		followUpDate: timestamp("follow_up_date", { withTimezone: true }),
+		satisfactionRating: integer("satisfaction_rating"), // 1-5 scale
+		appellantFeedback: text("appellant_feedback"),
+
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_appeals_store_id").on(table.storeId),
+		statusIndex: index("idx_appeals_status").on(table.status),
+		appealTypeIndex: index("idx_appeals_type").on(table.appealType),
+
+		// Assignment and workflow indexes
+		assignmentIndex: index("idx_appeals_assignment").on(
+			table.assignedTo,
+			table.status,
+		),
+
+		reviewLevelIndex: index("idx_appeals_review_level").on(
+			table.reviewLevel,
+			table.status,
+		),
+
+		// SLA and timeline tracking indexes
+		slaTrackingIndex: index("idx_appeals_sla_tracking").on(
+			table.targetResolutionDate,
+			table.status,
+		),
+
+		// Escalation tracking indexes
+		escalationIndex: index("idx_appeals_escalation").on(
+			table.escalationLevel,
+			table.escalatedAt,
+		),
+
+		// Performance analytics indexes
+		decisionTimeIndex: index("idx_appeals_decision_time").on(
+			table.submittedAt,
+			table.actualResolutionDate,
+		),
+	}),
+);
+
+// Relations
+export const storeComplianceRelations = relations(
+	storeCompliance,
+	({ many }) => ({
+		violations: many(complianceViolations),
+		actions: many(complianceActions),
+		policies: many(storePolicies),
+		appeals: many(appeals),
+	}),
+);
+
+export const complianceViolationsRelations = relations(
+	complianceViolations,
+	({ one, many }) => ({
+		compliance: one(storeCompliance, {
+			fields: [complianceViolations.storeId],
+			references: [storeCompliance.storeId],
+		}),
+		actions: many(complianceActions),
+		appeals: many(appeals),
+	}),
+);
+
+export const complianceActionsRelations = relations(
+	complianceActions,
+	({ one }) => ({
+		compliance: one(storeCompliance, {
+			fields: [complianceActions.storeId],
+			references: [storeCompliance.storeId],
+		}),
+		violation: one(complianceViolations, {
+			fields: [complianceActions.violationId],
+			references: [complianceViolations.id],
+		}),
+	}),
+);
+
+export const storePoliciesRelations = relations(storePolicies, ({ one }) => ({
+	compliance: one(storeCompliance, {
+		fields: [storePolicies.storeId],
+		references: [storeCompliance.storeId],
+	}),
+}));
+
+export const appealsRelations = relations(appeals, ({ one }) => ({
+	compliance: one(storeCompliance, {
+		fields: [appeals.storeId],
+		references: [storeCompliance.storeId],
+	}),
+	violation: one(complianceViolations, {
+		fields: [appeals.originalViolationId],
+		references: [complianceViolations.id],
+	}),
+	action: one(complianceActions, {
+		fields: [appeals.originalActionId],
+		references: [complianceActions.id],
+	}),
+}));