@nextsparkjs/theme-default 0.1.0-beta.1

package/entities/tasks/messages/es.json

@@ -0,0 +1,204 @@
+{
+  "title": "Mis Tareas",
+  "subtitle": "Organiza tu trabajo y mantén el control de tus proyectos.",
+  "description": "Organiza tu trabajo y mantén el control de tus proyectos.",
+  "stats": {
+    "active": "Activas",
+    "completed": "Completadas",
+    "total": "Total de Tareas",
+    "totalDescription": "Todas las tareas del sistema",
+    "pending": "Pendientes",
+    "pendingDescription": "Tareas esperando ser completadas",
+    "overdue": "Vencidas"
+  },
+  "form": {
+    "addTitle": "Agregar Nueva Tarea",
+    "addDescription": "Crea una nueva tarea para mantener el control de lo que necesitas hacer",
+    "titleLabel": "Título de la tarea",
+    "titlePlaceholder": "¿Qué necesitas hacer?",
+    "titleDescription": "Ingresa el título de la nueva tarea. Este campo es obligatorio.",
+    "descriptionLabel": "Descripción de la tarea (opcional)",
+    "descriptionPlaceholder": "Agrega una descripción (opcional)",
+    "descriptionHelp": "Descripción opcional para proporcionar más detalles sobre la tarea.",
+    "addButton": "Agregar Tarea",
+    "adding": "Agregando...",
+    "enterTitle": "Ingresa un título para habilitar el botón de crear tarea",
+    "creating": "Creando tarea, por favor espera",
+    "pressToCreate": "Presiona para crear la nueva tarea",
+    "addSuccess": "¡Tarea agregada exitosamente!",
+    "addError": "Error al agregar tarea",
+    "tryAgain": "Por favor intenta de nuevo más tarde",
+    "taskCreated": "Tarea \"{title}\" creada correctamente",
+    "createError": "Error al crear la tarea \"{title}\""
+  },
+  "task": {
+    "completed": "completada",
+    "active": "activa",
+    "deleteConfirm": "¿Estás seguro de que quieres eliminar esta tarea?",
+    "deleteSuccess": "Tarea eliminada exitosamente",
+    "toggleSuccess": "Estado de tarea actualizado"
+  },
+  "overview": {
+    "title": "Resumen de Tareas",
+    "label": "Resumen de tareas",
+    "activeTasks": "{count} tareas activas",
+    "completedTasks": "{count} tareas completadas",
+    "totalTasks": "{count} tareas en total"
+  },
+  "actions": {
+    "completed": "¡Tarea completada!",
+    "reactivated": "¡Tarea reactivada!",
+    "deleted": "Tarea eliminada",
+    "markCompleted": "completada",
+    "markPending": "pendiente",
+    "taskStatusChanged": "Tarea \"{title}\" {action}",
+    "taskDeleted": "Tarea \"{title}\" eliminada",
+    "toggleError": "Error al cambiar el estado de la tarea \"{title}\"",
+    "deleteError": "Error al eliminar tarea",
+    "updateError": "Error al actualizar tarea"
+  },
+  "status": {
+    "completed": "Completada",
+    "pending": "Pendiente",
+    "active": "Activa",
+    "todo": "Por Hacer",
+    "in-progress": "En Progreso",
+    "review": "En Revisión",
+    "done": "Completada",
+    "blocked": "Bloqueada"
+  },
+  "priority": {
+    "low": "Baja",
+    "medium": "Media",
+    "high": "Alta",
+    "urgent": "Urgente"
+  },
+  "fields": {
+    "status": "Estado",
+    "priority": "Prioridad",
+    "tags": "Etiquetas",
+    "dueDate": "Fecha Límite",
+    "estimatedHours": "Horas Estimadas",
+    "tagsPlaceholder": "Agregar etiquetas...",
+    "dueDatePlaceholder": "Seleccionar fecha límite...",
+    "estimatedHoursPlaceholder": "0",
+    "statusDescription": "Estado actual de la tarea",
+    "priorityDescription": "Nivel de prioridad de la tarea",
+    "tagsDescription": "Etiquetas para categorizar la tarea",
+    "dueDateDescription": "Fecha límite de la tarea",
+    "estimatedHoursDescription": "Tiempo estimado para completar (en horas)"
+  },
+  "sections": {
+    "activeTasks": "Tareas Activas",
+    "completedTasks": "Tareas Completadas"
+  },
+  "empty": {
+    "title": "Aún no tienes tareas",
+    "description": "¡Agrega tu primera tarea arriba para empezar!"
+  },
+  "accessibility": {
+    "taskCard": "Tarea: {title}. {status}. Presiona Enter para ver detalles.",
+    "completedTaskCard": "Tarea completada: {title}. Presiona Enter para ver detalles.",
+    "toggleTask": "Marcar tarea \"{title}\" como {action}",
+    "reactivateTask": "Reactivar tarea completada \"{title}\"",
+    "deleteTask": "Eliminar tarea \"{title}\"",
+    "deleteCompletedTask": "Eliminar tarea completada \"{title}\"",
+    "createdDate": "Creada el {date}",
+    "completedDate": "Completada el {date}"
+  },
+  "time": {
+    "daysAgo": "hace {count} día{count, plural, one {} other {s}}",
+    "hoursAgo": "hace {count} hora{count, plural, one {} other {s}}",
+    "minutesAgo": "hace {count} minuto{count, plural, one {} other {s}}",
+    "justNow": "hace un momento"
+  },
+  "page": {
+    "statsAriaLabel": "Estadísticas de tareas",
+    "listTitle": "Lista de Tareas",
+    "listDescription": "Gestiona tus tareas pendientes y organizate mejor",
+    "today": "Hoy"
+  },
+  "list": {
+    "title": "Lista de Tareas",
+    "description": "Gestiona todas tus tareas en un solo lugar",
+    "allTasks": "Todas las Tareas"
+  },
+  "detail": {
+    "loading": {
+      "message": "Cargando detalles de la tarea",
+      "ariaLabel": "Cargando detalles de la tarea",
+      "srText": "Cargando detalles de la tarea..."
+    },
+    "navigation": {
+      "backToTasks": "Volver a Tareas",
+      "backAriaLabel": "Volver a la lista de tareas",
+      "returnNavigation": "Navegación de retorno",
+      "viewAllTasks": "Ver todas las tareas",
+      "viewAllDescription": "Navegar de vuelta a la lista completa de tareas"
+    },
+    "error": {
+      "notFound": "No se pudo encontrar la tarea solicitada. Es posible que haya sido eliminada o no tengas permisos para verla.",
+      "title": "Tarea no encontrada"
+    },
+    "status": {
+      "completed": "Completada",
+      "pending": "Pendiente",
+      "active": "En progreso",
+      "completedAriaLabel": "Tarea completada",
+      "pendingAriaLabel": "Tarea pendiente"
+    },
+    "priority": {
+      "high": "Alta",
+      "medium": "Media", 
+      "low": "Baja",
+      "label": "Prioridad"
+    },
+    "categories": {
+      "design": "Diseño",
+      "development": "Desarrollo",
+      "meetings": "Reuniones",
+      "documentation": "Documentación",
+      "testing": "Testing",
+      "general": "General"
+    },
+    "sections": {
+      "description": "Descripción",
+      "actions": "Acciones",
+      "information": "Información",
+      "classification": "Clasificación",
+      "metadata": "Metadatos de la tarea"
+    },
+    "actions": {
+      "title": "Acciones",
+      "description": "Gestiona el estado y opciones de esta tarea. Atajos de teclado: Cmd+Enter para completar, Cmd+Backspace para eliminar.",
+      "markPending": "Marcar Pendiente",
+      "markCompleted": "Marcar Completada",
+      "delete": "Eliminar",
+      "markPendingAriaLabel": "Marcar tarea \"{title}\" como pendiente. Atajo: Cmd+Enter",
+      "markCompletedAriaLabel": "Marcar tarea \"{title}\" como completada. Atajo: Cmd+Enter",
+      "deleteAriaLabel": "Eliminar permanentemente la tarea \"{title}\" Atajo: Cmd+Backspace"
+    },
+    "info": {
+      "created": "Creada",
+      "lastUpdate": "Última actualización",
+      "status": "Estado",
+      "priority": "Prioridad",
+      "category": "Categoría",
+      "taskId": "ID de la tarea",
+      "noDescription": "No hay descripción disponible para esta tarea.",
+      "inferredInfo": "Información inferida automáticamente"
+    },
+    "messages": {
+      "taskCompleted": "Tarea \"{title}\" completada correctamente",
+      "taskReactivated": "Tarea \"{title}\" reactivada correctamente", 
+      "taskDeleted": "Tarea \"{title}\" eliminada correctamente",
+      "toggleError": "Error al cambiar el estado de la tarea \"{title}\"",
+      "deleteError": "Error al eliminar la tarea \"{title}\"",
+      "completedToast": "Tarea completada",
+      "reactivatedToast": "Tarea reactivada",
+      "deletedToast": "Tarea eliminada",
+      "updateErrorToast": "Error al actualizar la tarea",
+      "deleteErrorToast": "Error al eliminar la tarea"
+    }
+  }
+}

package/entities/tasks/migrations/001_tasks_table.sql

@@ -0,0 +1,105 @@
+-- Migration: 001_tasks_table.sql
+-- Description: Tasks (table, indexes, RLS)
+-- Date: 2025-01-19
+-- Updated: 2025-11-26 (Phase 2 - Team Isolation)
+
+-- ============================================
+-- TABLE
+-- ============================================
+DROP TABLE IF EXISTS public."tasks" CASCADE;
+
+CREATE TABLE IF NOT EXISTS public."tasks" (
+  -- Primary Key
+  id           TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+
+  -- Relational Fields (al inicio)
+  "userId"     TEXT NOT NULL REFERENCES public."users"(id) ON DELETE CASCADE,
+  "teamId"     TEXT NOT NULL REFERENCES public."teams"(id) ON DELETE CASCADE,
+
+  -- Entity-specific fields
+  title              TEXT NOT NULL,
+  description        TEXT,
+  completed          BOOLEAN DEFAULT false,
+  status             TEXT NOT NULL DEFAULT 'todo',
+  priority           TEXT NOT NULL DEFAULT 'medium',
+  tags               JSONB DEFAULT '[]'::jsonb,
+  "dueDate"          DATE,
+  "estimatedHours"   NUMERIC(5,2),
+
+  -- System fields
+  "createdAt"  TIMESTAMPTZ NOT NULL DEFAULT now(),
+  "updatedAt"  TIMESTAMPTZ NOT NULL DEFAULT now(),
+
+  -- Constraints
+  CONSTRAINT tasks_status_check CHECK (status IN ('todo', 'in-progress', 'review', 'done', 'blocked')),
+  CONSTRAINT tasks_priority_check CHECK (priority IN ('low', 'medium', 'high', 'urgent')),
+  CONSTRAINT tasks_estimated_hours_positive CHECK ("estimatedHours" IS NULL OR "estimatedHours" > 0)
+);
+
+COMMENT ON TABLE  public."tasks"                  IS 'Tasks table with team isolation via RLS';
+COMMENT ON COLUMN public."tasks"."userId"         IS 'Owner user id (user isolation handled at app level)';
+COMMENT ON COLUMN public."tasks"."teamId"         IS 'Team context for isolation';
+COMMENT ON COLUMN public."tasks".title            IS 'Task title or name';
+COMMENT ON COLUMN public."tasks".description      IS 'Detailed task description';
+COMMENT ON COLUMN public."tasks".completed        IS 'Task completion status (legacy)';
+COMMENT ON COLUMN public."tasks".status           IS 'Task status: todo, in-progress, review, done, blocked';
+COMMENT ON COLUMN public."tasks".priority         IS 'Task priority: low, medium, high, urgent';
+COMMENT ON COLUMN public."tasks".tags             IS 'Task tags for categorization';
+COMMENT ON COLUMN public."tasks"."dueDate"        IS 'Task deadline (date only)';
+COMMENT ON COLUMN public."tasks"."estimatedHours" IS 'Estimated time to complete in hours';
+
+-- ============================================
+-- TRIGGER updatedAt (uses Better Auth function)
+-- ============================================
+DROP TRIGGER IF EXISTS tasks_set_updated_at ON public."tasks";
+CREATE TRIGGER tasks_set_updated_at
+BEFORE UPDATE ON public."tasks"
+FOR EACH ROW EXECUTE FUNCTION public.set_updated_at();
+
+-- ============================================
+-- INDEXES
+-- ============================================
+CREATE INDEX IF NOT EXISTS idx_tasks_user_id         ON public."tasks"("userId");
+CREATE INDEX IF NOT EXISTS idx_tasks_team_id         ON public."tasks"("teamId");
+CREATE INDEX IF NOT EXISTS idx_tasks_user_team       ON public."tasks"("userId", "teamId");
+CREATE INDEX IF NOT EXISTS idx_tasks_user_created_at ON public."tasks"("userId", "createdAt");
+CREATE INDEX IF NOT EXISTS idx_tasks_completed       ON public."tasks"(completed);
+CREATE INDEX IF NOT EXISTS idx_tasks_status          ON public."tasks"(status);
+CREATE INDEX IF NOT EXISTS idx_tasks_priority        ON public."tasks"(priority);
+CREATE INDEX IF NOT EXISTS idx_tasks_due_date        ON public."tasks"("dueDate") WHERE "dueDate" IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_tasks_tags            ON public."tasks" USING GIN(tags);
+CREATE INDEX IF NOT EXISTS idx_tasks_user_status_due ON public."tasks"("userId", status, "dueDate");
+CREATE INDEX IF NOT EXISTS idx_tasks_team_created    ON public."tasks"("teamId", "createdAt" DESC);
+
+-- ============================================
+-- RLS
+-- ============================================
+ALTER TABLE public."tasks" ENABLE ROW LEVEL SECURITY;
+
+-- Cleanup existing policies
+DROP POLICY IF EXISTS "Tasks owner can do all" ON public."tasks";
+DROP POLICY IF EXISTS "Tasks team can do all"  ON public."tasks";
+DROP POLICY IF EXISTS tasks_owner_policy       ON public."tasks";
+DROP POLICY IF EXISTS tasks_owner_all          ON public."tasks";
+
+-- ============================
+-- RLS: TEAM ISOLATION ONLY
+-- ============================
+-- IMPORTANTE: RLS solo verifica team membership
+-- La lógica de access.shared (user isolation) se maneja a NIVEL APP
+-- Esto permite cambiar el comportamiento desde el config sin modificar RLS
+CREATE POLICY "Tasks team can do all"
+ON public."tasks"
+FOR ALL TO authenticated
+USING (
+  -- Superadmin bypass
+  public.is_superadmin()
+  OR
+  -- Team isolation: user must be member of the team
+  "teamId" = ANY(public.get_user_team_ids())
+)
+WITH CHECK (
+  public.is_superadmin()
+  OR
+  "teamId" = ANY(public.get_user_team_ids())
+);

