Skip to content
eduin1178Public

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Marea

Vista del tablero de Marea en modo oscuro

Clon local de Trello para organizar tareas sin cuentas. Implementa specs/spec.md con Next.js 16, React, dnd-kit, SQLite y Tauri 2. La interfaz está en español e incluye un pequeño tablero de ejemplo editable.

Ejecutar en Windows

Requisitos: Node.js 20.9+ (probado con 24), Rust 1.90+, las herramientas C++ de Visual Studio, Windows SDK y WebView2.

npm ci
npm run desktop:dev

desktop:dev inicia Next.js y la ventana nativa. Para generar el instalador:

npm run desktop:build

El ejecutable queda en src-tauri/target/release/marea.exe y el instalador NSIS en src-tauri/target/release/bundle/nsis/. Para una compilación de depuración, añade -- --debug; los artefactos quedan en target/debug/.

El lanzador scripts/desktop.mjs detecta una instalación completa de MSVC x64 y configura las variables solo para el proceso de compilación. Esto evita que una instalación más reciente e incompleta de Visual Studio oculte una funcional. No modifica la configuración del sistema.

Ejecutar en navegador

npm run dev

Abre http://localhost:3000. Para probar la exportación estática:

npm run build
npm start

npm start sirve out/ exclusivamente en la interfaz local. La versión de escritorio incorpora estos archivos; no necesita un servidor Node ni conexión a Internet para funcionar. Los recursos de SQLite se copian desde node_modules al iniciar o compilar, sin CDN ni fuentes externas.

Uso

  • Tableros: crea pestañas horizontales y reordénalas desde el asa. Configura nombre, descripción y color.
  • Listas: crea, renombra, cambia el color, reordena y mueve entre tableros desde su configuración.
  • Tarjetas: arrastra desde el asa para ordenar o cambiar de lista. Abre el detalle para editar título, descripción y color, completar/reordenar una checklist, añadir comentarios o elegir otra ubicación.
  • Fechas y etiquetas: en el detalle ampliado, usa «Fecha» para elegir inicio y terminación (con hora) y «Etiquetas» para asignar, buscar, crear o editar etiquetas de colores. Las etiquetas se comparten en tu espacio. El seguimiento permanece a la derecha en pantallas amplias.
  • Bandeja: captura tareas sin tablero ni lista. La bandeja lateral permanece fija al cambiar de tablero: escribe una idea y pulsa Enter o +, y arrástrala directamente a una lista.
  • Archivo: ábrelo desde el pie del lateral, encima del perfil. Busca tarjetas y listas por separado. Restaurar una lista conserva sus tarjetas; las archivadas individualmente siguen archivadas. Una tarjeta recuperada desde una lista todavía archivada se envía a la bandeja.
  • Teclado: enfoca un asa, pulsa espacio, usa las flechas y confirma con espacio; Escape cancela. Los diálogos mantienen el foco y se cierran con Escape.
  • Apariencia: el icono de luna/sol junto al estado de guardado alterna entre modo claro y oscuro y recuerda la preferencia. La ayuda está en el icono de interrogación de esa misma barra.
  • Bandeja del sistema (Windows): cerrar la ventana la oculta y mantiene Marea abierta. Un clic en su icono vuelve a mostrarla. Con clic derecho, «Salir» termina la aplicación después de guardar; si el guardado falla, la ventana permanece abierta para reintentar.
  • Guardado automático: cada edición se encola inmediatamente. Espera el indicador «Todo guardado» antes de salir. Si una escritura falla, la app conserva los cambios en memoria y ofrece reintentar.

Datos locales

En Tauri se usa @tauri-apps/plugin-sql con el archivo %APPDATA%/com.edunet.marea/marea.db en Windows. Puedes respaldarlo con la aplicación cerrada. Solo se permite una instancia nativa por usuario.

En navegador se usa SQLite real mediante sql.js; el archivo binario se persiste en IndexedDB (marea, almacén database, clave workspace.sqlite). Cada origen/perfil tiene datos independientes de la aplicación nativa. Borrar los datos del sitio también borra este espacio. Un bloqueo de Web Locks evita escrituras simultáneas desde dos pestañas; se requiere localhost o HTTPS.

La tabla workspace contiene una única instantánea JSON versionada. Un UPSERT atómico conserva relaciones y orden en la misma escritura; Zod valida el esquema y las referencias al cargar y guardar. No hay sincronización remota, autenticación ni telemetría. Un formato desconocido o un archivo dañado muestran un error, sin reiniciar ni sobrescribir los datos.

Verificación

npm run lint
npx tsc --noEmit
npm test
npm run build
npm run test:e2e
npm run desktop:check

Playwright usa Google Chrome instalado y un servidor aislado en el puerto 3100. Las pruebas cubren persistencia tras recarga, bandeja y asignación, checklist y comentarios, archivo/restauración, arrastre, teclado, pantalla pequeña, exclusión entre pestañas y recuperación tras errores de escritura. npm test verifica las reglas de movimiento, archivo y validación de datos.

Estructura

  • components/: interfaz, tableros, detalle y controles compartidos.
  • lib/model.ts: esquema versionado y operaciones de dominio.
  • lib/storage.ts: repositorios SQLite nativo/navegador.
  • lib/use-workspace.ts: estado, cola de guardado y protección de cierre.
  • src-tauri/: aplicación Rust, permisos e instalador.
  • tests/: pruebas de dominio y recorridos de navegador.

La integración sigue las guías oficiales de Tauri con Next.js y del plugin SQL.

Licencia

Marea se distribuye bajo la licencia MIT.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages