docs: add translation status tracking document
Document current state of Spanish-to-English translation effort across the codebase. Shows completed agenticReadiness module and identifies 16 pending modules with effort estimates. https://claude.ai/code/session_check-agent-readiness-status-Exnpc
This commit is contained in:
163
TRANSLATION_STATUS.md
Normal file
163
TRANSLATION_STATUS.md
Normal file
@@ -0,0 +1,163 @@
|
||||
# Translation Status - Beyond CX Analytics
|
||||
|
||||
## ✅ Completed Modules
|
||||
|
||||
### Agentic Readiness Module
|
||||
- **Status:** ✅ **COMPLETED**
|
||||
- **Commit:** `b991824`
|
||||
- **Files:**
|
||||
- ✅ `frontend/utils/agenticReadinessV2.ts` - All functions, comments, and descriptions translated
|
||||
- ✅ `frontend/components/tabs/AgenticReadinessTab.tsx` - RED_FLAG_CONFIGS and comments translated
|
||||
- ✅ `frontend/locales/en.json` & `es.json` - New subfactors section added
|
||||
- ✅ `backend/beyond_flows/scorers/agentic_score.py` - All docstrings, comments, and reason codes translated
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Modules Pending Translation
|
||||
|
||||
### HIGH PRIORITY - Core Utils (Frontend)
|
||||
|
||||
#### 1. **realDataAnalysis.ts**
|
||||
- **Lines of Spanish:** ~92 occurrences
|
||||
- **Scope:**
|
||||
- Function names: `clasificarTierSimple()`, `clasificarTier()`
|
||||
- 20+ inline comments in Spanish
|
||||
- Function documentation
|
||||
- **Impact:** HIGH - Core analysis engine
|
||||
- **Estimated effort:** 2-3 hours
|
||||
|
||||
#### 2. **analysisGenerator.ts**
|
||||
- **Lines of Spanish:** ~49 occurrences
|
||||
- **Scope:**
|
||||
- Multiple inline comments
|
||||
- References to `clasificarTierSimple()`
|
||||
- Data transformation comments
|
||||
- **Impact:** HIGH - Main data generator
|
||||
- **Estimated effort:** 1-2 hours
|
||||
|
||||
#### 3. **backendMapper.ts**
|
||||
- **Lines of Spanish:** ~13 occurrences
|
||||
- **Scope:**
|
||||
- Function documentation
|
||||
- Mapping logic comments
|
||||
- **Impact:** MEDIUM - Backend integration
|
||||
- **Estimated effort:** 30-60 minutes
|
||||
|
||||
---
|
||||
|
||||
### MEDIUM PRIORITY - Utilities (Frontend)
|
||||
|
||||
#### 4. **dataTransformation.ts**
|
||||
- **Lines of Spanish:** ~8 occurrences
|
||||
- **Impact:** MEDIUM
|
||||
- **Estimated effort:** 30 minutes
|
||||
|
||||
#### 5. **segmentClassifier.ts**
|
||||
- **Lines of Spanish:** ~3 occurrences
|
||||
- **Impact:** LOW
|
||||
- **Estimated effort:** 15 minutes
|
||||
|
||||
#### 6. **fileParser.ts**
|
||||
- **Lines of Spanish:** ~3 occurrences
|
||||
- **Impact:** LOW
|
||||
- **Estimated effort:** 15 minutes
|
||||
|
||||
#### 7. **apiClient.ts**
|
||||
- **Lines of Spanish:** ~2 occurrences
|
||||
- **Impact:** LOW
|
||||
- **Estimated effort:** 10 minutes
|
||||
|
||||
#### 8. **serverCache.ts**
|
||||
- **Lines of Spanish:** ~2 occurrences
|
||||
- **Impact:** LOW
|
||||
- **Estimated effort:** 10 minutes
|
||||
|
||||
---
|
||||
|
||||
### MEDIUM PRIORITY - Backend Dimensions
|
||||
|
||||
#### 9. **backend/beyond_metrics/dimensions/OperationalPerformance.py**
|
||||
- **Lines of Spanish:** ~7 occurrences
|
||||
- **Impact:** MEDIUM
|
||||
- **Estimated effort:** 30 minutes
|
||||
|
||||
#### 10. **backend/beyond_metrics/dimensions/SatisfactionExperience.py**
|
||||
- **Lines of Spanish:** ~8 occurrences
|
||||
- **Impact:** MEDIUM
|
||||
- **Estimated effort:** 30 minutes
|
||||
|
||||
#### 11. **backend/beyond_metrics/dimensions/EconomyCost.py**
|
||||
- **Lines of Spanish:** ~4 occurrences
|
||||
- **Impact:** MEDIUM
|
||||
- **Estimated effort:** 20 minutes
|
||||
|
||||
---
|
||||
|
||||
### LOW PRIORITY - API & Services
|
||||
|
||||
#### 12. **backend/beyond_api/api/analysis.py**
|
||||
- **Lines of Spanish:** ~1 occurrence
|
||||
- **Impact:** LOW
|
||||
- **Estimated effort:** 5 minutes
|
||||
|
||||
#### 13. **backend/beyond_api/api/auth.py**
|
||||
- **Lines of Spanish:** ~1 occurrence
|
||||
- **Impact:** LOW
|
||||
- **Estimated effort:** 5 minutes
|
||||
|
||||
#### 14. **backend/beyond_api/services/analysis_service.py**
|
||||
- **Lines of Spanish:** ~2 occurrences
|
||||
- **Impact:** LOW
|
||||
- **Estimated effort:** 10 minutes
|
||||
|
||||
#### 15. **backend/beyond_metrics/io/base.py**
|
||||
- **Lines of Spanish:** ~1 occurrence
|
||||
- **Impact:** LOW
|
||||
- **Estimated effort:** 5 minutes
|
||||
|
||||
#### 16. **backend/beyond_metrics/io/google_drive.py**
|
||||
- **Lines of Spanish:** ~2 occurrences
|
||||
- **Impact:** LOW
|
||||
- **Estimated effort:** 10 minutes
|
||||
|
||||
---
|
||||
|
||||
## 📊 Summary Statistics
|
||||
|
||||
| Category | Files | Total Occurrences | Estimated Time |
|
||||
|----------|-------|-------------------|----------------|
|
||||
| ✅ Completed | 4 | ~150 | 3 hours (DONE) |
|
||||
| 🔴 High Priority | 3 | 154 | 4-6 hours |
|
||||
| 🟡 Medium Priority | 8 | 35 | 2-3 hours |
|
||||
| 🟢 Low Priority | 5 | 7 | 45 minutes |
|
||||
| **TOTAL PENDING** | **16** | **196** | **~8 hours** |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Recommended Translation Order
|
||||
|
||||
### Phase 1: Critical Path (High Priority)
|
||||
1. `realDataAnalysis.ts` - Core analysis engine with `clasificarTier()` functions
|
||||
2. `analysisGenerator.ts` - Main data generation orchestrator
|
||||
3. `backendMapper.ts` - Backend integration layer
|
||||
|
||||
### Phase 2: Supporting Utils (Medium Priority)
|
||||
4. `dataTransformation.ts`
|
||||
5. Backend dimension files (`OperationalPerformance.py`, `SatisfactionExperience.py`, `EconomyCost.py`)
|
||||
|
||||
### Phase 3: Final Cleanup (Low Priority)
|
||||
6. Remaining utility files and API services
|
||||
|
||||
---
|
||||
|
||||
## 📝 Notes
|
||||
|
||||
- **Variable names** like `volumen_mes`, `escalación`, etc. in data interfaces should **remain as-is** for API compatibility
|
||||
- **Function names** that are part of the public API should be carefully reviewed before renaming
|
||||
- **i18n strings** in locales files should continue to have both EN/ES versions
|
||||
- **Reason codes** and internal enums should be in English for consistency
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** 2026-02-07
|
||||
**Status:** agenticReadiness module completed, 16 modules pending
|
||||
Reference in New Issue
Block a user