tercul-frontend/TODO.md

# Tercul Platform Development Todo List

> **⚠️ MIGRATED TO GITHUB ISSUES**
>
> All development tasks have been migrated to GitHub Issues for better tracking.
>
> - **Backend tasks:** Issues #30-38
> - **Frontend tasks:** Issues #48-52
>
> See all issues at: <https://github.com/SamyRai/backend/issues>
>
> This document is kept for historical reference only.

---

## ✅ Completed Work

### Component Library Progress

- [x] Complete Work Header component
- [x] Complete Comment Thread component
- [x] Implement Author Header component
- [x] **COMPLETED: Author Components Refactoring**
  - [x] Aligned all author components with shared schema
  - [x] Created centralized types and utilities
  - [x] Improved consistency across author cards, chips, and timeline
  - [x] Added loading states and error handling
  - [x] Implemented proper TypeScript types

### Recent Refactoring Completed ✅

- [x] **Author Components Alignment**
  - [x] Created shared types in `/components/authors/types.ts`
  - [x] Created utility functions in `/components/authors/utils.ts`
  - [x] Refactored AuthorCard to use shared schema
  - [x] Updated AuthorChip for consistency
  - [x] Enhanced AuthorTimeline with proper error handling
  - [x] Added centralized exports in `/components/authors/index.ts`
  - [x] Removed duplicate Author interface definitions
  - [x] Improved type safety and consistency

- [x] **Composable Components Refactoring**
  - [x] Split monolithic composables into individual files
  - [x] Created `/components/authors/composables/author-avatar.tsx`
  - [x] Created `/components/authors/composables/author-name.tsx`
  - [x] Created `/components/authors/composables/author-bio.tsx`
  - [x] Created `/components/authors/composables/author-meta.tsx`
  - [x] Created `/components/authors/composables/author-stats.tsx`
  - [x] Created `/components/authors/composables/author-genres.tsx`
  - [x] Updated main components to use composable pieces
  - [x] Improved maintainability with single-responsibility principle

### Dashboard & Editorial Features

- [x] Create a consistent design system for all dashboard pages
- [x] Improve mobile responsiveness for all dashboard pages
- [x] Dashboard Overview (main statistics)
- [x] Blog Management (list view)
- [x] Blog Post Editor (create/edit)
  - [x] Rich text editor with proper formatting toolbar
  - [x] Image upload functionality
- [x] Works Management
  - [x] Works listing with filtering and sorting
  - [x] Work creation/editing form
- [x] Authors Management
  - [x] Authors listing with search and filters
  - [x] Author profile components (cards, chips, timeline)
- [x] Translations Management
  - [x] Translations listing with filtering
- [x] Collections Management
  - [x] Collections listing and editor
- [x] Tags Management
  - [x] Tag creation, editing, merging
- [x] Comments Management
  - [x] Comments listing with moderation tools
  - [x] Comment reply interface
- [x] Dashboard Search
  - [x] Global search functionality across all content types
  - [x] Advanced search interface with filters
- [x] Editorial Workflow
  - [x] Content approval workflow with draft/review/published states
- [x] Analytics Dashboard
  - [x] Content performance metrics
  - [x] User engagement statistics
- [x] Improved Toast System
  - [x] Toast queue management
  - [x] Different toast types (success, error, warning, info)
  - [x] Action buttons in toasts
- [x] AI Integration
  - [x] Content analysis tools

### Backend API Implementation

- [x] Stats endpoints for dashboard
- [x] CRUD endpoints for all dashboard entities
- [x] Proper pagination, filtering, and sorting for list endpoints
- [x] Authentication middleware with role-based access control

### Reading Experience Improvements

- [x] Enhanced Annotation System
  - [x] Inline annotation creation
  - [x] Better visualization of annotations
  - [x] Filtering annotations by type/author
- [x] Reading Progress Tracking
  - [x] Resume reading functionality
  - [x] Reading statistics dashboard
- [x] Improved Translation Comparison
  - [x] Side-by-side view with synchronized scrolling
- [x] Social Features
  - [x] Shared annotations
  - [x] Discussion threads

### Infrastructure and Performance

- [x] Optimize API endpoints for performance
- [x] Implement proper error logging and monitoring
- [x] Optimize front-end bundle size and loading performance

### Technical Debt

- [x] Refactor duplicated code into shared components
- [x] Improve type safety throughout the application
- [x] Standardize error handling across the application
- [x] Implement proper form validation throughout

---

## 🎯 Outstanding Tasks

**See GitHub Issues for detailed tracking:**

### Frontend Issues

- **Issue #48:** Complete Missing Dashboard Components (Annotation Editor, Author Editor, Blog Preview, Comparison View)
- **Issue #49:** Implement Automated Testing Infrastructure (Vitest, React Testing Library, Playwright)
- **Issue #50:** Optimize Frontend Performance & Bundle Size
- **Issue #51:** Implement PWA & Cross-Browser Compatibility
- **Issue #52:** Implement Error Tracking & Monitoring (Sentry)

### Backend Issues

- **Issue #30:** Full-Text Search with Weaviate
- **Issue #31:** Distributed Tracing with OpenTelemetry
- **Issue #32:** Prometheus Metrics & Grafana Dashboards
- **Issue #33:** Structured Logging Enhancement
- **Issue #34:** Read Models (DTOs) for Efficient Queries
- **Issue #35:** Redis Caching Strategy
- **Issue #36:** Production Deployment Automation
- **Issue #37:** Security Hardening
- **Issue #38:** Kubernetes Infrastructure as Code