package/entities/tasks/migrations/002_task_metas.sql

@@ -0,0 +1,85 @@
+-- Migration: 002_tasks_metas.sql
+-- Description: Tasks metas (table, indexes, RLS) - Updated to new conventions
+-- Date: 2025-01-19
+-- Updated: 2025-11-26 (Phase 2 - Team Isolation via parent)
+
+-- ============================================
+-- TABLE
+-- ============================================
+CREATE TABLE IF NOT EXISTS public."tasks_metas" (
+                                                    id             TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    "entityId"     TEXT NOT NULL REFERENCES public."tasks"(id) ON DELETE CASCADE,
+    "metaKey"      TEXT NOT NULL,
+    "metaValue"    JSONB NOT NULL DEFAULT '{}'::jsonb,
+    "dataType"     TEXT DEFAULT 'json',
+    "isPublic"     BOOLEAN NOT NULL DEFAULT false,
+    "isSearchable" BOOLEAN NOT NULL DEFAULT false,
+    "createdAt"    TIMESTAMPTZ NOT NULL DEFAULT now(),
+    "updatedAt"    TIMESTAMPTZ NOT NULL DEFAULT now(),
+    CONSTRAINT tasks_metas_unique_key UNIQUE ("entityId", "metaKey")
+    );
+
+COMMENT ON TABLE  public."tasks_metas"               IS 'Key-value metadata for tasks';
+COMMENT ON COLUMN public."tasks_metas"."entityId"    IS 'Reference to parent task (generic entityId)';
+COMMENT ON COLUMN public."tasks_metas"."metaKey"      IS 'Metadata key identifier';
+COMMENT ON COLUMN public."tasks_metas"."metaValue"    IS 'Metadata value in JSONB format';
+COMMENT ON COLUMN public."tasks_metas"."dataType"     IS 'Type hint for the value: json, string, number, boolean';
+COMMENT ON COLUMN public."tasks_metas"."isPublic"     IS 'Whether this metadata is publicly readable';
+COMMENT ON COLUMN public."tasks_metas"."isSearchable" IS 'Whether this metadata is searchable';
+
+-- ============================================
+-- TRIGGER updatedAt (uses Better Auth function)
+-- ============================================
+DROP TRIGGER IF EXISTS tasks_metas_set_updated_at ON public."tasks_metas";
+CREATE TRIGGER tasks_metas_set_updated_at
+    BEFORE UPDATE ON public."tasks_metas"
+    FOR EACH ROW EXECUTE FUNCTION public.set_updated_at();
+
+-- ============================================
+-- INDEXES
+-- ============================================
+CREATE INDEX IF NOT EXISTS idx_tasks_metas_entity_id      ON public."tasks_metas"("entityId");
+CREATE INDEX IF NOT EXISTS idx_tasks_metas_key           ON public."tasks_metas"("metaKey");
+CREATE INDEX IF NOT EXISTS idx_tasks_metas_is_public     ON public."tasks_metas"("isPublic") WHERE "isPublic" = true;
+CREATE INDEX IF NOT EXISTS idx_tasks_metas_is_searchable ON public."tasks_metas"("isSearchable") WHERE "isSearchable" = true;
+CREATE INDEX IF NOT EXISTS idx_tasks_metas_value_gin     ON public."tasks_metas" USING GIN ("metaValue");
+CREATE INDEX IF NOT EXISTS idx_tasks_metas_value_ops     ON public."tasks_metas" USING GIN ("metaValue" jsonb_path_ops);
+
+-- ============================================
+-- RLS
+-- ============================================
+ALTER TABLE public."tasks_metas" ENABLE ROW LEVEL SECURITY;
+
+-- Cleanup existing policies
+DROP POLICY IF EXISTS "Tasks metas owner can do all" ON public."tasks_metas";
+DROP POLICY IF EXISTS "Tasks metas team can do all"  ON public."tasks_metas";
+DROP POLICY IF EXISTS tasks_metas_owner_policy       ON public."tasks_metas";
+
+-- ============================
+-- RLS: TEAM ISOLATION VIA PARENT
+-- ============================
+-- Hereda el aislamiento del parent task via teamId
+-- La lógica de access.shared se maneja a NIVEL APP
+CREATE POLICY "Tasks metas team can do all"
+ON public."tasks_metas"
+FOR ALL TO authenticated
+USING (
+  -- Superadmin bypass
+  public.is_superadmin()
+  OR
+  -- Team isolation via parent task
+  EXISTS (
+    SELECT 1 FROM public."tasks" t
+    WHERE t.id = "entityId"
+      AND t."teamId" = ANY(public.get_user_team_ids())
+  )
+)
+WITH CHECK (
+  public.is_superadmin()
+  OR
+  EXISTS (
+    SELECT 1 FROM public."tasks" t
+    WHERE t.id = "entityId"
+      AND t."teamId" = ANY(public.get_user_team_ids())
+  )
+);

