PROJECT_LOG.md

PDF Tracker - Log de proyecto

Resumen ejecutivo

PDF Tracker nació como una herramienta para gestionar PDFs leídos y no leídos, añadir keywords y comentarios, y localizar fácilmente cada documento.

El enfoque cambió durante el desarrollo:

• primero se planteó como una app que subía el PDF y lo guardaba en papers/
• después se vio que, para tu caso, era mejor no copiar ni mover archivos
• el resultado actual es una herramienta de registro por rutas, más simple y más coherente con tu uso real

Cronología de cambios

1. Definición inicial del proyecto

• Se definió el proyecto pdf-tracker.
• Objetivo inicial: subir PDFs, clasificarlos y seguir su estado de lectura.
• Se decidió que no hacía falta leer el contenido del PDF automáticamente.

2. Primera versión funcional

Se montó una primera base con:

• Node.js + Express
• SQLite
• interfaz web simple
• estado de lectura (unread, reading, read)
• keywords
• comentarios
• filtros por estado y keyword

3. Etapa con carpeta papers/

Durante una fase intermedia, la app:

• aceptaba subida de PDFs
• los guardaba en una carpeta local papers/
• mantenía el registro en SQLite

Además se añadió:

• edición inline desde la interfaz
• actualización de título, estado, keywords y comentarios

4. Seguimiento de rutas

Después se añadió soporte para:

• ruta original
• ruta actual
• edición de ambas rutas desde la interfaz

La idea era no perder el registro aunque el PDF cambiara de sitio.

5. Cambio de enfoque clave

Más adelante se decidió algo importante:

• la app no debía guardar ni copiar el PDF
• solo debía registrar dónde está

Motivo:

• encaja mejor con tu flujo real
• evita duplicar archivos
• permite tener los PDFs donde tú quieras, incluido Windows o discos externos

6. Reconversión a registro por rutas

Se rehizo PDF Tracker para que:

• ya no suba archivos
• ya no dependa de papers/
• solo almacene metadatos y rutas en la base de datos

La interfaz pasó a registrar:

• título
• ruta actual
• ruta original
• estado
• keywords
• comentarios

7. Limpieza final

• Se eliminó el último registro que seguía apuntando a papers/
• Se envió la carpeta papers/ a la papelera
• Se dejó el proyecto funcionando como registro puro

8. Mejora de localización

Se añadió al lado de la ruta actual:

• botón Abrir ruta
• botón Copiar ruta

Esto facilita localizar el documento, aunque algunos navegadores pueden limitar la apertura directa de rutas locales.

Estado actual del proyecto

Ahora PDF Tracker hace esto:

• registra PDFs por ruta
• guarda ruta original y ruta actual
• permite marcar estado de lectura
• permite añadir y editar keywords
• permite añadir y editar comentarios
• permite editar rutas después
• permite filtrar por estado y keyword
• permite borrar el registro sin tocar el archivo físico

Stack actual

• Node.js
• Express
• SQLite
• interfaz web simple

Rutas actuales del proyecto

• Proyecto: /home/norwi/.openclaw/workspace/projects/pdf-tracker
• Base de datos: /home/norwi/.openclaw/workspace/projects/pdf-tracker/data/pdf-tracker.sqlite
• Interfaz: http://localhost:3001

Notas importantes

• La app no mueve el PDF.
• La app no copia el PDF.
• La app no lee el contenido del PDF.
• La app solo mantiene un registro útil para localizarlo y gestionarlo.

Próximas mejoras razonables

• búsqueda por título y comentarios
• mejor apertura de rutas locales según plataforma
• botón más claro de localización/copia de ruta
• vista detalle más cómoda por documento