veza/veza-backend-api/docs/TODOS_AUDIT.md

# TODOs Audit Report

**Date**: 2025-01-27  
**Total TODOs/FIXMEs/HACKs/XXXs Found**: 31  
**Phase 3 Update (2026-02)**: Audit refreshed. P1/P2 items tracked for next sprint. Read replicas (3.7) and CDN backend wiring documented.

## Summary

This document lists all TODO, FIXME, HACK, and XXX comments found in the codebase, categorized by priority and status.

## Priority Categories

- **P0**: Critical - Blocks functionality or security
- **P1**: High - Important for production readiness
- **P2**: Medium - Quality of life improvements
- **P3**: Low - Nice to have, technical debt

## Status

- **Open**: Not yet addressed
- **In Progress**: Currently being worked on
- **Resolved**: Completed
- **Deferred**: Postponed to future work

---

## TODOs by File

### `internal/core/track/service.go`
- **TODO(P2-GO-018)**: Enqueue job pour traitement asynchrone (metadata, waveform, etc.) selon ORIGIN_ASYNC_PROCESSING
  - **Priority**: P2
  - **Status**: Open
  - **Category**: Performance optimization

### `internal/core/track/handler.go`
- ~~**TODO(P2-GO-004)**: trackUploadService attend int64 - Migration UUID partielle à compléter~~
- ~~**TODO(P2-GO-004)**: Migration UUID partielle - trackUploadService nécessite migration vers UUID~~
  - **Status**: **Resolved** (2026-02) — trackUploadService utilise uuid.UUID (GetUploadProgress, UpdateUploadStatus, GetUploadStats)

### `internal/database/database.go`
- **TODO**: Implémenter OAuth user lookup
  - **Priority**: P2
  - **Status**: Open
  - **Category**: Feature incomplete
- **TODO**: Implémenter avec vraie DB (3 occurrences)
  - **Priority**: P2
  - **Status**: Open
  - **Category**: Implementation placeholder

### `internal/handlers/oauth_handlers.go`
- ~~**TODO**: Get from config (frontendURL hardcoded)~~
  - **Status**: **Resolved** (2026-02) — frontendURL lu depuis config.FrontendURL (FRONTEND_URL or VITE_FRONTEND_URL)

### `internal/handlers/session.go`
- **TODO**: Déterminer si c'est la session actuelle
  - **Priority**: P2
  - **Status**: Open
  - **Category**: Feature incomplete

### `internal/logging/logger.go`
- **TODO**: Implémenter avec AtomicLevel lors de la création du logger
  - **Priority**: P2
  - **Status**: Open
  - **Category**: Enhancement

### `internal/repositories/playlist_collaborator_repository.go`
- ~~**FIXME**: Assurer que le modèle PlaylistCollaborator utilise UUID~~
  - **Status**: **Resolved** (2026-02) — Interface et modèle utilisent uuid.UUID

### `internal/services/playlist_version_service.go`
- ~~**FIXME**: models.PlaylistVersion ID types need check. Assuming repo handles UUID if struct updated.~~
  - **Status**: **Resolved** (2026-02) — models.PlaylistVersion utilise uuid.UUID (ID, PlaylistID, UserID)

### `internal/services/track_history_service.go`
- ~~**FIXME**: models.TrackHistory needs UUID too if not updated~~
  - **Status**: **Resolved** (2026-02) — models.TrackHistory et RecordHistoryParams utilisent uuid.UUID

### `internal/services/job_service.go`
- **TODO**: Intégrer asynq ou autre système de queue (3 occurrences)
  - **Priority**: P2
  - **Status**: Open
  - **Category**: Architecture

### `internal/services/playlist_service.go`
- ~~**FIXME**: PlaylistVersionService likely needs update for UUID too, but assuming it takes what we give or we handle it later~~
  - **Status**: **Resolved** (2026-02) — PlaylistVersionService et modèles alignés sur UUID

### `internal/api/archive/api_manager.go` (archived, build-ignored)
- **TODO**: Réactiver api_manager.go après stabilisation du noyau et alignement des services (graphql, grpc, websocket, features)
  - **Priority**: P3
  - **Status**: Deferred (fichier archivé)
  - **Category**: Future feature
- **TODO**: Implement feature start
  - **Priority**: P3
  - **Status**: Deferred
  - **Category**: Future feature
- **TODO**: Implement feature stop
  - **Priority**: P3
  - **Status**: Deferred
  - **Category**: Future feature
- **TODO**: Implement comprehensive metrics collection
  - **Priority**: P2
  - **Status**: Open
  - **Category**: Enhancement

### `internal/api/user/service.go`
- **TODO**: Parse JSON strings to structs (simplified for now)
  - **Priority**: P2
  - **Status**: Open
  - **Category**: Implementation placeholder
- **TODO**: Serialize structs to JSON (simplified for now)
  - **Priority**: P2
  - **Status**: Open
  - **Category**: Implementation placeholder

### `internal/api/handlers/chat_handlers.go`
- **TODO**: Réactiver chat_handlers après stabilisation du noyau et alignement des services (ChatService, MessageType, RoomType)
  - **Priority**: P3
  - **Status**: Deferred
  - **Category**: Future feature

### `internal/api/handlers/two_factor_handlers.go`
- **TODO**: Réactiver two_factor_handlers après stabilisation du noyau et alignement des services (AuthService.GetUserByID)
  - **Priority**: P3
  - **Status**: Deferred
  - **Category**: Future feature

### `internal/api/admin/service.go`
- **TODO**: Implement based on doc_admin_handler.md (3 occurrences)
  - **Priority**: P2
  - **Status**: Open
  - **Category**: Feature incomplete

### `internal/config/config.go`
- **TODO**: Améliorer la configuration CORS dans api/router.go pour utiliser c.CORSOrigins depuis la config
  - **Priority**: P2
  - **Status**: Open
  - **Category**: Code quality

### `cmd/modern-server/main.go`
- **TODO**: Réactiver internal/api/handlers après stabilisation du noyau
  - **Priority**: P3
  - **Status**: Deferred (file deprecated)
  - **Category**: Legacy code
- **TODO**: Réactiver services après stabilisation du noyau
  - **Priority**: P3
  - **Status**: Deferred (file deprecated)
  - **Category**: Legacy code
- **TODO**: Utiliser cfg.LogLevel pour déterminer le mode
  - **Priority**: P2
  - **Status**: Deferred (file deprecated)
  - **Category**: Legacy code
- **TODO**: Ajouter ReadTimeout et WriteTimeout si nécessaire
  - **Priority**: P2
  - **Status**: Deferred (file deprecated)
  - **Category**: Legacy code
- **TODO**: Utiliser config pour timeout
  - **Priority**: P2
  - **Status**: Deferred (file deprecated)
  - **Category**: Legacy code

---

## Summary by Priority

- **P0**: 0 items
- **P1**: 0 items (UUID migration completed — 7 items resolved 2026-02)
- **P2**: 18 items (various improvements)
- **P3**: 6 items (deferred/future features)

## Recommendations

1. ~~**P1 Items (UUID Migration)**~~: Completed (2026-02)
2. **P2 Items**: Prioritize based on impact and effort
3. **P3 Items**: Defer to future sprints or remove if no longer relevant

## Action Items

1. Create GitHub issues for P1 items
2. Review P2 items and prioritize
3. Remove or update P3 items in deprecated code
4. Update this document as TODOs are resolved

---

**Last Updated**: 2026-02-17  
**Maintained By**: Veza Backend Team