package/entities/tasks/migrations/sample_data.json

@@ -0,0 +1,77 @@
+[
+  {
+    "title": "Setup project repository and CI/CD pipeline",
+    "description": "Initialize git repository, configure GitHub Actions for automated testing and deployment",
+    "completed": false
+  },
+  {
+    "title": "Design database schema for user management",
+    "description": "Create ERD and database migrations for user authentication, roles, and permissions",
+    "completed": true
+  },
+  {
+    "title": "Implement API authentication middleware",
+    "description": "Develop JWT-based authentication system with refresh tokens and rate limiting",
+    "completed": false
+  },
+  {
+    "title": "Create responsive frontend components",
+    "description": "Build reusable React components with TypeScript and Tailwind CSS styling",
+    "completed": false
+  },
+  {
+    "title": "Write comprehensive unit tests",
+    "description": "Achieve 80%+ code coverage with Jest and React Testing Library",
+    "completed": false
+  },
+  {
+    "title": "Optimize database queries and indexing",
+    "description": "Analyze slow queries and implement proper database indexes for performance",
+    "completed": true
+  },
+  {
+    "title": "Integrate payment processing system",
+    "description": "Implement Stripe integration for subscription management and billing",
+    "completed": false
+  },
+  {
+    "title": "Setup monitoring and logging infrastructure",
+    "description": "Configure application monitoring with alerts and centralized logging",
+    "completed": false
+  },
+  {
+    "title": "Conduct security vulnerability assessment",
+    "description": "Perform penetration testing and fix identified security issues",
+    "completed": true
+  },
+  {
+    "title": "Implement real-time notifications",
+    "description": "Add WebSocket support for live updates and push notifications",
+    "completed": false
+  },
+  {
+    "title": "Create API documentation with OpenAPI",
+    "description": "Generate interactive API documentation using Swagger/OpenAPI specification",
+    "completed": false
+  },
+  {
+    "title": "Setup email service integration",
+    "description": "Configure transactional email service for user notifications and marketing",
+    "completed": true
+  },
+  {
+    "title": "Implement data backup and recovery system",
+    "description": "Setup automated database backups with disaster recovery procedures",
+    "completed": false
+  },
+  {
+    "title": "Optimize frontend bundle size and performance",
+    "description": "Implement code splitting, lazy loading, and performance optimizations",
+    "completed": false
+  },
+  {
+    "title": "Deploy application to production environment",
+    "description": "Configure production deployment with load balancing and SSL certificates",
+    "completed": false
+  }
+]

