excel-planner/docs/TABLERO_HTML_SYNC.md

Sincronizar Planner con Tablero HTML v7

El archivo Tablero_proyectos_v7.html no se modifica. Lee datos desde una Google Sheet publicada como TSV.

Flujo

python script.py
python sync_dashboard.py

Abre el HTML en el navegador: mostrará los datos de Planner.

Modo manual (sin Google API)

Si aún no tienes cuenta de servicio:

python sync_dashboard.py --tsv-only

Esto genera output/dashboard_rtc.tsv. Importa ese archivo a la Google Sheet que publica el HTML (Archivo → Importar → Reemplazar hoja actual).

Configuración automática (Google Sheets API)

1. Obtener el ID de la hoja

Abre la Google Sheet en el navegador. La URL tiene este formato:

https://docs.google.com/spreadsheets/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit

Copia el ID (1AbCdEfGhIjKlMnOpQrStUvWxYz) a .env:

GOOGLE_SPREADSHEET_ID=1AbCdEfGhIjKlMnOpQrStUvWxYz
GOOGLE_SHEET_NAME=Hoja 1

Nota: El ID de publicación (/d/e/2PACX-...) del HTML es distinto. Para escribir datos necesitas el ID de edición.

2. Cuenta de servicio

1. En Google Cloud Console, crea un proyecto.
2. Habilita Google Sheets API.
3. Crea una cuenta de servicio y descarga el JSON.
4. Guarda el archivo en credentials/google_service_account.json.
5. Comparte la Google Sheet con el email de la cuenta de servicio (rol: Editor).

3. Variables en .env

GOOGLE_SPREADSHEET_ID=tu_id_de_hoja
GOOGLE_SHEET_NAME=Hoja 1
GOOGLE_CREDENTIALS_PATH=credentials/google_service_account.json

4. Sincronizar

pip install -r requirements.txt
python sync_dashboard.py

Mapeo Planner → columnas del HTML

Columna HTML	Origen Planner
id	plan_id
nombre	proyecto
estadoGlobal	Completado o En curso
progreso	porcentaje_avance
fechaObjetivo	Última fecha_vencimiento del plan
comentarioRetraso	Ninguno o X tareas vencidas
tarea	tarea
responsable	asignados
fechaFin	fecha_vencimiento (YYYY-MM-DD)
estado	porcentaje como 50% o 100%