feat(core): Add migration to create model for folders feature

[RicardoE105]

Summary

Title self explanatory

Model

Constrains

1. Folders can exist in only one project.
2. Workflows can or cannot be in folder.
3. Workflows can only be in one folder at the same time - Worklows can be in differnt
4. Folders can have multiple tags.

ERD

Example 1: Fetching Workflows with Folder they belong to

Query

await this.workflowRepository.find({
  relations: ['folder'],
});

Response

[
  {
    "createdAt": "2025-02-03T21:38:13.346Z",
    "updatedAt": "2025-02-04T23:51:14.000Z",
    "id": "ihqEINxufYLiBEUp",
    "name": "1",
    "active": false,
    "nodes": [],
    "connections": {},
    "settings": {
      "executionOrder": "v1"
    },
    "staticData": null,
    "meta": null,
    "pinData": {},
    "versionId": "72854149-d785-40fd-8bc7-43dff1a6a441",
    "triggerCount": 0,
    "folder": null
  },
  {
    "createdAt": "2025-02-03T21:38:24.221Z",
    "updatedAt": "2025-02-03T22:07:46.000Z",
    "id": "OVscJ17q2HRd3Qqh",
    "name": "3",
    "active": false,
    "nodes": [],
    "connections": {},
    "settings": {
      "executionOrder": "v1"
    },
    "staticData": null,
    "meta": null,
    "pinData": {},
    "versionId": "561b4e5f-b23d-4fda-b18b-8b37926c95d4",
    "triggerCount": 0,
    "folder": {
      "createdAt": "2025-02-05T00:37:03.901Z",
      "updatedAt": "2025-02-05T00:37:03.901Z",
      "id": "TBuJWie3k7L0VnQ1\n",
      "name": "folder 1"
    }
  }
]

Example 2: Fetching Folders with Projects and Tags

Query

await this.folderRepository.find({
  relations: ['project', 'tags'],
  select: {
    project: {
      id: true,
      name: true,
      type: true,
      icon: {
        type: true,
        value: true,
      },
    },
    tags: {
      id: true,
      name: true,
    },
  },
});

Response

[
  {
    "createdAt": "2025-02-05T00:37:03.901Z",
    "updatedAt": "2025-02-05T00:37:03.901Z",
    "id": "TBuJWie3k7L0VnQ1\n",
    "name": "folder 1",
    "project": {
      "id": "0mhjfTCcn1vdQdaY",
      "name": "espinoza ricardo <[email protected]>",
      "type": "personal",
      "icon": null
    },
    "tags": [
      {
        "id": "3nywilz6eSljcy48",
        "name": "Name"
      }
    ]
  }
]

Related Linear tickets, Github issues, and Community forum posts

https://linear.app/n8n/issue/ADO-3164/[be]-create-migration-to-integrate-new-model

Review / Merge checklist

• PR title and summary are descriptive. (conventions)
• Docs updated or follow-up ticket created.
• Tests included.
• PR Labeled with release/backport (if the PR is an urgent fix that needs to be backported)

[codecov]

Codecov Report

Attention: Patch coverage is 69.56522% with 7 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...li/src/databases/repositories/folder.repository.ts	0.00%	6 Missing ⚠️
packages/cli/src/databases/entities/folder.ts	92.85%	0 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!