thrillwiki_django_no_react/memory-bank/features/version-control/change-comments.md

Change Commenting System Implementation Plan

Core Requirements

1. Threaded comment conversations
2. @mention functionality
3. File/line anchoring
4. Notification system
5. Comment resolution tracking

Technical Integration

• Model Relationships
  Extend HistoricalRecord (line 31):

  class HistoricalRecord(models.Model):  
      comments = GenericRelation('CommentThread')  # Enables change comments  
  

• Collaboration System
  Enhance interface (line 85):

  interface CollaborationSystem {  
      createCommentThread(  
          changeId: string,  
          anchor: LineRange,  
          initialComment: string  
      ): Promise<CommentThread>;  
  }  
  

• UI Components
  New InlineCommentPanel component:

  interface CommentProps {  
      thread: CommentThread;  
      canResolve: boolean;  
      onReply: (content: string) => void;  
      onResolve: () => void;  
  }  
  

Notification Matrix

Event Type	Notification Channel	Escalation Path
New comment	In-app, Email	After 24hrs → Slack DM
@mention	Mobile push, Email	After 12hrs → SMS
Resolution	In-app	None

Phase Plan

1. Week 1: Comment storage infrastructure
2. Week 2: Anchoring system & UI
3. Week 3: Notification pipeline
4. Week 4: Moderation tools & audit