package/entities/tasks/tasks.config.ts

@@ -0,0 +1,79 @@
+/**
+ * Task Entity Configuration - REFACTORED
+ * 
+ * Updated according to new 5-section structure from refactoring plan.
+ * All table names, API paths, and metadata are now derived automatically from slug.
+ */
+
+import { CheckSquare } from 'lucide-react'
+import type { EntityConfig } from '@nextsparkjs/core/lib/entities/types'
+import { taskFields } from './tasks.fields'
+
+export const taskEntityConfig: EntityConfig = {
+  // ==========================================
+  // 1. BASIC IDENTIFICATION
+  // ==========================================
+  slug: 'tasks',           // Single source of truth - derives tableName, apiPath, metaTableName, i18nNamespace
+  enabled: true,
+  names: {
+    singular: 'task',
+    plural: 'Tasks'
+  },
+  icon: CheckSquare,
+  
+  // ==========================================
+  // 2. ACCESS AND SCOPE CONFIGURATION
+  // ==========================================
+  access: {
+    public: false,          // If accessible without authentication, requires RLS (anon can select)
+    api: true,              // If has external API via API key  
+    metadata: true,         // If supports metadata system
+    shared: false           // CASE 2: Any authenticated user can access all records (no userId filter)
+  },
+  
+  // ==========================================
+  // 3. UI/UX FEATURES
+  // ==========================================
+  ui: {
+    dashboard: {
+      showInMenu: true,
+      showInTopbar: true,
+      filters: [
+        { field: 'status', type: 'multiSelect' },
+        { field: 'priority', type: 'multiSelect' },
+      ],
+    },
+    public: {
+      hasArchivePage: false,
+      hasSinglePage: false
+    },
+    features: {
+      searchable: true,
+      sortable: true,
+      filterable: true,
+      bulkOperations: true,
+      importExport: false
+    }
+  },
+  
+  // ==========================================
+  // 4. PERMISSIONS SYSTEM
+  // ==========================================
+  // Permissions are now centralized in permissions.config.ts
+  // See: contents/themes/default/permissions.config.ts -> entities.tasks
+
+  // ==========================================
+  // FIELDS (imported from separate file)
+  // ==========================================
+  fields: taskFields,
+
+  // ==========================================
+  // AUTOMATIC SYSTEM DERIVATIONS
+  // ==========================================
+  // The following properties are automatically derived from the slug:
+  // - tableName: 'tasks' (slug)
+  // - metaTableName: 'tasks_metas' (slug + '_metas')
+  // - apiPath: '/api/v1/tasks' (slug API Route)
+  // - i18nNamespace: 'tasks' (slug as namespace)
+  // - foreignKey in metadata: 'entityId' (generic for all entities)
+}