TaskView is a self-hosted project and task management platform focused on clarity, ownership, and control. TaskView is built for teams that want a transparent, self-hosted alternative to SaaS task managers.
TypeScript graphviewkanban-boardnodejsproductivityproject-managementself-hostedtasktask-managementtask-managertodoapp
wip: files (attachments)
Nikolai Giman5958df506cc8
diff --git a/api/.env.example b/api/.env.exampleindex 5f7b2db..58f32a7 100644--- a/api/.env.example+++ b/api/.env.example@@ -96,4 +96,17 @@ GITEA_INTEGRATION_CALLBACK_URL=http://localhost:1401/module/integrations/oauth/g# CENTRIFUGO_API_KEY=your_centrifugo_api_key_here# CENTRIFUGO_TOKEN_SECRET=your_centrifugo_token_secret_here# Public port that clients use to connect to Centrifugo (exposed port, not internal docker port)-# CENTRIFUGO_PUBLIC_PORT=8000\ No newline at end of file+# CENTRIFUGO_PUBLIC_PORT=8000++# Files (task attachments)+# Where uploaded files are stored: local (disk) or s3 (S3-compatible: AWS S3, MinIO, R2, B2).+# Both providers may be configured at once; FILE_STORAGE_PROVIDER is the one new uploads go to.+# FILE_STORAGE_PROVIDER=local+# FILE_MAX_SIZE_MB=50+# FILE_STORAGE_LOCAL_DIR=./data/files+# FILE_STORAGE_S3_BUCKET=taskview+# FILE_STORAGE_S3_REGION=us-east-1+# FILE_STORAGE_S3_ENDPOINT=http://localhost:9000+# FILE_STORAGE_S3_ACCESS_KEY=+# FILE_STORAGE_S3_SECRET_KEY=+# FILE_STORAGE_S3_FORCE_PATH_STYLE=truediff --git a/api/.gitignore b/api/.gitignoreindex 9fe58eb..2f3838a 100644--- a/api/.gitignore+++ b/api/.gitignore@@ -192,4 +192,6 @@ dev.env.docker!version.shprivate-bin.pem-TaskView.lic\ No newline at end of file+TaskView.lic+# files integration tests (local provider)+.test-datadiff --git a/api/dev-containers-test/README.md b/api/dev-containers-test/README.mdindex bd59860..a5d854f 100644--- a/api/dev-containers-test/README.md+++ b/api/dev-containers-test/README.md@@ -1,3 +1,12 @@# Dev Containers Test-This directory contains test configurations and scripts for Docker containers used in development for testing.\ No newline at end of file+This directory contains test configurations and scripts for Docker containers used in development for testing.+## MinIO (S3-compatible file storage)++`docker-compose.minio.yml` starts MinIO on `localhost:9000` (console on `:9001`) and creates two buckets: `taskview` for local development and `taskview-test` for the files integration tests (`src/tv-modules/files/__tests__/*.integration.spec.ts`). Those tests expect it to be up:++```bash+docker compose -f docker-compose.minio.yml up -d+```++To point a dev API at it: `FILE_STORAGE_PROVIDER=s3`, `FILE_STORAGE_S3_BUCKET=taskview`, `FILE_STORAGE_S3_ENDPOINT=http://localhost:9000`, `FILE_STORAGE_S3_REGION=us-east-1`, `FILE_STORAGE_S3_ACCESS_KEY=minioadmin`, `FILE_STORAGE_S3_SECRET_KEY=minioadmin`, `FILE_STORAGE_S3_FORCE_PATH_STYLE=true`.diff --git a/api/dev-containers-test/docker-compose.minio.yml b/api/dev-containers-test/docker-compose.minio.ymlnew file mode 100644index 0000000..377e8b6--- /dev/null+++ b/api/dev-containers-test/docker-compose.minio.yml@@ -0,0 +1,32 @@+services:+ minio:+ image: quay.io/minio/minio@sha256:14cea493d9a34af32f524e538b8346cf79f3321eff8e708c1e2960462bd8936e+ restart: unless-stopped+ command: server /data --console-address ":9001"+ environment:+ MINIO_ROOT_USER: minioadmin+ MINIO_ROOT_PASSWORD: minioadmin+ ports:+ - "9000:9000"+ - "9001:9001"+ volumes:+ - minio-data:/data+ healthcheck:+ test: ["CMD", "mc", "ready", "local"]+ interval: 5s+ timeout: 5s+ retries: 10+ minio-init:+ image: quay.io/minio/mc@sha256:a7fe349ef4bd8521fb8497f55c6042871b2ae640607cf99d9bede5e9bdf11727+ restart: "no"+ depends_on:+ minio:+ condition: service_healthy+ entrypoint: >+ /bin/sh -c "+ mc alias set local http://minio:9000 minioadmin minioadmin &&+ mc mb --ignore-existing local/taskview &&+ mc mb --ignore-existing local/taskview-test+ "+volumes:+ minio-data:diff --git a/api/package.json b/api/package.jsonindex cb95184..4f6c109 100644--- a/api/package.json+++ b/api/package.json@@ -6,10 +6,12 @@"start": "NODE_ENV=production node ./dist/taskview-server.js","build": "vite build","build:packages": "pnpm --filter taskview-db-schemas build && pnpm --filter taskview-api build",- "build:docker": "pnpm run build:packages && vite build --config ./vite.config.docker.mts",+ "build:docker": "pnpm run build:packages && vite build --config ./vite.config.docker.mts && pnpm run build:files-migrate",+ "build:files-migrate": "vite build --config ./vite.config-files-migrate.mts","build:migration": "vite build --config ./vite.config-migration.mts","build:all": "pnpm run build:docker && pnpm run build:migration","test": "vitest",+ "files:migrate": "node ./dist/taskview-files-migrate.js","type-check": "tsc --noEmit","lint": "biome lint .","format": "biome format --write .",@@ -20,6 +22,7 @@"@rollup/plugin-commonjs": "^28.0.1","@rollup/plugin-node-resolve": "^15.3.0","@types/bcrypt": "^5.0.2",+ "@types/busboy": "^1.5.4","@types/cookie-parser": "^1.4.10","@types/cors": "^2.8.17","@types/express": "^4.17.21",@@ -44,6 +47,8 @@"typescript": "^5.0.0"},"dependencies": {+ "@aws-sdk/client-s3": "^3.1138.0",+ "@aws-sdk/lib-storage": "^3.1138.0","@node-saml/node-saml": "^5.1.0","@types/bcryptjs": "^2.4.6","@types/passport": "^1.0.17",@@ -54,6 +59,7 @@"@xmldom/xmldom": "^0.9.9","axios": "1.13.5","bcryptjs": "^2.4.3",+ "busboy": "^1.6.0","cookie-parser": "^1.4.7","cors": "^2.8.5","dotenv": "^16.4.5",diff --git a/api/production.package.json b/api/production.package.jsonindex 29a56df..ad6d1a3 100644--- a/api/production.package.json+++ b/api/production.package.json@@ -2,7 +2,8 @@"name": "taskview-ce-api-server","version": "1.17.0","scripts": {- "start": "pm2-runtime start ecosystem.config.js --env production"+ "start": "pm2-runtime start ecosystem.config.js --env production",+ "files:migrate": "node ./taskview-files-migrate.js"},"dependencies": {}-}\ No newline at end of file+}diff --git a/api/src/core/AppUser.ts b/api/src/core/AppUser.tsindex b672206..d4271d4 100644--- a/api/src/core/AppUser.ts+++ b/api/src/core/AppUser.ts@@ -17,6 +17,7 @@ import { TimeTrackingManager } from '../tv-modules/time-tracking/TimeTrackingManimport { UiPreferencesManager } from '../tv-modules/ui-preferences/UiPreferencesManager';import { SprintsManager } from '../tv-modules/sprints/SprintsManager';import { RecurrenceManager } from '../tv-modules/recurrence/RecurrenceManager';+import { FilesManager } from '../tv-modules/files/FilesManager';import type { UserDbRecord, UserJwtPayload } from '../types/auth.types';import { GoalPermissionsFetcher } from './GoalPermissionsFetcher';@@ -47,6 +48,7 @@ export class AppUser {public readonly uiPreferencesManager: UiPreferencesManager;public readonly sprintsManager: SprintsManager;public readonly recurrenceManager: RecurrenceManager;+ public readonly filesManager: FilesManager;constructor(userData?: UserJwtPayload) {this.userData = userData;@@ -70,6 +72,7 @@ export class AppUser {this.uiPreferencesManager = new UiPreferencesManager(this);this.sprintsManager = new SprintsManager(this);this.recurrenceManager = new RecurrenceManager(this);+ this.filesManager = new FilesManager(this);}getTokenId(): number | undefined {diff --git a/api/src/core/EventBus.ts b/api/src/core/EventBus.tsindex 6634183..a7885d0 100644--- a/api/src/core/EventBus.ts+++ b/api/src/core/EventBus.ts@@ -39,6 +39,7 @@ export interface AppEvents {'recurrence.ended': { ruleId: number; goalId: number; initiatorId: number };'recurrence.deleted': { ruleId: number; goalId: number; initiatorId: number };'recurrence.instanceSkipped': { ruleId: number; goalId: number; date: string; initiatorId: number };+ 'files.changed': { goalId: number; taskIds: number[]; initiatorId: number };}type EventName = keyof AppEvents;diff --git a/api/src/core/all-events.ts b/api/src/core/all-events.tsindex 7618e40..0ff0a6c 100644--- a/api/src/core/all-events.ts+++ b/api/src/core/all-events.ts@@ -8,6 +8,7 @@ import { SprintsDispatcher } from '../tv-modules/sprints/SprintsDispatcher';import { RecurrenceDispatcher } from '../tv-modules/recurrence/RecurrenceDispatcher';import { MessagingDispatcher } from '../tv-modules/messaging/MessagingDispatcher';import { InviteEmailDispatcher } from '../tv-modules/collaboration/InviteEmailDispatcher';+import { FilesDispatcher } from '../tv-modules/files/FilesDispatcher';const dispatchers: Dispatcher[] = [new NotificationDispatcher(),@@ -18,6 +19,7 @@ const dispatchers: Dispatcher[] = [new RecurrenceDispatcher(),new MessagingDispatcher(),new InviteEmailDispatcher(),+ new FilesDispatcher(),];export function registerAllEventHandlers() {diff --git a/api/src/migrations/taskview/migrate.json b/api/src/migrations/taskview/migrate.jsonindex 9a13b99..acff472 100644--- a/api/src/migrations/taskview/migrate.json+++ b/api/src/migrations/taskview/migrate.json@@ -800,5 +800,21 @@"New organization-level permission billing_can_manage (group 6) narrows what an API or OAuth token may do on the billing surfaces; access itself requires the organization owner or admin role.","Invoice lifecycle: issued_at, paid_at, voided_at, replaces_invoice_id (void and reissue chain), template_version and totals frozen at issue time (subtotal, discount_amount, tax_amount, total). Status transitions are validated by the API; only drafts can be edited or deleted."]+ },+ "62": {+ "version": "1.67.0",+ "name": "Files: project attachments",+ "releaseDate": "20260923",+ "scripts": [+ "/1.67.0/0.create-files.sql",+ "/1.67.0/1.create-file-to-task.sql",+ "/1.67.0/2.file-permissions.sql",+ "/1.67.0/all-triggers.sql"+ ],+ "description": [+ "New schema tv_files with files (UUID id, goal_id, uploader snapshot, name, mime type, size, sha256 checksum, storage provider and key) and the relation table file_to_task. A file belongs to a project and may be linked to any number of its tasks; unlinking keeps the file, deleting a task only removes its links.",+ "Storage provider per file (local or s3) so an instance can be migrated between providers without downtime.",+ "New permission group 7 'files' with file_can_view (list, open, download) and file_can_manage (upload, rename, link, unlink, delete). New projects grant them to editor (both) and executor (view) through the updated add_roles_and_permissions() trigger. Existing projects are not backfilled: owners grant the permissions to their roles in the role editor."+ ]}}diff --git a/api/src/migrations/taskview/sql/1.67.0/0.create-files.sql b/api/src/migrations/taskview/sql/1.67.0/0.create-files.sqlnew file mode 100644index 0000000..0f7ab50--- /dev/null+++ b/api/src/migrations/taskview/sql/1.67.0/0.create-files.sql@@ -0,0 +1,22 @@+CREATE SCHEMA IF NOT EXISTS tv_files;++CREATE TABLE IF NOT EXISTS tv_files.files (+ id UUID PRIMARY KEY DEFAULT gen_random_uuid(),+ goal_id INTEGER NOT NULL REFERENCES tasks.goals(id) ON DELETE CASCADE,+ uploader_id INTEGER REFERENCES tv_auth.users(id) ON DELETE SET NULL,+ uploader_email VARCHAR(255) NOT NULL,+ name VARCHAR(255) NOT NULL,+ original_name VARCHAR(255) NOT NULL,+ mime_type VARCHAR(255) NOT NULL,+ size_bytes BIGINT NOT NULL,+ checksum_sha256 VARCHAR(64) NOT NULL,+ storage_provider VARCHAR(20) NOT NULL,+ storage_key VARCHAR(512) NOT NULL,+ created_at TIMESTAMP NOT NULL DEFAULT NOW(),+ edited_at TIMESTAMP NOT NULL DEFAULT NOW(),+ CONSTRAINT files_storage_provider_check CHECK (storage_provider IN ('local', 's3'))+);++CREATE INDEX IF NOT EXISTS files_goal_created_idx ON tv_files.files(goal_id, created_at);+CREATE INDEX IF NOT EXISTS files_goal_name_idx ON tv_files.files(goal_id, name);+CREATE INDEX IF NOT EXISTS files_provider_idx ON tv_files.files(storage_provider);diff --git a/api/src/migrations/taskview/sql/1.67.0/1.create-file-to-task.sql b/api/src/migrations/taskview/sql/1.67.0/1.create-file-to-task.sqlnew file mode 100644index 0000000..9d8bc05--- /dev/null+++ b/api/src/migrations/taskview/sql/1.67.0/1.create-file-to-task.sql@@ -0,0 +1,10 @@+CREATE TABLE IF NOT EXISTS tv_files.file_to_task (+ file_id UUID NOT NULL REFERENCES tv_files.files(id) ON DELETE CASCADE,+ task_id INTEGER NOT NULL REFERENCES tasks.tasks(id) ON DELETE CASCADE,+ linked_by_id INTEGER REFERENCES tv_auth.users(id) ON DELETE SET NULL,+ linked_by_email VARCHAR(255) NOT NULL,+ linked_at TIMESTAMP NOT NULL DEFAULT NOW(),+ PRIMARY KEY (file_id, task_id)+);++CREATE INDEX IF NOT EXISTS file_to_task_task_idx ON tv_files.file_to_task(task_id);diff --git a/api/src/migrations/taskview/sql/1.67.0/2.file-permissions.sql b/api/src/migrations/taskview/sql/1.67.0/2.file-permissions.sqlnew file mode 100644index 0000000..42f25c7--- /dev/null+++ b/api/src/migrations/taskview/sql/1.67.0/2.file-permissions.sql@@ -0,0 +1,28 @@+-- Permission group 7 = files (shown in the role editor)+INSERT INTO tv_auth.permissions_group (id, name)+VALUES (7, 'files')+ON CONFLICT (id) DO NOTHING;++INSERT INTO tv_auth.permissions (name, description, permission_group, description_locales)+VALUES+ ('file_can_view', 'View and download project files', 7,+ '{+ "en": "View files. See the project files, open and download them.",+ "ru": "Просмотр файлов. Видеть файлы проекта, открывать и скачивать их.",+ "de": "Dateien ansehen. Projektdateien sehen, öffnen und herunterladen.",+ "es": "Ver archivos. Ver, abrir y descargar los archivos del proyecto.",+ "pt-BR": "Ver arquivos. Ver, abrir e baixar os arquivos do projeto."+ }'::jsonb),+ ('file_can_manage', 'Upload, rename, link, unlink and delete project files', 7,+ '{+ "en": "Manage files. Upload, rename, attach to and detach from tasks, delete project files.",+ "ru": "Управление файлами. Загружать, переименовывать, прикреплять к задачам и убирать из них, удалять файлы проекта.",+ "de": "Dateien verwalten. Projektdateien hochladen, umbenennen, an Aufgaben anhängen und lösen, löschen.",+ "es": "Gestionar archivos. Subir, renombrar, adjuntar a tareas y desvincular, eliminar archivos del proyecto.",+ "pt-BR": "Gerenciar arquivos. Enviar, renomear, anexar a tarefas e desanexar, excluir arquivos do projeto."+ }'::jsonb)+ON CONFLICT (name) DO NOTHING;++-- Existing projects are NOT backfilled on purpose: roles were shaped by their owners, and the owner+-- decides who may see attachments. New projects get the permissions through+-- tasks.add_roles_and_permissions() (see all-triggers.sql); existing ones grant them in the role editor.diff --git a/api/src/migrations/taskview/sql/1.67.0/all-triggers.sql b/api/src/migrations/taskview/sql/1.67.0/all-triggers.sqlnew file mode 100644index 0000000..f06ecca--- /dev/null+++ b/api/src/migrations/taskview/sql/1.67.0/all-triggers.sql@@ -0,0 +1,644 @@+--1.+--Trigger set previous version+create or replace function app.trigger_set_previous_version()+ returns trigger as+$date_complete$+begin+ new.prev_version = old.version;+ return new;+end;+$date_complete$+ language plpgsql;++drop trigger if exists trigger_set_previous_version on app.version;+create trigger trigger_set_previous_version+ before insert+ on app.version+ for each row+execute procedure app.trigger_set_previous_version();++--2.+--Trigger for adding owner for taskList from goal+create or replace function tasks.trigger_set_owner_for_component()+ returns trigger as+$date_complete$+begin+ new.owner = (select owner from tasks.goals where id = new.goal_id);+ return new;+end;+$date_complete$+ language plpgsql;++drop trigger if exists trigger_set_owner_for_component on tasks.goal_lists;+create trigger trigger_set_owner_for_component+ before insert+ on tasks.goal_lists+ for each row+execute procedure tasks.trigger_set_owner_for_component();++--3.+--Trigger for updating date_complete for task+create or replace function tasks.update_date_complete()+ returns trigger as+$date_complete$+begin+ if new.complete != old.complete+ then+ if new.complete = true+ then+ update tasks.tasks set date_complete = now() where id = old.id;+ else+ update tasks.tasks set date_complete = null where id = old.id;+ end if;+ end if;+ return new;+end;+$date_complete$+ language plpgsql;++drop trigger if exists tr_update_date_complete on tasks.tasks;+create trigger tr_update_date_complete+ after update+ on tasks.tasks+ for each row+execute procedure tasks.update_date_complete();++--4.+-- Delete user from collaboration if not assigned to any goal+create or replace function collaboration.delete_user_if_not_assigned_to_goal()+returns trigger as $$+declare+ count int;+begin+ if not exists (+ select 1+ from collaboration.users_to_goals+ where user_id = old.user_id+ limit 1+ ) then+ delete from collaboration.users where id = old.user_id;+ end if;++ return old;+end;+$$ language plpgsql;++drop trigger if exists trigger_delete_user_if_not_assigned_to_goal on collaboration.users_to_goals;+create trigger trigger_delete_user_if_not_assigned_to_goal+ after delete+ on collaboration.users_to_goals+ for each row+execute function collaboration.delete_user_if_not_assigned_to_goal();++--5.+--Trigger for checking task graph relation goal to avoid connection between tasks from different goals+create or replace function tasks.check_task_graph_relation_goal()+returns trigger as $$+declare+ from_goal int;+ to_goal int;+begin+ select goal_id into from_goal from tasks.tasks where id = new.from_task_id;+ select goal_id into to_goal from tasks.tasks where id = new.to_task_id;++ if from_goal is null or to_goal is null then+ raise exception 'Invalid task reference in relation';+ end if;++ if from_goal <> to_goal then+ raise exception 'Relation goal_id must match both tasks'' goal_id';+ end if;++ new.goal_id := from_goal;++ return new;+end;+$$ language plpgsql;++drop trigger if exists trigger_task_relation_goal on tasks.task_relations;+create trigger trigger_task_relation_goal+before insert or update on tasks.task_relations+for each row execute function tasks.check_task_graph_relation_goal();++--6.+--Trigger for logging changes in taskList to history table+create or replace function tasks.log_changes_tasks_goal_lists()+ returns trigger as+$body$+begin+ if tg_op = 'DELETE' then+ insert into history.tasks_goal_lists (goal_list_id, edit_date, task, deleted) values (old.id, now(), to_jsonb(old), 1);+ return old;+ elseif tg_op = 'UPDATE' then+ insert into history.tasks_goal_lists (goal_list_id, edit_date, task, deleted)+ VALUES (old.id, new.date_creation, to_jsonb(old), 0);+ new.edit_date = now();+ return new;+ end if;+end+$body$+ language plpgsql;++drop trigger if exists trigger_log_changes_tasks_goal_lists on tasks.goal_lists;+create trigger trigger_log_changes_tasks_goal_lists+ before update or delete+ on tasks.goal_lists+ for each row+execute procedure tasks.log_changes_tasks_goal_lists();++--7.+--Trigger for logging changes in goal to history table+create or replace function tasks.log_changes_tasks_goals()+ returns trigger as+$body$+begin+ if tg_op = 'DELETE' then+ insert into history.tasks_goals (goal_id, edit_date, task, deleted) values (old.id, now(), to_jsonb(old), 1);+ return old;+ elseif tg_op = 'UPDATE' then+ insert into history.tasks_goals (goal_id, edit_date, task, deleted)+ VALUES (old.id, new.date_creation, to_jsonb(old), 0);+ new.edit_date = now();+ return new;+ end if;+end+$body$+ language plpgsql;++drop trigger if exists trigger_log_changes_tasks_goals on tasks.goals;+create trigger trigger_log_changes_tasks_goals+ before update or delete+ on tasks.goals+ for each row+execute procedure tasks.log_changes_tasks_goals();++--8.+--Trigger for logging changes in task to history table+create or replace function tasks.log_changes_tasks_tasks()+ returns trigger as+$body$+begin+ if tg_op = 'DELETE' then+ insert into history.tasks_tasks (task_id, edit_date, task, deleted) values (old.id, now(), to_jsonb(old), 1);+ return old;+ elseif tg_op = 'UPDATE' then+ insert into history.tasks_tasks (task_id, edit_date, task, deleted)+ VALUES (old.id, new.date_creation, to_jsonb(old), 0);+ new.edit_date = now();+ return new;+ end if;+end+$body$+ language plpgsql;++drop trigger if exists trigger_log_changes_tasks_tasks on tasks.tasks;+create trigger trigger_log_changes_tasks_tasks+ before update or delete+ on tasks.tasks+ for each row+execute procedure tasks.log_changes_tasks_tasks();++--9.+--Trigger for setting goal_id default for task+CREATE OR REPLACE FUNCTION tasks.set_goal_id_default_for_task()+ RETURNS TRIGGER AS+$$+DECLARE+ goal_id INT;+BEGIN++ SELECT gl.goal_id+ INTO goal_id+ FROM tasks.goal_lists gl+ WHERE gl.id = NEW.goal_list_id;++ IF goal_id IS NOT NULL THEN+ NEW.goal_id := goal_id;+ END IF;++ RETURN NEW;+END;+$$ LANGUAGE plpgsql;++drop trigger if exists before_insert_set_goal_id_for_task on tasks.tasks;++CREATE TRIGGER before_insert_set_goal_id_for_task+ BEFORE INSERT OR UPDATE+ ON tasks.tasks+ FOR EACH ROW+EXECUTE FUNCTION tasks.set_goal_id_default_for_task();+++--10.+--Trigger for adding default roles and permissions for goal+CREATE OR REPLACE FUNCTION tasks.add_roles_and_permissions()+ RETURNS TRIGGER AS+$$+DECLARE+ editor_role_id INTEGER;+ executor_role_id INTEGER;+BEGIN+ -- 1. Create role "editor"+ INSERT INTO collaboration.roles (name, goal_id)+ VALUES ('editor', NEW.id)+ RETURNING id INTO editor_role_id;++ -- 2. Create role "executor"+ INSERT INTO collaboration.roles (name, goal_id)+ VALUES ('executor', NEW.id)+ RETURNING id INTO executor_role_id;++ -- 3. Add permissions for role "editor"+ INSERT INTO collaboration.permissions_to_role (role_id, permission_id)+ SELECT editor_role_id, id+ FROM tv_auth.permissions+ WHERE name IN (+ 'goal_can_watch_content',+ 'goal_can_edit',+ 'goal_can_add_task_list',+ 'goal_can_manage_users',+ 'component_can_watch_content',+ 'component_can_edit',+ 'component_can_delete',+ 'component_can_add_tasks',+ 'task_can_edit_deadline',+ 'task_can_watch_subtasks',+ 'task_can_watch_note',+ 'task_can_recovery_history',+ 'task_can_watch_assigned_users',+ 'task_can_edit_priority',+ 'task_can_delete',+ 'task_can_watch_details',+ 'task_can_assign_users',+ 'task_can_add_subtasks',+ 'task_can_watch_tags',+ 'task_can_watch_priority',+ 'task_can_access_history',+ 'task_can_edit_tags',+ 'task_can_edit_description',+ 'task_can_edit_status',+ 'task_can_edit_note',+ 'kanban_can_manage',+ 'kanban_can_view',+ 'graph_can_manage',+ 'graph_can_view',+ 'timetracking_can_view',+ 'timetracking_can_manage_all',+ 'sprint_can_view',+ 'sprint_can_manage',+ 'sprint_can_assign_tasks',+ 'sprint_can_view_analytics',+ 'file_can_view',+ 'file_can_manage'+ );++ -- 4. Add permissions for role "viewver"+ INSERT INTO collaboration.permissions_to_role (role_id, permission_id)+ SELECT executor_role_id, id+ FROM tv_auth.permissions+ WHERE name IN (+ 'goal_can_watch_content',+ 'component_can_watch_content',+ 'component_can_add_tasks',+ 'task_can_watch_subtasks',+ 'task_can_watch_note',+ 'task_can_watch_assigned_users',+ 'task_can_watch_details',+ 'task_can_add_subtasks',+ 'task_can_watch_tags',+ 'task_can_watch_priority',+ 'timetracking_can_view',+ 'timetracking_can_log',+ 'sprint_can_view',+ 'sprint_can_assign_tasks',+ 'file_can_view'+ );++ RETURN NEW;+END;+$$ LANGUAGE plpgsql;+++drop trigger if exists add_roles_after_insert on tasks.goals;++CREATE TRIGGER add_roles_after_insert+ AFTER INSERT+ ON tasks.goals+ FOR EACH ROW+EXECUTE FUNCTION tasks.add_roles_and_permissions();+++--11.+--Trigger for adjusting start and end dates for task+CREATE OR REPLACE FUNCTION tasks.adjust_start_and_end_dates()+ RETURNS TRIGGER AS+$$+DECLARE+ start_timestamp TIMESTAMPTZ;+ end_timestamp TIMESTAMPTZ;+BEGIN+ -- If start_date is NULL, then start_time should be NULL+ IF NEW.start_date IS NULL THEN+ NEW.start_time := NULL;+ END IF;++ -- If end_date is NULL, then end_time should be NULL+ IF NEW.end_date IS NULL THEN+ NEW.end_time := NULL;+ END IF;++ -- If both dates are set+ IF NEW.start_date IS NOT NULL AND NEW.end_date IS NOT NULL THEN+ -- Adjust dates+ IF NEW.start_date > NEW.end_date THEN+ -- If start_date is greater than end_date, set end_date to start_date+ NEW.end_date := NEW.start_date;+ -- end_time remains unchanged+ ELSIF NEW.end_date < NEW.start_date THEN+ -- If end_date is less than start_date, set start_date to end_date+ NEW.start_date := NEW.end_date;+ -- start_time remains unchanged+ END IF;++ -- Prepare timestamps for comparison+ start_timestamp := (NEW.start_date::text || ' ' || COALESCE(NEW.start_time::text, '00:00:00+00'))::timestamptz;+ end_timestamp := (NEW.end_date::text || ' ' || COALESCE(NEW.end_time::text, '00:00:00+00'))::timestamptz;++ -- If start_timestamp is greater than end_timestamp, adjust end_date and end_time+ IF start_timestamp > end_timestamp THEN+ NEW.end_date := NEW.start_date;+ -- Assign end_time only if start_time is not NULL+ IF NEW.start_time IS NOT NULL AND NEW.end_time IS NOT NULL THEN+ NEW.end_time := NEW.start_time;+ END IF;+ END IF;+ END IF;++ RETURN NEW;+END;+$$ LANGUAGE plpgsql;+++drop trigger if exists adjust_dates_and_times_trigger on tasks.tasks;+CREATE TRIGGER adjust_dates_and_times_trigger+ BEFORE INSERT OR UPDATE+ ON tasks.tasks+ FOR EACH ROW+EXECUTE FUNCTION tasks.adjust_start_and_end_dates();++--12.+--Trigger for adding self/owner to collaboration table to be able to assign tasks to self+create or replace function tasks.add_self_to_collaboration()+returns trigger as $$+DECLARE+ owner_email TEXT;+BEGIN++ select email into owner_email+ from tv_auth.users+ where id = NEW.owner;++ if owner_email is not null then+ insert into collaboration.users (email) values (owner_email) ON CONFLICT (email) DO NOTHING;+ insert into collaboration.users_to_goals (goal_id, user_id) values (NEW.id, (select id from collaboration.users where email = owner_email));+ end if;++ return NEW;+END;+$$ language plpgsql;++drop trigger if exists add_selt_to_collaboration_trg on tasks.goals;++create trigger add_selt_to_collaboration_trg+ after insert on tasks.goals+ for each row+ execute function tasks.add_self_to_collaboration();++--13.+--Trigger for adding default kanban columns for new goal+CREATE OR REPLACE FUNCTION tasks.kanban_add_default_columns()+RETURNS TRIGGER AS $$+BEGIN+ -- Add default columns for new goal+ INSERT INTO tasks.statuses (name, goal_id, view_order)+ VALUES+ ('TODO', NEW.id, 1),+ ('In Progress', NEW.id, 2),+ ('Done', NEW.id, 3);+ RETURN NEW;+END;+$$ LANGUAGE plpgsql;++DROP TRIGGER IF EXISTS kanban_add_default_columns_trg ON tasks.goals;++CREATE TRIGGER kanban_add_default_columns_trg+AFTER INSERT ON tasks.goals+FOR EACH ROW+EXECUTE FUNCTION tasks.kanban_add_default_columns();++--14.+--Trigger for validating the correct statusId for the inserted value. To avoid assigning a status that does not belong to the goal.+CREATE OR REPLACE FUNCTION tasks.check_task_status_goal()+RETURNS TRIGGER AS $$+BEGIN+ -- Check if there is a record in tasks.statuses with the same goal_id+ IF NOT EXISTS (+ SELECT 1 FROM tasks.statuses s+ WHERE s.id = NEW.status_id AND s.goal_id = NEW.goal_id+ ) THEN+ RAISE EXCEPTION 'Status ID % is not valid for goal ID %', NEW.status_id, NEW.goal_id;+ END IF;+ RETURN NEW;+END;+$$ LANGUAGE plpgsql;++drop trigger if exists enforce_task_status_goal on tasks.tasks;++CREATE TRIGGER enforce_task_status_goal+BEFORE INSERT OR UPDATE ON tasks.tasks+FOR EACH ROW+WHEN (NEW.status_id IS NOT NULL)+EXECUTE FUNCTION tasks.check_task_status_goal();++--15.+--Trigger for setting default orders value for task+CREATE OR REPLACE FUNCTION tasks.set_order_value()+RETURNS TRIGGER AS $$+BEGIN+ IF NEW.task_order IS NULL THEN+ NEW.task_order := NEW.id;+ END IF;+ IF NEW.kanban_order IS NULL THEN+ NEW.kanban_order := NEW.id;+ END IF;+ RETURN NEW;+END;+$$ LANGUAGE plpgsql;++drop trigger if exists set_order_trigger on tasks.tasks;+CREATE TRIGGER set_order_trigger+BEFORE INSERT ON tasks.tasks+FOR EACH ROW+EXECUTE FUNCTION tasks.set_order_value();++--16.+--Trigger for setting default view order for new status+CREATE OR REPLACE FUNCTION tasks.status_set_default_view_order()+RETURNS TRIGGER AS $$+DECLARE+ new_view_order INT;+BEGIN+ -- Determine the next view_order for the given goal_id+ SELECT COALESCE(MAX(view_order), 0) + 1 INTO new_view_order+ FROM tasks.statuses+ WHERE goal_id = NEW.goal_id;++ -- Assign the calculated value to the view_order field+ NEW.view_order := new_view_order;++ RETURN NEW;+END;+$$ LANGUAGE plpgsql;++drop trigger if exists set_default_status_view_order on tasks.statuses;++CREATE TRIGGER set_default_status_view_order+BEFORE INSERT ON tasks.statuses+FOR EACH ROW+EXECUTE FUNCTION tasks.status_set_default_view_order();++--17.+--Trigger for validating the correct user_id for the inserted value. To avoid assigning a user that does not belong to the goal.+CREATE OR REPLACE FUNCTION tasks_auth.control_user_id_is_from_same_goal_as_task()+RETURNS TRIGGER AS $$+DECLARE+ user_exists BOOLEAN;+BEGIN+ SELECT EXISTS (+ SELECT 1+ FROM tasks.tasks tt+ LEFT JOIN collaboration.users_to_goals utg ON utg.goal_id = tt.goal_id+ WHERE tt.id = NEW.task_id AND utg.user_id = NEW.collab_user_id+ ) INTO user_exists;++ IF NOT user_exists THEN+ RAISE EXCEPTION 'User % is not associated with the goal of task %', NEW.collab_user_id, NEW.task_id;+ END IF;++ RETURN NEW;+END;+$$ LANGUAGE plpgsql;++drop trigger if exists trigger_control_user_id_is_from_same_goal_as_task on tasks_auth.task_assignee;++CREATE TRIGGER trigger_control_user_id_is_from_same_goal_as_task+BEFORE INSERT ON tasks_auth.task_assignee+FOR EACH ROW+EXECUTE FUNCTION tasks_auth.control_user_id_is_from_same_goal_as_task();++--18.+--Trigger for adding owner for task, extend owner from goal or taskList++--delete old function with wrong name+drop trigger if exists trigger_set_owner_for_task on tasks.tasks;+drop function if exists tasks.trigger_set_owner_for_task();++CREATE OR REPLACE FUNCTION tasks.fn_set_owner_for_task()+RETURNS TRIGGER AS+$body$+BEGIN+ NEW.owner := COALESCE(+ (SELECT owner FROM tasks.goal_lists WHERE id = NEW.goal_list_id),+ (SELECT owner FROM tasks.goals WHERE id = NEW.goal_id)+ );++ IF NEW.owner IS NULL THEN+ RAISE EXCEPTION 'Can not insert task without owner';+ END IF;++ RETURN NEW;+END;+$body$+LANGUAGE plpgsql;++drop trigger if exists trigger_set_owner_for_task on tasks.tasks;+create trigger trigger_set_owner_for_task+ before insert+ on tasks.tasks+ for each row+execute procedure tasks.fn_set_owner_for_task();++--19.+--Trigger for validating that tag and task belong to the same project (goal_id)+drop trigger if exists trigger_check_tag_task_same_goal on tasks.tasks_to_tags;+drop function if exists tasks.check_tag_task_same_goal();++create or replace function tasks.check_tag_task_same_goal()+returns trigger as $$+declare+ v_tag_goal_id integer;+ v_task_goal_id integer;+begin+ select goal_id into v_tag_goal_id from tasks.tags where id = new.tag_id;+ select goal_id into v_task_goal_id from tasks.tasks where id = new.task_id;++ if v_tag_goal_id is null or v_tag_goal_id != v_task_goal_id then+ raise exception 'Tag (id=%) and task (id=%) belong to different projects', new.tag_id, new.task_id;+ end if;++ return new;+end;+$$ language plpgsql;++drop trigger if exists trigger_check_tag_task_same_goal on tasks.tasks_to_tags;+create trigger trigger_check_tag_task_same_goal+ before insert on tasks.tasks_to_tags+ for each row+execute function tasks.check_tag_task_same_goal();++--20.+-- Remove user from task assignees when removed from project collaboration++drop trigger if exists trigger_remove_user_from_task_assignees on collaboration.users_to_goals;+drop function if exists collaboration.remove_user_from_task_assignees();+++CREATE OR REPLACE FUNCTION collaboration.remove_user_from_task_assignees()+RETURNS TRIGGER AS $$+BEGIN+ DELETE FROM tasks_auth.task_assignee+ WHERE collab_user_id = OLD.user_id+ AND task_id IN (SELECT id FROM tasks.tasks WHERE goal_id = OLD.goal_id);++ RETURN OLD;+END;+$$ LANGUAGE plpgsql;++DROP TRIGGER IF EXISTS trigger_remove_user_from_task_assignees ON collaboration.users_to_goals;++CREATE TRIGGER trigger_remove_user_from_task_assignees+ BEFORE DELETE+ ON collaboration.users_to_goals+ FOR EACH ROW+EXECUTE FUNCTION collaboration.remove_user_from_task_assignees();++--21.+--Trigger for logging changes in time_entries to history table+create or replace function tasks.log_changes_time_entries()+ returns trigger as+$body$+begin+ insert into history.time_entries (entry_id, edit_date, entry)+ values (old.id, now(), to_jsonb(old));+ new.edited_at = now();+ return new;+end+$body$+ language plpgsql;++drop trigger if exists trigger_log_changes_time_entries on tasks.time_entries;+create trigger trigger_log_changes_time_entries+ before update+ on tasks.time_entries+ for each row+execute procedure tasks.log_changes_time_entries();diff --git a/api/src/routes/index.ts b/api/src/routes/index.tsindex 635c834..d086dab 100644--- a/api/src/routes/index.ts+++ b/api/src/routes/index.ts@@ -26,6 +26,7 @@ import SprintsRoutes from '../tv-modules/sprints/SprintsRoutes';import RecurrenceRoutes from '../tv-modules/recurrence/RecurrenceRoutes';import BillingRoutes from '../tv-modules/billing/BillingRoutes';import InvoicesRoutes from '../tv-modules/invoices/InvoicesRoutes';+import FilesRoutes from '../tv-modules/files/FilesRoutes';import type { Routable } from '../types/routable.type';type RoutableConstructor = new (...args: any[]) => Routable;@@ -57,6 +58,7 @@ const routes: Record<string, RoutableConstructor> = {'/module/recurrence': RecurrenceRoutes,'/module/billing': BillingRoutes,'/module/invoices': InvoicesRoutes,+ '/module/files': FilesRoutes,'/scim/v2': ScimRoutes,'/.well-known': OAuthWellKnownRoutes,};diff --git a/api/src/tv-modules/files/FileDownloadTokens.ts b/api/src/tv-modules/files/FileDownloadTokens.tsnew file mode 100644index 0000000..d0b76a6--- /dev/null+++ b/api/src/tv-modules/files/FileDownloadTokens.ts@@ -0,0 +1,36 @@+import { createHmac, timingSafeEqual } from 'node:crypto';+import type { FileDownloadTokenPayload } from './types';++export class FileDownloadTokens {+ private readonly secret: Buffer;++ constructor(secret: string | undefined = process.env.ENCRYPTION_KEY) {+ if (!secret || secret.length < 32) {+ throw new Error('ENCRYPTION_KEY must be set to sign file download tokens');+ }+ this.secret = Buffer.from(secret, 'utf8');+ }++ sign(payload: FileDownloadTokenPayload): string {+ const body = Buffer.from(`${payload.fileId}.${payload.inline ? 1 : 0}.${payload.exp}`).toString('base64url');+ return `${body}.${this.mac(body)}`;+ }++ verify(token: string, now: number = Math.floor(Date.now() / 1000)): FileDownloadTokenPayload | null {+ const dot = token.lastIndexOf('.');+ if (dot <= 0) return null;+ const body = token.slice(0, dot);+ const mac = token.slice(dot + 1);+ const expected = this.mac(body);+ if (mac.length !== expected.length || !timingSafeEqual(Buffer.from(mac), Buffer.from(expected))) return null;++ const [fileId, inline, exp] = Buffer.from(body, 'base64url').toString('utf8').split('.');+ const expNumber = Number(exp);+ if (!fileId || !Number.isFinite(expNumber) || expNumber < now) return null;+ return { fileId, inline: inline === '1', exp: expNumber };+ }++ private mac(body: string): string {+ return createHmac('sha256', this.secret).update(body).digest('base64url');+ }+}diff --git a/api/src/tv-modules/files/FilesController.ts b/api/src/tv-modules/files/FilesController.tsnew file mode 100644index 0000000..559780f--- /dev/null+++ b/api/src/tv-modules/files/FilesController.ts@@ -0,0 +1,198 @@+import busboy from 'busboy';+import { type } from 'arktype';+import type { Request, Response } from 'express';+import type { Readable } from 'node:stream';+import { logError } from '../../utils/api';+import {+ FILE_LIST_DEFAULT_LIMIT,+ FILE_LIST_MAX_LIMIT,+ FileArkTypeContentQuery,+ FileArkTypeDownloadUrl,+ FileArkTypeFileIdParam,+ FileArkTypeGoalIdParam,+ FileArkTypeLink,+ FileArkTypeListQuery,+ FileArkTypeRename,+ FileArkTypeTaskFileParams,+ FileArkTypeTaskIdParam,+ FileArkTypeTokenParam,+ FileArkTypeUploadQuery,+ type FileErrorCode,+ type FileResult,+} from './types';++const codeToStatus: Record<FileErrorCode, number> = {+ not_found: 404,+ forbidden: 403,+ too_large: 413,+ invalid: 400,+ storage_error: 500,+};++type IncomingFile = { stream: Readable; filename: string; mimeType: string };++export default class FilesController {+ private sendResult<T>(res: Response, result: FileResult<T>) {+ if (result.ok) return res.tvJson(result.data);+ return res.status(codeToStatus[result.code]).send(result.message ?? result.code);+ }++ upload = async (req: Request, res: Response) => {+ const params = FileArkTypeGoalIdParam(req.params);+ if (params instanceof type.errors) return res.status(400).send(params.summary);+ const query = FileArkTypeUploadQuery(req.query);+ if (query instanceof type.errors) return res.status(400).send(query.summary);++ const user = req.appUser.getUserData();+ if (!user) return res.status(401).end();++ const incoming = await this.readSingleFile(req);+ if (!incoming) return res.status(400).send('file field is required');++ const result = await req.appUser.filesManager.upload({+ goalId: params.goalId,+ uploaderId: user.id,+ uploaderEmail: user.email,+ taskId: query.taskId ?? null,+ originalName: incoming.filename,+ mimeType: incoming.mimeType,+ stream: incoming.stream,+ });+ return this.sendResult(res, result);+ };++ listForGoal = async (req: Request, res: Response) => {+ const data = FileArkTypeListQuery({ ...req.query, ...req.params });+ if (data instanceof type.errors) return res.status(400).send(data.summary);+ const limit = Math.min(Math.max(data.limit ?? FILE_LIST_DEFAULT_LIMIT, 1), FILE_LIST_MAX_LIMIT);+ const page = await req.appUser.filesManager+ .listForGoal({+ goalId: data.goalId,+ search: data.search?.trim() || null,+ type: data.type ?? 'all',+ cursor: data.cursor ?? null,+ limit,+ })+ .catch(logError);+ return res.tvJson(page ?? { items: [], nextCursor: null });+ };++ listForTask = async (req: Request, res: Response) => {+ const data = FileArkTypeTaskIdParam(req.params);+ if (data instanceof type.errors) return res.status(400).send(data.summary);+ return res.tvJson((await req.appUser.filesManager.listForTask(data.taskId).catch(logError)) ?? []);+ };++ getOne = async (req: Request, res: Response) => {+ const data = FileArkTypeFileIdParam(req.params);+ if (data instanceof type.errors) return res.status(400).send(data.summary);+ const file = await req.appUser.filesManager.getById(data.fileId).catch(logError);+ if (!file) return res.status(404).end();+ return res.tvJson(file);+ };++ link = async (req: Request, res: Response) => {+ const params = FileArkTypeTaskIdParam(req.params);+ if (params instanceof type.errors) return res.status(400).send(params.summary);+ const body = FileArkTypeLink(req.body);+ if (body instanceof type.errors) return res.status(400).send(body.summary);+ const user = req.appUser.getUserData();+ if (!user) return res.status(401).end();+ return this.sendResult(+ res,+ await req.appUser.filesManager.link({+ taskId: params.taskId,+ fileIds: [...new Set(body.fileIds)],+ linkedById: user.id,+ linkedByEmail: user.email,+ })+ );+ };++ unlink = async (req: Request, res: Response) => {+ const data = FileArkTypeTaskFileParams(req.params);+ if (data instanceof type.errors) return res.status(400).send(data.summary);+ return this.sendResult(res, await req.appUser.filesManager.unlink({ taskId: data.taskId, fileId: data.fileId }));+ };++ rename = async (req: Request, res: Response) => {+ const params = FileArkTypeFileIdParam(req.params);+ if (params instanceof type.errors) return res.status(400).send(params.summary);+ const body = FileArkTypeRename(req.body);+ if (body instanceof type.errors) return res.status(400).send(body.summary);+ return this.sendResult(res, await req.appUser.filesManager.rename({ fileId: params.fileId, name: body.name }));+ };++ remove = async (req: Request, res: Response) => {+ const data = FileArkTypeFileIdParam(req.params);+ if (data instanceof type.errors) return res.status(400).send(data.summary);+ return this.sendResult(res, await req.appUser.filesManager.deleteForever(data.fileId));+ };++ downloadUrl = async (req: Request, res: Response) => {+ const params = FileArkTypeFileIdParam(req.params);+ if (params instanceof type.errors) return res.status(400).send(params.summary);+ const body = FileArkTypeDownloadUrl(req.body ?? {});+ if (body instanceof type.errors) return res.status(400).send(body.summary);+ return this.sendResult(+ res,+ await req.appUser.filesManager.issueDownloadUrl({ fileId: params.fileId, inline: body.inline ?? false })+ );+ };++ content = async (req: Request, res: Response) => {+ const params = FileArkTypeTokenParam(req.params);+ if (params instanceof type.errors) return res.status(400).send(params.summary);+ const query = FileArkTypeContentQuery(req.query);+ if (query instanceof type.errors) return res.status(400).send(query.summary);++ const result = await req.appUser.filesManager.openContent(params.token);+ if (!result.ok) return res.status(codeToStatus[result.code]).send(result.message ?? result.code);++ const { file, stream, sizeBytes, inline } = result.data;+ const disposition = inline || query.inline === '1' ? 'inline' : 'attachment';+ res.setHeader('Content-Type', file.mimeType);+ res.setHeader('Content-Length', String(sizeBytes));+ res.setHeader('Content-Disposition', this.contentDisposition(disposition, file.name));+ res.setHeader('Cache-Control', 'private, max-age=0, no-store');+ res.setHeader('X-Content-Type-Options', 'nosniff');+ res.setHeader('Cross-Origin-Resource-Policy', 'cross-origin');++ stream.on('error', (err) => {+ logError(err);+ if (!res.headersSent) res.status(500).end();+ else res.destroy(err);+ });+ stream.pipe(res);+ };++ private contentDisposition(kind: 'inline' | 'attachment', name: string): string {+ const ascii = name.replace(/[^\x20-\x7e]/g, '_').replace(/["\\]/g, '_');+ return `${kind}; filename="${ascii}"; filename*=UTF-8''${encodeURIComponent(name)}`;+ }++ private readSingleFile(req: Request): Promise<IncomingFile | null> {+ return new Promise((resolve) => {+ let settled = false;+ const done = (value: IncomingFile | null) => {+ if (settled) return;+ settled = true;+ resolve(value);+ };++ let bb: busboy.Busboy;+ try {+ bb = busboy({ headers: req.headers, limits: { files: 1 }, defParamCharset: 'utf8' });+ } catch {+ return done(null);+ }++ bb.on('file', (_field, stream, info) => {+ done({ stream, filename: info.filename || 'file', mimeType: info.mimeType || 'application/octet-stream' });+ });+ bb.on('close', () => done(null));+ bb.on('error', () => done(null));+ req.pipe(bb);+ });+ }+}diff --git a/api/src/tv-modules/files/FilesDispatcher.ts b/api/src/tv-modules/files/FilesDispatcher.tsnew file mode 100644index 0000000..430944a--- /dev/null+++ b/api/src/tv-modules/files/FilesDispatcher.ts@@ -0,0 +1,53 @@+import { eq } from 'drizzle-orm';+import {+ CollaborationUsersSchema,+ CollaborationUsersToGoalsSchema,+ GoalsSchema,+ UsersSchema,+} from 'taskview-db-schemas';+import { getCentrifugoClient } from '../../core/CentrifugoClient';+import type { Dispatcher } from '../../core/Dispatcher';+import { eventBus } from '../../core/EventBus';+import { Database } from '../../modules/db';+import { $logger } from '../../modules/logget';++const FILES_RT_EVENT = 'files.changed';++export class FilesDispatcher implements Dispatcher {+ register(): void {+ eventBus.on('files.changed', (d) => this.notifyGoalMembers(d.goalId, { taskIds: d.taskIds }));+ }++ async registerWorkers(): Promise<void> {}++ private async notifyGoalMembers(goalId: number, payload: Record<string, unknown>): Promise<void> {+ try {+ const memberIds = await this.resolveGoalMemberIds(goalId);+ if (memberIds.length === 0) return;+ const centrifugo = getCentrifugoClient();+ await Promise.all(+ memberIds.map((userId) => centrifugo.publishToUser(userId, FILES_RT_EVENT, { goalId, ...payload }))+ );+ } catch (err) {+ $logger.error(err, '[FilesDispatcher] real-time publish failed');+ }+ }++ private async resolveGoalMemberIds(goalId: number): Promise<number[]> {+ const db = Database.getInstance();+ const [ownerRows, collabRows] = await Promise.all([+ db.dbDrizzle.select({ id: GoalsSchema.owner }).from(GoalsSchema).where(eq(GoalsSchema.id, goalId)).limit(1),+ db.dbDrizzle+ .select({ id: UsersSchema.id })+ .from(CollaborationUsersToGoalsSchema)+ .innerJoin(CollaborationUsersSchema, eq(CollaborationUsersToGoalsSchema.userId, CollaborationUsersSchema.id))+ .innerJoin(UsersSchema, eq(CollaborationUsersSchema.email, UsersSchema.email))+ .where(eq(CollaborationUsersToGoalsSchema.goalId, goalId)),+ ]);++ const ids = new Set<number>();+ if (ownerRows[0]?.id) ids.add(ownerRows[0].id);+ for (const row of collabRows) ids.add(row.id);+ return [...ids];+ }+}diff --git a/api/src/tv-modules/files/FilesManager.ts b/api/src/tv-modules/files/FilesManager.tsnew file mode 100644index 0000000..faff317--- /dev/null+++ b/api/src/tv-modules/files/FilesManager.ts@@ -0,0 +1,247 @@+import { randomUUID } from 'node:crypto';+import type { FilesSchemaTypeForSelect } from 'taskview-db-schemas';+import type { AppUser } from '../../core/AppUser';+import { eventBus } from '../../core/EventBus';+import { $logger } from '../../modules/logget';+import { TasksRepository } from '../tasks/TasksRepository';+import { FileDownloadTokens } from './FileDownloadTokens';+import { FilesRepository } from './FilesRepository';+import { FileStorageFactory } from './storage/FileStorageFactory';+import { FileTooLargeError, HashingStream } from './storage/HashingStream';+import {+ FILE_DOWNLOAD_TOKEN_TTL_SECONDS,+ FILE_NAME_MAX_LENGTH,+ type FileContent,+ type FileDownloadUrl,+ type FileDto,+ type FileErrorCode,+ type FileIssueDownloadUrlArgs,+ type FileLinkArgs,+ type FileListArgs,+ type FileListPage,+ type FileRenameArgs,+ type FileResult,+ type FileUnlinkArgs,+ type FileUploadArgs,+} from './types';++const ok = <T>(data: T): FileResult<T> => ({ ok: true, data });+const fail = (code: FileErrorCode, message?: string): FileResult<never> => ({ ok: false, code, message });++export class FilesManager {+ private readonly user: AppUser;+ public readonly repository: FilesRepository;+ private readonly tasksRepository: TasksRepository;++ constructor(user: AppUser) {+ this.user = user;+ this.repository = new FilesRepository();+ this.tasksRepository = new TasksRepository();+ }++ private get initiatorId(): number {+ return this.user.getUserData()?.id as number;+ }++ private get storages(): FileStorageFactory {+ return FileStorageFactory.getInstance();+ }++ get maxFileSizeBytes(): number {+ return this.storages.maxFileSizeBytes;+ }++ async upload(args: FileUploadArgs): Promise<FileResult<FileDto>> {+ if (args.taskId !== null) {+ const task = await this.tasksRepository.fetchTaskByIdNew(args.taskId);+ if (!task) return fail('not_found', 'task not found');+ if (task.goalId !== args.goalId) return fail('forbidden', 'task belongs to another project');+ }++ const storage = this.storages.active();+ const fileId = randomUUID();+ const storageKey = `${args.goalId}/${fileId}`;+ const hashing = new HashingStream(this.maxFileSizeBytes);+ args.stream.on('error', (err) => hashing.destroy(err));++ let sizeBytes: number;+ try {+ const stored = await storage.put({ key: storageKey, stream: args.stream.pipe(hashing), mimeType: args.mimeType });+ sizeBytes = stored.sizeBytes;+ } catch (err) {+ args.stream.resume();+ await storage.delete(storageKey).catch(() => undefined);+ if (err instanceof FileTooLargeError) return fail('too_large', err.message);+ $logger.error(err, '[FilesManager] storage put failed');+ return fail('storage_error');+ }++ let row: FilesSchemaTypeForSelect;+ try {+ row = await this.repository.insert({+ id: fileId,+ goalId: args.goalId,+ uploaderId: args.uploaderId,+ uploaderEmail: args.uploaderEmail,+ name: this.normalizeName(args.originalName),+ originalName: this.normalizeName(args.originalName),+ mimeType: args.mimeType,+ sizeBytes,+ checksumSha256: hashing.digestHex(),+ storageProvider: storage.provider,+ storageKey,+ });+ } catch (err) {+ await storage.delete(storageKey).catch(() => undefined);+ $logger.error(err, '[FilesManager] insert failed');+ return fail('storage_error');+ }++ const linkedTaskIds: number[] = [];+ if (args.taskId !== null) {+ await this.repository.link({+ taskId: args.taskId,+ fileIds: [fileId],+ linkedById: args.uploaderId,+ linkedByEmail: args.uploaderEmail,+ });+ linkedTaskIds.push(args.taskId);+ }++ this.emitChanged(args.goalId, linkedTaskIds);+ return ok(this.toDto(row, linkedTaskIds));+ }++ async listForGoal(args: FileListArgs): Promise<FileListPage> {+ const rows = await this.repository.listForGoal({ ...args, limit: args.limit + 1 });+ const hasMore = rows.length > args.limit;+ const page = hasMore ? rows.slice(0, args.limit) : rows;+ const items = await this.toDtos(page);+ return { items, nextCursor: hasMore ? this.repository.encodeCursor(page[page.length - 1]) : null };+ }++ async listForTask(taskId: number): Promise<FileDto[]> {+ return this.toDtos(await this.repository.listForTask(taskId));+ }++ async getById(fileId: string): Promise<FileDto | null> {+ const row = await this.repository.getById(fileId);+ if (!row) return null;+ const [dto] = await this.toDtos([row]);+ return dto;+ }++ async link(args: FileLinkArgs): Promise<FileResult<FileDto[]>> {+ const task = await this.tasksRepository.fetchTaskByIdNew(args.taskId);+ if (!task) return fail('not_found', 'task not found');++ const files = await this.repository.getByIds(args.fileIds);+ if (files.length !== new Set(args.fileIds).size) return fail('not_found', 'file not found');+ if (files.some((f) => f.goalId !== task.goalId)) return fail('forbidden', 'file belongs to another project');++ await this.repository.link(args);+ this.emitChanged(task.goalId, [args.taskId]);+ return ok(await this.toDtos(files));+ }++ async unlink(args: FileUnlinkArgs): Promise<FileResult<null>> {+ const file = await this.repository.getById(args.fileId);+ if (!file) return fail('not_found');+ const removed = await this.repository.unlink(args);+ if (!removed) return fail('not_found', 'file is not linked to this task');+ this.emitChanged(file.goalId, [args.taskId]);+ return ok(null);+ }++ async rename(args: FileRenameArgs): Promise<FileResult<FileDto>> {+ const current = await this.repository.getById(args.fileId);+ if (!current) return fail('not_found');+ const name = this.keepExtension(this.normalizeName(args.name), current.originalName);+ const row = await this.repository.rename({ fileId: args.fileId, name });+ if (!row) return fail('not_found');+ const linked = await this.repository.linkedTaskIdsFor([row.id]);+ this.emitChanged(row.goalId, linked.get(row.id) ?? []);+ return ok(this.toDto(row, linked.get(row.id) ?? []));+ }++ async deleteForever(fileId: string): Promise<FileResult<null>> {+ const file = await this.repository.getById(fileId);+ if (!file) return fail('not_found');+ const linked = (await this.repository.linkedTaskIdsFor([fileId])).get(fileId) ?? [];++ await this.repository.delete(fileId);+ try {+ await this.storages.get(file.storageProvider).delete(file.storageKey);+ } catch (err) {+ $logger.error(err, `[FilesManager] storage delete failed for ${file.storageKey}`);+ }++ this.emitChanged(file.goalId, linked);+ return ok(null);+ }++ async issueDownloadUrl(args: FileIssueDownloadUrlArgs): Promise<FileResult<FileDownloadUrl>> {+ const file = await this.repository.getById(args.fileId);+ if (!file) return fail('not_found');+ const exp = Math.floor(Date.now() / 1000) + FILE_DOWNLOAD_TOKEN_TTL_SECONDS;+ const token = new FileDownloadTokens().sign({ fileId: file.id, inline: args.inline, exp });+ return ok({ url: `/module/files/content/${token}`, expiresAt: new Date(exp * 1000).toISOString() });+ }++ async openContent(token: string): Promise<FileResult<FileContent>> {+ const payload = new FileDownloadTokens().verify(token);+ if (!payload) return fail('forbidden', 'invalid or expired token');+ const file = await this.repository.getById(payload.fileId);+ if (!file) return fail('not_found');+ try {+ const { stream, sizeBytes } = await this.storages.get(file.storageProvider).get(file.storageKey);+ return ok({ file, stream, sizeBytes: sizeBytes || file.sizeBytes, inline: payload.inline });+ } catch (err) {+ $logger.error(err, `[FilesManager] storage get failed for ${file.storageKey}`);+ return fail('storage_error');+ }+ }++ private emitChanged(goalId: number, taskIds: number[]) {+ eventBus.emit('files.changed', { goalId, taskIds, initiatorId: this.initiatorId });+ }++ private async toDtos(rows: FilesSchemaTypeForSelect[]): Promise<FileDto[]> {+ const linked = await this.repository.linkedTaskIdsFor(rows.map((r) => r.id));+ return rows.map((r) => this.toDto(r, linked.get(r.id) ?? []));+ }++ private toDto(row: FilesSchemaTypeForSelect, linkedTaskIds: number[]): FileDto {+ return {+ id: row.id,+ goalId: row.goalId,+ name: row.name,+ originalName: row.originalName,+ mimeType: row.mimeType,+ sizeBytes: row.sizeBytes,+ uploaderId: row.uploaderId,+ uploaderEmail: row.uploaderEmail,+ createdAt: row.createdAt.toISOString(),+ linkedTaskIds,+ };+ }++ private normalizeName(name: string): string {+ const trimmed = name.replace(/[\\/]/g, '_').replace(/\p{Cc}/gu, '_').trim();+ return this.truncate(trimmed || 'file', FILE_NAME_MAX_LENGTH);+ }++ private keepExtension(name: string, originalName: string): string {+ const dot = originalName.lastIndexOf('.');+ if (dot <= 0) return name;+ const ext = originalName.slice(dot);+ if (name.toLowerCase().endsWith(ext.toLowerCase())) return name;+ const base = this.truncate(name, FILE_NAME_MAX_LENGTH - ext.length);+ return `${base || 'file'}${ext}`;+ }++ private truncate(value: string, max: number): string {+ const points = Array.from(value);+ return points.length <= max ? value : points.slice(0, max).join('');+ }+}diff --git a/api/src/tv-modules/files/FilesRepository.ts b/api/src/tv-modules/files/FilesRepository.tsnew file mode 100644index 0000000..244a382--- /dev/null+++ b/api/src/tv-modules/files/FilesRepository.ts@@ -0,0 +1,179 @@+import { and, desc, eq, ilike, inArray, like, lt, not, notInArray, or, sql, type SQL } from 'drizzle-orm';+import { alias } from 'drizzle-orm/pg-core';+import {+ FileToTaskSchema,+ FilesSchema,+ type FilesSchemaTypeForSelect,+} from 'taskview-db-schemas';+import { Database } from '../../modules/db';+import type {+ FileInsertArgs,+ FileLinkRowsArgs,+ FileListArgs,+ FileListByProviderArgs,+ FileListCursor,+ FileRenameArgs,+ FileUnlinkArgs,+ FileUpdateStorageProviderArgs,+} from './types';++export class FilesRepository {+ private readonly db: Database;++ constructor() {+ this.db = Database.getInstance();+ }++ async insert(args: FileInsertArgs): Promise<FilesSchemaTypeForSelect> {+ const [row] = await this.db.dbDrizzle.insert(FilesSchema).values(args).returning();+ return row;+ }++ async getById(fileId: string): Promise<FilesSchemaTypeForSelect | null> {+ const [row] = await this.db.dbDrizzle.select().from(FilesSchema).where(eq(FilesSchema.id, fileId)).limit(1);+ return row ?? null;+ }++ async getByIds(fileIds: string[]): Promise<FilesSchemaTypeForSelect[]> {+ if (fileIds.length === 0) return [];+ return this.db.dbDrizzle.select().from(FilesSchema).where(inArray(FilesSchema.id, fileIds));+ }++ async listForGoal(args: FileListArgs): Promise<FilesSchemaTypeForSelect[]> {+ const conditions = [eq(FilesSchema.goalId, args.goalId)];+ if (args.search) conditions.push(ilike(FilesSchema.name, `%${this.escapeLike(args.search)}%`));+ if (args.type === 'image') conditions.push(like(FilesSchema.mimeType, 'image/%'));+ if (args.type === 'document') conditions.push(not(like(FilesSchema.mimeType, 'image/%')));++ const cursor = this.decodeCursor(args.cursor);+ if (cursor) conditions.push(this.beforeCursor(cursor));++ return this.db.dbDrizzle+ .select()+ .from(FilesSchema)+ .where(and(...conditions))+ .orderBy(desc(FilesSchema.createdAt), desc(FilesSchema.id))+ .limit(args.limit);+ }++ async listForTask(taskId: number): Promise<FilesSchemaTypeForSelect[]> {+ const rows = await this.db.dbDrizzle+ .select({ file: FilesSchema })+ .from(FileToTaskSchema)+ .innerJoin(FilesSchema, eq(FileToTaskSchema.fileId, FilesSchema.id))+ .where(eq(FileToTaskSchema.taskId, taskId))+ .orderBy(desc(FileToTaskSchema.linkedAt), desc(FilesSchema.id));+ return rows.map((r) => r.file);+ }++ async listByProvider(args: FileListByProviderArgs): Promise<FilesSchemaTypeForSelect[]> {+ const conditions = [eq(FilesSchema.storageProvider, args.provider)];+ if (args.goalId) conditions.push(eq(FilesSchema.goalId, args.goalId));+ if (args.excludeIds.length > 0) conditions.push(notInArray(FilesSchema.id, args.excludeIds));+ return this.db.dbDrizzle+ .select()+ .from(FilesSchema)+ .where(and(...conditions))+ .orderBy(FilesSchema.createdAt, FilesSchema.id)+ .limit(args.limit);+ }++ async linkedTaskIdsFor(fileIds: string[]): Promise<Map<string, number[]>> {+ const map = new Map<string, number[]>();+ if (fileIds.length === 0) return map;+ const rows = await this.db.dbDrizzle+ .select({ fileId: FileToTaskSchema.fileId, taskId: FileToTaskSchema.taskId })+ .from(FileToTaskSchema)+ .where(inArray(FileToTaskSchema.fileId, fileIds));+ rows.forEach((r) => {+ const list = map.get(r.fileId) ?? [];+ list.push(r.taskId);+ map.set(r.fileId, list);+ });+ return map;+ }++ async countForTasks(taskIds: number[]): Promise<Map<number, number>> {+ const map = new Map<number, number>();+ if (taskIds.length === 0) return map;+ const rows = await this.db.dbDrizzle+ .select({ taskId: FileToTaskSchema.taskId, count: sql<number>`count(*)::int` })+ .from(FileToTaskSchema)+ .where(inArray(FileToTaskSchema.taskId, taskIds))+ .groupBy(FileToTaskSchema.taskId);+ for (const row of rows) map.set(row.taskId, row.count);+ return map;+ }++ async link(args: FileLinkRowsArgs): Promise<void> {+ if (args.fileIds.length === 0) return;+ await this.db.dbDrizzle+ .insert(FileToTaskSchema)+ .values(+ args.fileIds.map((fileId) => ({+ fileId,+ taskId: args.taskId,+ linkedById: args.linkedById,+ linkedByEmail: args.linkedByEmail,+ }))+ )+ .onConflictDoNothing();+ }++ async unlink(args: FileUnlinkArgs): Promise<boolean> {+ const rows = await this.db.dbDrizzle+ .delete(FileToTaskSchema)+ .where(and(eq(FileToTaskSchema.fileId, args.fileId), eq(FileToTaskSchema.taskId, args.taskId)))+ .returning({ fileId: FileToTaskSchema.fileId });+ return rows.length > 0;+ }++ async rename(args: FileRenameArgs): Promise<FilesSchemaTypeForSelect | null> {+ const [row] = await this.db.dbDrizzle+ .update(FilesSchema)+ .set({ name: args.name, editedAt: new Date() })+ .where(eq(FilesSchema.id, args.fileId))+ .returning();+ return row ?? null;+ }++ async updateStorageProvider(args: FileUpdateStorageProviderArgs): Promise<void> {+ await this.db.dbDrizzle+ .update(FilesSchema)+ .set({ storageProvider: args.provider, editedAt: new Date() })+ .where(eq(FilesSchema.id, args.fileId));+ }++ async delete(fileId: string): Promise<boolean> {+ const rows = await this.db.dbDrizzle+ .delete(FilesSchema)+ .where(eq(FilesSchema.id, fileId))+ .returning({ id: FilesSchema.id });+ return rows.length > 0;+ }++ private beforeCursor(cursor: FileListCursor): SQL {+ const cursorFile = alias(FilesSchema, 'cursor_file');+ const cursorCreatedAt = this.db.dbDrizzle+ .select({ value: cursorFile.createdAt })+ .from(cursorFile)+ .where(eq(cursorFile.id, cursor.id));+ return or(+ lt(FilesSchema.createdAt, cursorCreatedAt),+ and(eq(FilesSchema.createdAt, cursorCreatedAt), lt(FilesSchema.id, cursor.id))+ ) as SQL;+ }++ encodeCursor(file: FilesSchemaTypeForSelect): string {+ return file.id;+ }++ private decodeCursor(raw: string | null): FileListCursor | null {+ if (!raw || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(raw)) return null;+ return { id: raw };+ }++ private escapeLike(value: string): string {+ return value.replace(/[\\%_]/g, (m) => `\\${m}`);+ }+}diff --git a/api/src/tv-modules/files/FilesRoutes.ts b/api/src/tv-modules/files/FilesRoutes.tsnew file mode 100644index 0000000..0eedb92--- /dev/null+++ b/api/src/tv-modules/files/FilesRoutes.ts@@ -0,0 +1,42 @@+import { Router } from 'express';+import type { Routable } from '../../types/routable.type';+import { GoalPermissions } from '../../types/auth.types';+import { IsLoggedIn } from '../auth/middlewares/is-logged-in';+import FilesController from './FilesController';+import { goalIdFromFile, goalIdFromParam, goalIdFromTask } from './middlewares/goal-id-resolvers';+import { requireFilePermission } from './middlewares/require-file-permission';++export default class FilesRoutes implements Routable {+ private readonly router: ReturnType<typeof Router>;+ private readonly controller: FilesController;++ constructor() {+ this.router = Router();+ this.controller = new FilesController();+ this.initRoutes();+ }++ getRouter() {+ return this.router;+ }++ initRoutes() {+ // Project scope: upload (multipart, optional ?taskId= to link right away) and paginated listing.+ this.router.post('/goal/:goalId', [IsLoggedIn, requireFilePermission(GoalPermissions.FILE_CAN_MANAGE, goalIdFromParam)], this.controller.upload);+ this.router.get('/goal/:goalId', [IsLoggedIn, requireFilePermission(GoalPermissions.FILE_CAN_VIEW, goalIdFromParam)], this.controller.listForGoal);++ // Task scope: files of a task, link existing project files, unlink (the file itself stays).+ this.router.get('/task/:taskId', [IsLoggedIn, requireFilePermission(GoalPermissions.FILE_CAN_VIEW, goalIdFromTask)], this.controller.listForTask);+ this.router.post('/task/:taskId/link', [IsLoggedIn, requireFilePermission(GoalPermissions.FILE_CAN_MANAGE, goalIdFromTask)], this.controller.link);+ this.router.delete('/task/:taskId/file/:fileId', [IsLoggedIn, requireFilePermission(GoalPermissions.FILE_CAN_MANAGE, goalIdFromTask)], this.controller.unlink);++ // Single file: metadata, rename, delete forever, short-lived download URL.+ this.router.get('/file/:fileId', [IsLoggedIn, requireFilePermission(GoalPermissions.FILE_CAN_VIEW, goalIdFromFile)], this.controller.getOne);+ this.router.patch('/file/:fileId', [IsLoggedIn, requireFilePermission(GoalPermissions.FILE_CAN_MANAGE, goalIdFromFile)], this.controller.rename);+ this.router.delete('/file/:fileId', [IsLoggedIn, requireFilePermission(GoalPermissions.FILE_CAN_MANAGE, goalIdFromFile)], this.controller.remove);+ this.router.post('/file/:fileId/download-url', [IsLoggedIn, requireFilePermission(GoalPermissions.FILE_CAN_VIEW, goalIdFromFile)], this.controller.downloadUrl);++ // Content is served by the signed token alone: browsers cannot attach the JWT to <img src> or <a download>.+ this.router.get('/content/:token', this.controller.content);+ }+}diff --git a/api/src/tv-modules/files/middlewares/goal-id-resolvers.ts b/api/src/tv-modules/files/middlewares/goal-id-resolvers.tsnew file mode 100644index 0000000..643adc7--- /dev/null+++ b/api/src/tv-modules/files/middlewares/goal-id-resolvers.ts@@ -0,0 +1,21 @@+import type { Request } from 'express';+import { TasksRepository } from '../../tasks/TasksRepository';+import { FilesRepository } from '../FilesRepository';++export function goalIdFromParam(req: Request): number | null {+ return req.params.goalId != null ? Number(req.params.goalId) : null;+}++export async function goalIdFromFile(req: Request): Promise<number | null> {+ const fileId = req.params.fileId;+ if (!fileId || !/^[0-9a-f-]{36}$/i.test(fileId)) return null;+ const file = await new FilesRepository().getById(fileId);+ return file?.goalId ?? null;+}++export async function goalIdFromTask(req: Request): Promise<number | null> {+ const taskId = Number(req.params.taskId);+ if (!Number.isFinite(taskId)) return null;+ const task = await new TasksRepository().fetchTaskByIdNew(taskId);+ return task?.goalId ?? null;+}diff --git a/api/src/tv-modules/files/middlewares/require-file-permission.ts b/api/src/tv-modules/files/middlewares/require-file-permission.tsnew file mode 100644index 0000000..05b68f9--- /dev/null+++ b/api/src/tv-modules/files/middlewares/require-file-permission.ts@@ -0,0 +1,26 @@+import type { NextFunction, Request, Response } from 'express';+import { GoalPermissionsFetcher } from '../../../core/GoalPermissionsFetcher';+import { $logger } from '../../../modules/logget';+import type { GoalPermissionType } from '../../../types/auth.types';+import { logError } from '../../../utils/api';++type GoalIdResolver = (req: Request) => Promise<number | null> | number | null;++export function requireFilePermission(permission: GoalPermissionType, resolveGoalId: GoalIdResolver) {+ return async (req: Request, res: Response, next: NextFunction) => {+ const goalId = await resolveGoalId(req);+ if (!goalId) return res.status(404).end();++ const permissions = await req.appUser.permissionsFetcher+ .getPermissionsForType(goalId, GoalPermissionsFetcher.PERMISSION_TYPE_FOR_GOAL)+ .catch(logError);++ if (!permissions) {+ $logger.error('Can not resolve file permissions');+ return res.status(500).end();+ }++ if (permissions.hasPermissions(permission)) return next();+ return res.status(403).end();+ };+}diff --git a/api/src/tv-modules/files/storage/FileStorage.ts b/api/src/tv-modules/files/storage/FileStorage.tsnew file mode 100644index 0000000..9a02cd1--- /dev/null+++ b/api/src/tv-modules/files/storage/FileStorage.ts@@ -0,0 +1,10 @@+import type { FileStorageProvider } from 'taskview-db-schemas';+import type { StorageGetResult, StoragePutArgs, StoredObject } from './storage.types';++export interface FileStorage {+ readonly provider: FileStorageProvider;+ put(args: StoragePutArgs): Promise<StoredObject>;+ get(key: string): Promise<StorageGetResult>;+ delete(key: string): Promise<void>;+ exists(key: string): Promise<boolean>;+}diff --git a/api/src/tv-modules/files/storage/storage.types.ts b/api/src/tv-modules/files/storage/storage.types.tsnew file mode 100644index 0000000..90ea7f0--- /dev/null+++ b/api/src/tv-modules/files/storage/storage.types.ts@@ -0,0 +1,63 @@+import type { Readable } from 'node:stream';+import type { FileStorageProvider } from 'taskview-db-schemas';+import type { FileStorage } from './FileStorage';+import type { FilesRepository } from '../FilesRepository';++export type LocalFileStorageConfig = {+ type: 'local';+ rootDir: string;+};++export type S3FileStorageConfig = {+ type: 's3';+ bucket: string;+ region: string;+ endpoint: string | null;+ accessKeyId: string;+ secretAccessKey: string;+ forcePathStyle: boolean;+};++export type FileStorageProviderConfig = LocalFileStorageConfig | S3FileStorageConfig;++export type FileStorageConfig = {+ maxFileSizeBytes: number;+ active: FileStorageProvider;+ providers: Partial<Record<FileStorageProvider, FileStorageProviderConfig>>;+};++export type StoragePutArgs = {+ key: string;+ stream: Readable;+ mimeType: string;+};++export type StoredObject = {+ key: string;+ sizeBytes: number;+};++export type StorageGetResult = {+ stream: Readable;+ sizeBytes: number;+};++export type FileStorageMigratorArgs = {+ source: FileStorage;+ target: FileStorage;+ repository: FilesRepository;+ batchSize?: number;+ goalId?: number | null;+};++export type FileMigrationError = {+ fileId: string;+ reason: string;+};++export type FileMigrationReport = {+ migrated: number;+ skipped: number;+ cleanupFailed: number;+ errors: FileMigrationError[];+};diff --git a/api/src/tv-modules/files/types.ts b/api/src/tv-modules/files/types.tsnew file mode 100644index 0000000..301f015--- /dev/null+++ b/api/src/tv-modules/files/types.ts@@ -0,0 +1,131 @@+import { type } from 'arktype';+import type { Readable } from 'node:stream';+import type { FileStorageProvider, FilesSchemaTypeForInsert, FilesSchemaTypeForSelect } from 'taskview-db-schemas';++export const FILE_LIST_DEFAULT_LIMIT = 50;+export const FILE_LIST_MAX_LIMIT = 200;+export const FILE_DOWNLOAD_TOKEN_TTL_SECONDS = 300;+export const FILE_NAME_MAX_LENGTH = 255;++const toNumber = type('string | number').pipe((v) => Number(v));++export const FileArkTypeGoalIdParam = type({ goalId: toNumber });+export const FileArkTypeTaskIdParam = type({ taskId: toNumber });+export const FileArkTypeFileIdParam = type({ fileId: 'string.uuid' });+export const FileArkTypeTaskFileParams = type({ taskId: toNumber, fileId: 'string.uuid' });+export const FileArkTypeTokenParam = type({ token: 'string > 0' });++export const FileArkTypeListQuery = type({+ goalId: toNumber,+ 'search?': 'string',+ 'type?': "'image' | 'document' | 'all'",+ 'cursor?': 'string',+ 'limit?': toNumber,+});++export const FileArkTypeUploadQuery = type({ 'taskId?': toNumber });+export const FileArkTypeLink = type({ fileIds: 'string.uuid[] > 0' });+export const FileArkTypeRename = type({ name: 'string > 0' }); // length is normalized in the manager, the extension is re-added there+export const FileArkTypeDownloadUrl = type({ 'inline?': 'boolean' });+export const FileArkTypeContentQuery = type({ 'inline?': 'string' });++export type FileKindFilter = 'image' | 'document' | 'all';++export type FileUploadArgs = {+ goalId: number;+ uploaderId: number;+ uploaderEmail: string;+ taskId: number | null;+ originalName: string;+ mimeType: string;+ stream: Readable;+};++export type FileListArgs = {+ goalId: number;+ search: string | null;+ type: FileKindFilter;+ cursor: string | null;+ limit: number;+};++export type FileLinkArgs = {+ taskId: number;+ fileIds: string[];+ linkedById: number;+ linkedByEmail: string;+};++export type FileUnlinkArgs = {+ taskId: number;+ fileId: string;+};++export type FileRenameArgs = {+ fileId: string;+ name: string;+};++export type FileInsertArgs = Omit<FilesSchemaTypeForInsert, 'createdAt' | 'editedAt'>;++export type FileListByProviderArgs = {+ provider: FileStorageProvider;+ excludeIds: string[];+ limit: number;+ goalId?: number | null;+};++export type FileUpdateStorageProviderArgs = {+ fileId: string;+ provider: FileStorageProvider;+};++export type FileLinkRowsArgs = {+ taskId: number;+ fileIds: string[];+ linkedById: number;+ linkedByEmail: string;+};++export type FileDownloadTokenPayload = {+ fileId: string;+ inline: boolean;+ exp: number;+};++export type FileIssueDownloadUrlArgs = {+ fileId: string;+ inline: boolean;+};++// Storage internals and the checksum stay on the server; dates go out as ISO strings.+type FileInternalColumns = 'storageProvider' | 'storageKey' | 'checksumSha256' | 'createdAt' | 'editedAt';++export type FileDto = Omit<FilesSchemaTypeForSelect, FileInternalColumns> & {+ createdAt: string;+ linkedTaskIds: number[];+};++export type FileListPage = {+ items: FileDto[];+ nextCursor: string | null;+};++export type FileDownloadUrl = {+ url: string;+ expiresAt: string;+};++export type FileContent = {+ file: FilesSchemaTypeForSelect;+ stream: Readable;+ sizeBytes: number;+ inline: boolean;+};++export type FileErrorCode = 'not_found' | 'forbidden' | 'too_large' | 'invalid' | 'storage_error';+export type FileResult<T> = { ok: true; data: T } | { ok: false; code: FileErrorCode; message?: string };++export type FileListCursor = {+ id: string;+};diff --git a/api/src/tv-modules/tasks/TasksManager.ts b/api/src/tv-modules/tasks/TasksManager.tsindex 2506d4e..8ab957f 100644--- a/api/src/tv-modules/tasks/TasksManager.ts+++ b/api/src/tv-modules/tasks/TasksManager.ts@@ -26,6 +26,7 @@ import type {} from '../../types/tasks.types';import { TaskItemForClient } from './TaskItemForClient';import { TasksRepository } from './TasksRepository';+import { FilesRepository } from '../files/FilesRepository';import {type TaskArgAdd,type TaskArgDelete,@@ -345,6 +346,7 @@ export class TasksManager {assignedUsers: [],historyId: null,subtasks: [],+ filesCount: 0,})));}@@ -355,13 +357,16 @@ export class TasksManager {const taskPermissions = await this.user.permissionsFetcher.getCheckerForGoal(tasks[0].goalId);- const [tags, assignees] = await Promise.all([+ const [tags, assignees, filesCount] = await Promise.all([taskPermissions.hasPermissions(GoalPermissions.TASKS_CAN_WATCH_TAGS)? this.repository.fetchTagsForTasks(ids): Promise.resolve([]),taskPermissions.hasPermissions(GoalPermissions.TASKS_CAN_WATCH_ASSIGNED_USERS)? this.repository.fetchTaskAssigneeForTasks(ids): Promise.resolve([]),+ taskPermissions.hasPermissions(GoalPermissions.FILE_CAN_VIEW)+ ? new FilesRepository().countForTasks(ids)+ : Promise.resolve(new Map<number, number>()),]);tags.forEach((item) => {@@ -384,6 +389,7 @@ export class TasksManager {tags: tagsMap.get(t.id) || [],assignedUsers: assigneesMap.get(t.id) || [],historyId: null,+ filesCount: filesCount.get(t.id) ?? 0,//subtasks should be without subtasks, tags and assigneessubtasks: await this.extendTasksWithTagsAndAssignees(taskPermissions.hasPermissions(GoalPermissions.TASKS_CAN_WATCH_SUBTASKS)diff --git a/api/src/tv-modules/tasks/tasks.server.types.ts b/api/src/tv-modules/tasks/tasks.server.types.tsindex 9fb3686..64b31b1 100644--- a/api/src/tv-modules/tasks/tasks.server.types.ts+++ b/api/src/tv-modules/tasks/tasks.server.types.ts@@ -173,6 +173,7 @@ export type TaskForClientNew = TasksSchemaTypeForSelect & {assignedUsers: number[];historyId: number | null;subtasks: TaskForClientNew[];+ filesCount: number;};export const TaskArkTypeDelete = type({diff --git a/api/src/types/auth.types.ts b/api/src/types/auth.types.tsindex 265ef13..ea516ad 100644--- a/api/src/types/auth.types.ts+++ b/api/src/types/auth.types.ts@@ -205,6 +205,9 @@ export const GoalPermissions = {SPRINT_CAN_MANAGE: 'sprint_can_manage',SPRINT_CAN_ASSIGN_TASKS: 'sprint_can_assign_tasks',SPRINT_CAN_VIEW_ANALYTICS: 'sprint_can_view_analytics',++ FILE_CAN_VIEW: 'file_can_view',+ FILE_CAN_MANAGE: 'file_can_manage',} as const;export type PermissionsEntityType =diff --git a/api/vite.config-files-migrate.mts b/api/vite.config-files-migrate.mtsnew file mode 100644index 0000000..6ed1999--- /dev/null+++ b/api/vite.config-files-migrate.mts@@ -0,0 +1,47 @@+import { defineConfig } from 'vite';+import { VitePluginNode } from 'vite-plugin-node';++// Bundles the file-storage migration CLI next to the server bundle, so a production container+// can run it with plain node: `npm run files:migrate -- --from local --to s3`.+export default defineConfig({+ plugins: [+ ...VitePluginNode({+ adapter: 'express',+ appPath: './src/scripts/files-migrate-storage.ts',+ }),+ ],+ ssr: {+ noExternal: true,+ },+ esbuild: {+ target: 'es2021',+ define: {+ 'process.env.NODE_TV_ENV': '"production"',+ },+ },+ build: {+ outDir: 'dist',+ emptyOutDir: false,+ target: "es2021",+ minify: 'terser',+ terserOptions: {+ ecma: 2015,+ compress: true,+ mangle: {+ properties: false,+ },+ format: {+ comments: true,+ },+ },+ rollupOptions: {+ external: ['pg-native'],+ output: {+ format: 'umd',+ entryFileNames: 'taskview-files-migrate.js',+ chunkFileNames: 'taskview-files-migrate-[hash].js',+ assetFileNames: 'taskview-files-migrate-[name]-[hash].[ext]',+ },+ },+ },+});diff --git a/api/vitest.config.ts b/api/vitest.config.tsindex cdc2788..a950457 100644--- a/api/vitest.config.ts+++ b/api/vitest.config.ts@@ -16,6 +16,17 @@ export default defineConfig({ACCESS_LIFE_TIME: '5d',REFRESH_LIFE_TIME: '3s',JWT_ALG: 'HS256',+ ENCRYPTION_KEY: 'ab'.repeat(32),+ FILE_STORAGE_PROVIDER: 'local',+ FILE_STORAGE_LOCAL_DIR: './.test-data/files',+ FILE_MAX_SIZE_MB: '1',+ // MinIO from dev-containers-test/docker-compose.minio.yml+ FILE_STORAGE_S3_BUCKET: 'taskview-test',+ FILE_STORAGE_S3_REGION: 'us-east-1',+ FILE_STORAGE_S3_ENDPOINT: 'http://localhost:9000',+ FILE_STORAGE_S3_ACCESS_KEY: 'minioadmin',+ FILE_STORAGE_S3_SECRET_KEY: 'minioadmin',+ FILE_STORAGE_S3_FORCE_PATH_STYLE: 'true',...conf,APP_URL: 'http://localhost:3000',},diff --git a/docs/4.configuration/1.environment-variables.md b/docs/4.configuration/1.environment-variables.mdindex 72481d8..5ea97f5 100644--- a/docs/4.configuration/1.environment-variables.md+++ b/docs/4.configuration/1.environment-variables.md@@ -245,6 +245,36 @@ Then set `CENTRIFUGO_PUBLIC_URL=wss://api.example.com/centrifugo/connection/websBoth Centrifugo and Firebase are optional. If not configured, their respective channels are skipped. Notifications are always persisted to the database.::+## Files (task attachments)++Uploaded files are stored outside PostgreSQL; the database keeps only metadata (name, size, SHA-256 checksum, which provider holds the bytes). Two providers are supported and both may be configured at the same time, which is how an instance is migrated from one to the other without downtime.++| Variable | Required | Default | Description |+|---|---|---|---|+| `FILE_STORAGE_PROVIDER` | No | `local` | Provider that receives new uploads: `local` or `s3`. Its settings must be present. |+| `FILE_MAX_SIZE_MB` | No | `50` | Maximum size of one uploaded file in megabytes. |+| `FILE_STORAGE_LOCAL_DIR` | No | `./data/files` | Directory for the `local` provider. In Docker mount it as a volume. |+| `FILE_STORAGE_S3_BUCKET` | For `s3` | - | Bucket name. Setting it enables the `s3` provider. |+| `FILE_STORAGE_S3_REGION` | For `s3` | - | Region, e.g. `us-east-1`. Any value works for MinIO. |+| `FILE_STORAGE_S3_ENDPOINT` | No | - | Custom endpoint for S3-compatible storage (MinIO, Cloudflare R2, Backblaze B2). Leave empty for AWS. |+| `FILE_STORAGE_S3_ACCESS_KEY` | For `s3` | - | Access key id. |+| `FILE_STORAGE_S3_SECRET_KEY` | For `s3` | - | Secret access key. |+| `FILE_STORAGE_S3_FORCE_PATH_STYLE` | No | `false` | Set to `true` for MinIO and most self-hosted S3-compatible servers. |++### Moving files between providers++1. Add the settings of the new provider while `FILE_STORAGE_PROVIDER` still points to the old one.+2. Run the migration inside the API container (the CLI ships in the image next to the server bundle):++ ```bash+ docker exec -it <api-container> npm run files:migrate -- --from local --to s3+ ```++ Use `--to local --from s3` for the reverse direction and add `--goal <projectId>` to move a single project. From a source checkout the same command is `pnpm --filter taskview-ce-api-server build:files-migrate && pnpm --filter taskview-ce-api-server files:migrate -- --from local --to s3`. The API keeps running; each file is copied, verified against its checksum, switched in the database and then removed from the old provider.+3. Switch `FILE_STORAGE_PROVIDER` to the new provider and restart the API.+4. Run the same command once more to pick up files uploaded between steps 2 and 3. A report of `migrated: 0` means the move is complete.+5. Remove the old provider's variables.+## Full exampleHere's a complete `.env.taskview` file for a production deployment:@@ -325,4 +355,9 @@ TELEGRAM_WEBHOOK_SECRET=# CENTRIFUGO_API_KEY=your_centrifugo_api_key# CENTRIFUGO_TOKEN_SECRET=your_centrifugo_token_secret# CENTRIFUGO_PUBLIC_URL=wss://api.example.com/centrifugo/connection/websocket++# Files+FILE_STORAGE_PROVIDER=local+FILE_STORAGE_LOCAL_DIR=/usr/src/app/data/files+# FILE_MAX_SIZE_MB=50```diff --git a/taskview-packages/taskview-api/src/api/files.ts b/taskview-packages/taskview-api/src/api/files.tsnew file mode 100644index 0000000..2f561ca--- /dev/null+++ b/taskview-packages/taskview-api/src/api/files.ts@@ -0,0 +1,80 @@+import TvApiBase from './base';+import type { AppResponse } from './base.types';+import type {+ TvFile,+ TvFileDownloadUrl,+ TvFileDownloadUrlArgs,+ TvFileLinkArgs,+ TvFileListArgs,+ TvFileListPage,+ TvFileRenameArgs,+ TvFileUnlinkArgs,+ TvFileUploadArgs,+} from './files.types';++export default class TvFilesApi extends TvApiBase {+ protected moduleUrl = '/module/files';++ public async upload(args: TvFileUploadArgs) {+ const form = new FormData();+ form.append('file', args.file, args.fileName);+ const query = args.taskId !== null ? `?taskId=${args.taskId}` : '';+ return this.request(+ this.$axios.post<AppResponse<TvFile>>(`${this.moduleUrl}/goal/${args.goalId}${query}`, form, {+ headers: { 'Content-Type': 'multipart/form-data' },+ signal: args.signal,+ onUploadProgress: (event) => {+ if (!args.onProgress) return;+ const total = event.total ?? args.file.size;+ args.onProgress(total > 0 ? Math.min(100, Math.round((event.loaded / total) * 100)) : 0);+ },+ })+ );+ }++ public async listForGoal(args: TvFileListArgs) {+ const params = new URLSearchParams();+ if (args.search) params.set('search', args.search);+ if (args.type) params.set('type', args.type);+ if (args.cursor) params.set('cursor', args.cursor);+ if (args.limit) params.set('limit', String(args.limit));+ const query = params.toString();+ return this.request(+ this.$axios.get<AppResponse<TvFileListPage>>(`${this.moduleUrl}/goal/${args.goalId}${query ? `?${query}` : ''}`)+ );+ }++ public async listForTask(taskId: number) {+ return this.request(this.$axios.get<AppResponse<TvFile[]>>(`${this.moduleUrl}/task/${taskId}`));+ }++ public async getById(fileId: string) {+ return this.request(this.$axios.get<AppResponse<TvFile>>(`${this.moduleUrl}/file/${fileId}`));+ }++ public async link(args: TvFileLinkArgs) {+ return this.request(+ this.$axios.post<AppResponse<TvFile[]>>(`${this.moduleUrl}/task/${args.taskId}/link`, { fileIds: args.fileIds })+ );+ }++ public async unlink(args: TvFileUnlinkArgs) {+ return this.request(this.$axios.delete<AppResponse<null>>(`${this.moduleUrl}/task/${args.taskId}/file/${args.fileId}`));+ }++ public async rename(args: TvFileRenameArgs) {+ return this.request(this.$axios.patch<AppResponse<TvFile>>(`${this.moduleUrl}/file/${args.fileId}`, { name: args.name }));+ }++ public async deleteForever(fileId: string) {+ return this.request(this.$axios.delete<AppResponse<null>>(`${this.moduleUrl}/file/${fileId}`));+ }++ public async downloadUrl(args: TvFileDownloadUrlArgs) {+ return this.request(+ this.$axios.post<AppResponse<TvFileDownloadUrl>>(`${this.moduleUrl}/file/${args.fileId}/download-url`, {+ inline: args.inline,+ })+ );+ }+}diff --git a/taskview-packages/taskview-api/src/api/files.types.ts b/taskview-packages/taskview-api/src/api/files.types.tsnew file mode 100644index 0000000..4d17cee--- /dev/null+++ b/taskview-packages/taskview-api/src/api/files.types.ts@@ -0,0 +1,61 @@+export type TvFileKindFilter = 'image' | 'document' | 'all';++export type TvFile = {+ id: string;+ goalId: number;+ name: string;+ originalName: string;+ mimeType: string;+ sizeBytes: number;+ uploaderId: number | null;+ uploaderEmail: string;+ createdAt: string;+ linkedTaskIds: number[];+};++export type TvFileListPage = {+ items: TvFile[];+ nextCursor: string | null;+};++export type TvFileDownloadUrl = {+ url: string;+ expiresAt: string;+};++export type TvFileListArgs = {+ goalId: number;+ search?: string | null;+ type?: TvFileKindFilter;+ cursor?: string | null;+ limit?: number;+};++export type TvFileUploadArgs = {+ goalId: number;+ taskId: number | null;+ file: Blob;+ fileName: string;+ onProgress?: (percent: number) => void;+ signal?: AbortSignal;+};++export type TvFileLinkArgs = {+ taskId: number;+ fileIds: string[];+};++export type TvFileUnlinkArgs = {+ taskId: number;+ fileId: string;+};++export type TvFileRenameArgs = {+ fileId: string;+ name: string;+};++export type TvFileDownloadUrlArgs = {+ fileId: string;+ inline: boolean;+};diff --git a/taskview-packages/taskview-api/src/api/permissions.ts b/taskview-packages/taskview-api/src/api/permissions.tsindex 14009a1..5374180 100644--- a/taskview-packages/taskview-api/src/api/permissions.ts+++ b/taskview-packages/taskview-api/src/api/permissions.ts@@ -164,6 +164,15 @@ export const TvPermissions: Record<Uppercase<keyof GoalPermissions>, keyof GoalP* Can view sprint analytics (burndown, velocity)*/SPRINT_CAN_VIEW_ANALYTICS: 'sprint_can_view_analytics',++ /**+ * Can list, open and download project files+ */+ FILE_CAN_VIEW: 'file_can_view',+ /**+ * Can upload, rename, link/unlink and delete project files+ */+ FILE_CAN_MANAGE: 'file_can_manage',} as const;export type GoalPermissions = {@@ -217,4 +226,7 @@ export type GoalPermissions = {sprint_can_manage?: true;sprint_can_assign_tasks?: true;sprint_can_view_analytics?: true;++ file_can_view?: true;+ file_can_manage?: true;};\ No newline at end of filediff --git a/taskview-packages/taskview-api/src/api/tasks.api.types.ts b/taskview-packages/taskview-api/src/api/tasks.api.types.tsindex 2c336b7..db6864a 100644--- a/taskview-packages/taskview-api/src/api/tasks.api.types.ts+++ b/taskview-packages/taskview-api/src/api/tasks.api.types.ts@@ -43,6 +43,7 @@ export interface Task extends TaskBase {tags: number[];historyId: null | number;assignedUsers: number[];+ filesCount?: number;};// we can not update defined fieldsdiff --git a/taskview-packages/taskview-api/src/index.ts b/taskview-packages/taskview-api/src/index.tsindex 3635802..69af821 100644--- a/taskview-packages/taskview-api/src/index.ts+++ b/taskview-packages/taskview-api/src/index.ts@@ -25,4 +25,4 @@ export * from '@/api/analytics.types';export * from '@/api/time-tracking.types';export * from '@/api/ui-preferences.types';export * from '@/api/sprints.types';-export * from '@/api/recurrence.types';\ No newline at end of file+export * from '@/api/recurrence.types';export * from '@/api/files.types';diff --git a/taskview-packages/taskview-api/src/tv.ts b/taskview-packages/taskview-api/src/tv.tsindex 6426576..abeafb1 100644--- a/taskview-packages/taskview-api/src/tv.ts+++ b/taskview-packages/taskview-api/src/tv.ts@@ -23,6 +23,7 @@ import TvSprintApi from "./api/sprints";import TvRecurrenceApi from "./api/recurrence";import TvBillingApi from "./api/billing";import TvInvoicesApi from "./api/invoices";+import TvFilesApi from "./api/files";export class TvApi {@@ -73,6 +74,7 @@ export class TvApi {public billing: TvBillingApi;public invoices: TvInvoicesApi;+ public files: TvFilesApi;constructor($axios: AxiosInstance) {this.$axios = $axios;@@ -122,6 +124,7 @@ export class TvApi {this.billing = new TvBillingApi(this.$axios);this.invoices = new TvInvoicesApi(this.$axios);+ this.files = new TvFilesApi(this.$axios);}public setBaseUrl(baseUrl: string) {diff --git a/taskview-packages/taskview-db-schemas/src/index.ts b/taskview-packages/taskview-db-schemas/src/index.tsindex 24077f6..796c48e 100644--- a/taskview-packages/taskview-db-schemas/src/index.ts+++ b/taskview-packages/taskview-db-schemas/src/index.ts@@ -37,3 +37,5 @@ export * from './schemas/recurrence-rules.schema';export * from './schemas/recurrence-skip-dates.schema';export * from './schemas/recurrence-template-assignees.schema';export * from './schemas/recurrence-template-tags.schema';+export * from './schemas/files.schema';+export * from './schemas/file-to-task.schema';diff --git a/taskview-packages/taskview-db-schemas/src/schemas/file-to-task.schema.ts b/taskview-packages/taskview-db-schemas/src/schemas/file-to-task.schema.tsnew file mode 100644index 0000000..9acbdea--- /dev/null+++ b/taskview-packages/taskview-db-schemas/src/schemas/file-to-task.schema.ts@@ -0,0 +1,18 @@+import { index, integer, pgSchema, primaryKey, timestamp, uuid, varchar } from "drizzle-orm/pg-core";+import { FilesSchema } from "./files.schema";+import { TasksSchema } from "./tasks.schema";+import { UsersSchema } from "./users.schema";++export const FileToTaskSchema = pgSchema('tv_files').table('file_to_task', {+ fileId: uuid('file_id').notNull().references(() => FilesSchema.id, { onDelete: 'cascade' }),+ taskId: integer('task_id').notNull().references(() => TasksSchema.id, { onDelete: 'cascade' }),+ linkedById: integer('linked_by_id').references(() => UsersSchema.id, { onDelete: 'set null' }),+ linkedByEmail: varchar('linked_by_email', { length: 255 }).notNull(),+ linkedAt: timestamp('linked_at').notNull().defaultNow(),+}, (t) => [+ primaryKey({ columns: [t.fileId, t.taskId] }),+ index('file_to_task_task_idx').on(t.taskId),+]);++export type FileToTaskSchemaTypeForSelect = typeof FileToTaskSchema.$inferSelect;+export type FileToTaskSchemaTypeForInsert = typeof FileToTaskSchema.$inferInsert;diff --git a/taskview-packages/taskview-db-schemas/src/schemas/files.schema.ts b/taskview-packages/taskview-db-schemas/src/schemas/files.schema.tsnew file mode 100644index 0000000..5609c8b--- /dev/null+++ b/taskview-packages/taskview-db-schemas/src/schemas/files.schema.ts@@ -0,0 +1,28 @@+import { bigint, index, integer, pgSchema, timestamp, uuid, varchar } from "drizzle-orm/pg-core";+import { GoalsSchema } from "./goals.schema";+import { UsersSchema } from "./users.schema";++export type FileStorageProvider = 'local' | 's3';++export const FilesSchema = pgSchema('tv_files').table('files', {+ id: uuid().primaryKey().defaultRandom(),+ goalId: integer('goal_id').notNull().references(() => GoalsSchema.id, { onDelete: 'cascade' }),+ uploaderId: integer('uploader_id').references(() => UsersSchema.id, { onDelete: 'set null' }),+ uploaderEmail: varchar('uploader_email', { length: 255 }).notNull(),+ name: varchar({ length: 255 }).notNull(),+ originalName: varchar('original_name', { length: 255 }).notNull(),+ mimeType: varchar('mime_type', { length: 255 }).notNull(),+ sizeBytes: bigint('size_bytes', { mode: 'number' }).notNull(),+ checksumSha256: varchar('checksum_sha256', { length: 64 }).notNull(),+ storageProvider: varchar('storage_provider', { length: 20 }).$type<FileStorageProvider>().notNull(),+ storageKey: varchar('storage_key', { length: 512 }).notNull(),+ createdAt: timestamp('created_at').notNull().defaultNow(),+ editedAt: timestamp('edited_at').notNull().defaultNow(),+}, (t) => [+ index('files_goal_created_idx').on(t.goalId, t.createdAt),+ index('files_goal_name_idx').on(t.goalId, t.name),+ index('files_provider_idx').on(t.storageProvider),+]);++export type FilesSchemaTypeForSelect = typeof FilesSchema.$inferSelect;+export type FilesSchemaTypeForInsert = typeof FilesSchema.$inferInsert;diff --git a/web/src/locales/de.ts b/web/src/locales/de.tsindex a30f692..2bc6b7d 100644--- a/web/src/locales/de.ts+++ b/web/src/locales/de.ts@@ -100,6 +100,7 @@ export default {kanban: 'Kanban',graph: 'Graph',sprints: 'Sprints',+ files: 'Dateien',collaboration: 'Zusammenarbeit',integrations: 'Integrationen',webhooks: 'Webhooks',@@ -842,6 +843,7 @@ export default {taskFields: {subtasks: 'Teilaufgaben',note: 'Beschreibung',+ files: 'Dateien',status: 'Status',priority: 'Priorität',assignees: 'Zuständige',@@ -1428,4 +1430,71 @@ export default {closeFailed: 'Sprint konnte nicht abgeschlossen werden',},},+ files: {+ title: 'Dateien',+ attach: 'Anhängen',+ upload: 'Hochladen',+ chooseFromProject: 'Aus dem Projekt wählen',+ dropHint: 'Loslassen zum Anhängen',+ emptyHint: 'Noch keine Dateien. Anhängen, hierher ziehen oder aus der Zwischenablage einfügen.',+ empty: 'Keine Dateien',+ searchPlaceholder: 'Nach Name suchen',+ loadMore: 'Mehr laden',+ retry: 'Erneut versuchen',+ cancel: 'Abbrechen',+ close: 'Schließen',+ previous: 'Zurück',+ next: 'Weiter',+ noPermission: 'Sie haben keine Berechtigung, die Dateien dieses Projekts zu sehen',+ filters: {+ all: 'Alle',+ images: 'Bilder',+ documents: 'Dokumente',+ },+ menu: {+ more: 'Mehr',+ download: 'Herunterladen',+ openInNewTab: 'In neuem Tab öffnen',+ rename: 'Umbenennen',+ unlink: 'Aus der Aufgabe entfernen',+ delete: 'Datei löschen',+ },+ rename: {+ title: 'Datei umbenennen',+ label: 'Name',+ submit: 'Umbenennen',+ },+ delete: {+ title: 'Datei löschen',+ confirm: '„{name}“ endgültig löschen?',+ linkedElsewhere: 'Die Datei ist an {count} weitere Aufgabe angehängt | Die Datei ist an {count} weitere Aufgaben angehängt',+ submit: 'Löschen',+ },+ picker: {+ title: 'Dateien aus dem Projekt wählen',+ empty: 'Keine Dateien zur Auswahl',+ submit: '{count} Datei anhängen | {count} Dateien anhängen',+ },+ linkToTask: {+ title: 'An eine Aufgabe anhängen',+ },+ project: {+ unlinked: 'Nicht angehängt',+ empty: 'Noch keine Dateien in diesem Projekt',+ nothingFound: 'Nichts gefunden',+ },+ viewer: {+ noPreview: 'Keine Vorschau für diesen Dateityp',+ },+ errors: {+ tooLarge: 'Datei ist zu groß',+ forbidden: 'Keine Berechtigung zum Hochladen',+ notFound: 'Aufgabe nicht gefunden',+ uploadFailed: 'Hochladen fehlgeschlagen',+ renameFailed: 'Datei konnte nicht umbenannt werden',+ unlinkFailed: 'Datei konnte nicht aus der Aufgabe entfernt werden',+ deleteFailed: 'Datei konnte nicht gelöscht werden',+ linkFailed: 'Datei konnte nicht angehängt werden',+ },+ },}diff --git a/web/src/locales/en.ts b/web/src/locales/en.tsindex 01314d3..e474876 100644--- a/web/src/locales/en.ts+++ b/web/src/locales/en.ts@@ -114,6 +114,7 @@ export default {kanban: 'Kanban',graph: 'Graph',sprints: 'Sprints',+ files: 'Files',collaboration: 'Collaboration',integrations: 'Integrations',webhooks: 'Webhooks',@@ -856,6 +857,7 @@ export default {taskFields: {subtasks: 'Subtasks',note: 'Description',+ files: 'Files',status: 'Status',priority: 'Priority',assignees: 'Assignees',@@ -1442,4 +1444,71 @@ export default {closeFailed: 'Failed to close sprint',},},+ files: {+ title: 'Files',+ attach: 'Attach',+ upload: 'Upload',+ chooseFromProject: 'Choose from project',+ dropHint: 'Drop to attach',+ emptyHint: 'No files yet. Attach one, drag it here or paste from the clipboard.',+ empty: 'No files',+ searchPlaceholder: 'Search by name',+ loadMore: 'Load more',+ retry: 'Retry',+ cancel: 'Cancel',+ close: 'Close',+ previous: 'Previous',+ next: 'Next',+ noPermission: 'You do not have permission to view files of this project',+ filters: {+ all: 'All',+ images: 'Images',+ documents: 'Documents',+ },+ menu: {+ more: 'More',+ download: 'Download',+ openInNewTab: 'Open in new tab',+ rename: 'Rename',+ unlink: 'Remove from task',+ delete: 'Delete file',+ },+ rename: {+ title: 'Rename file',+ label: 'Name',+ submit: 'Rename',+ },+ delete: {+ title: 'Delete file',+ confirm: 'Delete "{name}" forever?',+ linkedElsewhere: 'The file is attached to {count} other task | The file is attached to {count} other tasks',+ submit: 'Delete',+ },+ picker: {+ title: 'Choose files from the project',+ empty: 'No files to choose from',+ submit: 'Attach {count} file | Attach {count} files',+ },+ linkToTask: {+ title: 'Attach to a task',+ },+ project: {+ unlinked: 'Not attached',+ empty: 'No files in this project yet',+ nothingFound: 'Nothing found',+ },+ viewer: {+ noPreview: 'No preview for this file type',+ },+ errors: {+ tooLarge: 'File is too large',+ forbidden: 'No permission to upload',+ notFound: 'Task not found',+ uploadFailed: 'Upload failed',+ renameFailed: 'Failed to rename the file',+ unlinkFailed: 'Failed to remove the file from the task',+ deleteFailed: 'Failed to delete the file',+ linkFailed: 'Failed to attach the file',+ },+ },}diff --git a/web/src/locales/es.ts b/web/src/locales/es.tsindex eca4189..2406cc4 100644--- a/web/src/locales/es.ts+++ b/web/src/locales/es.ts@@ -100,6 +100,7 @@ export default {kanban: 'Kanban',graph: 'Gráfico',sprints: 'Sprints',+ files: 'Archivos',collaboration: 'Colaboración',integrations: 'Integraciones',webhooks: 'Webhooks',@@ -842,6 +843,7 @@ export default {taskFields: {subtasks: 'Subtareas',note: 'Descripción',+ files: 'Archivos',status: 'Estado',priority: 'Prioridad',assignees: 'Responsables',@@ -1428,4 +1430,71 @@ export default {closeFailed: 'Error al cerrar el sprint',},},+ files: {+ title: 'Archivos',+ attach: 'Adjuntar',+ upload: 'Subir',+ chooseFromProject: 'Elegir del proyecto',+ dropHint: 'Suelta para adjuntar',+ emptyHint: 'Aún no hay archivos. Adjunta uno, arrástralo aquí o pégalo desde el portapapeles.',+ empty: 'Sin archivos',+ searchPlaceholder: 'Buscar por nombre',+ loadMore: 'Cargar más',+ retry: 'Reintentar',+ cancel: 'Cancelar',+ close: 'Cerrar',+ previous: 'Anterior',+ next: 'Siguiente',+ noPermission: 'No tienes permiso para ver los archivos de este proyecto',+ filters: {+ all: 'Todos',+ images: 'Imágenes',+ documents: 'Documentos',+ },+ menu: {+ more: 'Más',+ download: 'Descargar',+ openInNewTab: 'Abrir en una pestaña nueva',+ rename: 'Renombrar',+ unlink: 'Quitar de la tarea',+ delete: 'Eliminar archivo',+ },+ rename: {+ title: 'Renombrar archivo',+ label: 'Nombre',+ submit: 'Renombrar',+ },+ delete: {+ title: 'Eliminar archivo',+ confirm: '¿Eliminar «{name}» para siempre?',+ linkedElsewhere: 'El archivo está adjunto a {count} tarea más | El archivo está adjunto a {count} tareas más',+ submit: 'Eliminar',+ },+ picker: {+ title: 'Elegir archivos del proyecto',+ empty: 'No hay archivos para elegir',+ submit: 'Adjuntar {count} archivo | Adjuntar {count} archivos',+ },+ linkToTask: {+ title: 'Adjuntar a una tarea',+ },+ project: {+ unlinked: 'Sin adjuntar',+ empty: 'Aún no hay archivos en este proyecto',+ nothingFound: 'No se encontró nada',+ },+ viewer: {+ noPreview: 'No hay vista previa para este tipo de archivo',+ },+ errors: {+ tooLarge: 'El archivo es demasiado grande',+ forbidden: 'Sin permiso para subir',+ notFound: 'Tarea no encontrada',+ uploadFailed: 'Error al subir',+ renameFailed: 'No se pudo renombrar el archivo',+ unlinkFailed: 'No se pudo quitar el archivo de la tarea',+ deleteFailed: 'No se pudo eliminar el archivo',+ linkFailed: 'No se pudo adjuntar el archivo',+ },+ },}diff --git a/web/src/locales/pt-br.ts b/web/src/locales/pt-br.tsindex ec79171..acc2d50 100644--- a/web/src/locales/pt-br.ts+++ b/web/src/locales/pt-br.ts@@ -113,6 +113,7 @@ export default {kanban: 'Kanban',graph: 'Gráfico',sprints: 'Sprints',+ files: 'Arquivos',collaboration: 'Colaboração',integrations: 'Integrações',webhooks: 'Webhooks',@@ -855,6 +856,7 @@ export default {taskFields: {subtasks: 'Subtarefas',note: 'Descrição',+ files: 'Arquivos',status: 'Status',priority: 'Prioridade',assignees: 'Responsáveis',@@ -1439,4 +1441,71 @@ export default {closeFailed: 'Falha ao encerar a sprint',},},+ files: {+ title: 'Arquivos',+ attach: 'Anexar',+ upload: 'Enviar',+ chooseFromProject: 'Escolher do projeto',+ dropHint: 'Solte para anexar',+ emptyHint: 'Ainda não há arquivos. Anexe um, arraste para cá ou cole da área de transferência.',+ empty: 'Sem arquivos',+ searchPlaceholder: 'Buscar por nome',+ loadMore: 'Carregar mais',+ retry: 'Tentar novamente',+ cancel: 'Cancelar',+ close: 'Fechar',+ previous: 'Anterior',+ next: 'Próximo',+ noPermission: 'Você não tem permissão para ver os arquivos deste projeto',+ filters: {+ all: 'Todos',+ images: 'Imagens',+ documents: 'Documentos',+ },+ menu: {+ more: 'Mais',+ download: 'Baixar',+ openInNewTab: 'Abrir em nova aba',+ rename: 'Renomear',+ unlink: 'Remover da tarefa',+ delete: 'Excluir arquivo',+ },+ rename: {+ title: 'Renomear arquivo',+ label: 'Nome',+ submit: 'Renomear',+ },+ delete: {+ title: 'Excluir arquivo',+ confirm: 'Excluir "{name}" para sempre?',+ linkedElsewhere: 'O arquivo está anexado a mais {count} tarefa | O arquivo está anexado a mais {count} tarefas',+ submit: 'Excluir',+ },+ picker: {+ title: 'Escolher arquivos do projeto',+ empty: 'Não há arquivos para escolher',+ submit: 'Anexar {count} arquivo | Anexar {count} arquivos',+ },+ linkToTask: {+ title: 'Anexar a uma tarefa',+ },+ project: {+ unlinked: 'Não anexado',+ empty: 'Ainda não há arquivos neste projeto',+ nothingFound: 'Nada encontrado',+ },+ viewer: {+ noPreview: 'Sem pré-visualização para este tipo de arquivo',+ },+ errors: {+ tooLarge: 'O arquivo é muito grande',+ forbidden: 'Sem permissão para enviar',+ notFound: 'Tarefa não encontrada',+ uploadFailed: 'Falha no envio',+ renameFailed: 'Não foi possível renomear o arquivo',+ unlinkFailed: 'Não foi possível remover o arquivo da tarefa',+ deleteFailed: 'Não foi possível excluir o arquivo',+ linkFailed: 'Não foi possível anexar o arquivo',+ },+ },}diff --git a/web/src/locales/ru.ts b/web/src/locales/ru.tsindex e39128b..0d0f24b 100644--- a/web/src/locales/ru.ts+++ b/web/src/locales/ru.ts@@ -114,6 +114,7 @@ export default {kanban: 'Канбан',graph: 'Граф',sprints: 'Спринты',+ files: 'Файлы',collaboration: 'Совместная работа',integrations: 'Интеграции',webhooks: 'Вебхуки',@@ -823,6 +824,7 @@ export default {taskFields: {subtasks: 'Подзадачи',note: 'Описание',+ files: 'Файлы',status: 'Статус',priority: 'Приоритет',assignees: 'Исполнители',@@ -1377,4 +1379,71 @@ export default {closeFailed: 'Не удалось закрыть спринт',},},+ files: {+ title: 'Файлы',+ attach: 'Прикрепить',+ upload: 'Загрузить',+ chooseFromProject: 'Выбрать из проекта',+ dropHint: 'Отпустите, чтобы прикрепить',+ emptyHint: 'Файлов пока нет. Прикрепите, перетащите сюда или вставьте из буфера.',+ empty: 'Файлов нет',+ searchPlaceholder: 'Поиск по имени',+ loadMore: 'Показать ещё',+ retry: 'Повторить',+ cancel: 'Отмена',+ close: 'Закрыть',+ previous: 'Назад',+ next: 'Вперёд',+ noPermission: 'У вас нет прав на просмотр файлов этого проекта',+ filters: {+ all: 'Все',+ images: 'Картинки',+ documents: 'Документы',+ },+ menu: {+ more: 'Ещё',+ download: 'Скачать',+ openInNewTab: 'Открыть в новой вкладке',+ rename: 'Переименовать',+ unlink: 'Убрать из задачи',+ delete: 'Удалить файл',+ },+ rename: {+ title: 'Переименовать файл',+ label: 'Имя',+ submit: 'Переименовать',+ },+ delete: {+ title: 'Удалить файл',+ confirm: 'Удалить «{name}» навсегда?',+ linkedElsewhere: 'Файл привязан ещё к {count} задаче | Файл привязан ещё к {count} задачам | Файл привязан ещё к {count} задачам',+ submit: 'Удалить',+ },+ picker: {+ title: 'Выбрать файлы из проекта',+ empty: 'Нечего выбирать',+ submit: 'Прикрепить {count} файл | Прикрепить {count} файла | Прикрепить {count} файлов',+ },+ linkToTask: {+ title: 'Привязать к задаче',+ },+ project: {+ unlinked: 'Не привязан',+ empty: 'В проекте пока нет файлов',+ nothingFound: 'Ничего не найдено',+ },+ viewer: {+ noPreview: 'Для этого типа файла нет предпросмотра',+ },+ errors: {+ tooLarge: 'Файл слишком большой',+ forbidden: 'Нет прав на загрузку',+ notFound: 'Задача не найдена',+ uploadFailed: 'Не удалось загрузить',+ renameFailed: 'Не удалось переименовать файл',+ unlinkFailed: 'Не удалось убрать файл из задачи',+ deleteFailed: 'Не удалось удалить файл',+ linkFailed: 'Не удалось прикрепить файл',+ },+ },}diff --git a/web/src/types/files.types.ts b/web/src/types/files.types.tsnew file mode 100644index 0000000..f615e05--- /dev/null+++ b/web/src/types/files.types.ts@@ -0,0 +1,57 @@+import type { TvFile, TvFileKindFilter } from 'taskview-api'++export type FileKind = 'image' | 'pdf' | 'video' | 'audio' | 'text' | 'other'++export type FileUploadStatus = 'uploading' | 'error'++export type FileUploadItem = {+ id: string+ goalId: number+ taskId: number | null+ file: File+ name: string+ sizeBytes: number+ progress: number+ status: FileUploadStatus+ errorKey: string | null+ controller: AbortController+}++export type FilesProjectListState = {+ goalId: number | null+ items: TvFile[]+ nextCursor: string | null+ search: string+ type: TvFileKindFilter+ loading: boolean+}++export type FilesStoreState = {+ byTask: Record<number, TvFile[]>+ loadingTasks: Record<number, boolean>+ project: FilesProjectListState+ uploads: FileUploadItem[]+}++export type FilesUploadArgs = {+ goalId: number+ taskId: number | null+ files: File[]+}++export type FilesFetchForGoalArgs = {+ goalId: number+ search?: string+ type?: TvFileKindFilter+ append?: boolean+}++export type FilesRemoteChangeArgs = {+ goalId: number+ taskIds: number[]+}++export type FilesOpenArgs = {+ file: TvFile+ inline: boolean+}diff --git a/web/src/uiCustomization/sections/tasks.types.ts b/web/src/uiCustomization/sections/tasks.types.tsindex ab4c6a0..34e6748 100644--- a/web/src/uiCustomization/sections/tasks.types.ts+++ b/web/src/uiCustomization/sections/tasks.types.ts@@ -8,6 +8,7 @@ export type TaskDetailField = {export const TASK_DETAIL_FIELDS = [{ id: 'subtasks', width: 'wide' },{ id: 'note', width: 'wide' },+ { id: 'files', width: 'wide' },{ id: 'status', width: 'narrow' },{ id: 'priority', width: 'narrow' },{ id: 'assignees', width: 'narrow' },