create-carlonicora-app 1.0.0

package/template/apps/api/src/neo4j.migrations/20250901_002.ts

@@ -0,0 +1,90 @@
+/**
+ * This migration creates the initial set of modules in the database.
+ */
+
+import { Action, MigrationInterface } from "@carlonicora/nestjs-neo4jsonapi";
+import { moduleQuery } from "src/neo4j.migrations/queries/migration.queries";
+
+export const migration: MigrationInterface[] = [
+  {
+    query: moduleQuery,
+    queryParams: {
+      moduleName: "Auth",
+      moduleId: "035fe8a6-d467-40c0-9d1d-6a87f0dd286e",
+      featureId: null,
+      isCore: true,
+      permissions: JSON.stringify([
+        { type: Action.Create, value: true },
+        { type: Action.Read, value: true },
+        { type: Action.Update, value: true },
+        { type: Action.Delete, value: true },
+      ]),
+    },
+  },
+  {
+    query: moduleQuery,
+    queryParams: {
+      moduleName: "Company",
+      moduleId: "f9e77c8f-bfd1-4fd4-80b0-e1d891ab7113",
+      featureId: null,
+      isCore: true,
+      permissions: JSON.stringify([{ type: Action.Read, value: true }]),
+    },
+  },
+  {
+    query: moduleQuery,
+    queryParams: {
+      moduleName: "Feature",
+      moduleId: "025fdd23-2803-4360-9fd9-eaa3612c2e23",
+      featureId: null,
+      isCore: true,
+      permissions: JSON.stringify([{ type: Action.Read, value: true }]),
+    },
+  },
+  {
+    query: moduleQuery,
+    queryParams: {
+      moduleName: "Notification",
+      moduleId: "9259d704-c670-4e77-a3a1-a728ffc5be3d",
+      featureId: null,
+      isCore: true,
+      permissions: JSON.stringify([
+        { type: Action.Read, value: true },
+        { type: Action.Update, value: true },
+      ]),
+    },
+  },
+  {
+    query: moduleQuery,
+    queryParams: {
+      moduleName: "Role",
+      moduleId: "9f6416e6-7b9b-4e1a-a99f-833191eca8a9",
+      featureId: null,
+      isCore: true,
+      permissions: JSON.stringify([{ type: Action.Read, value: true }]),
+    },
+  },
+  {
+    query: moduleQuery,
+    queryParams: {
+      moduleName: "S3",
+      moduleId: "db41ba46-e171-4324-8845-99353eba8568",
+      featureId: null,
+      isCore: true,
+      permissions: JSON.stringify([{ type: Action.Read, value: true }]),
+    },
+  },
+  {
+    query: moduleQuery,
+    queryParams: {
+      moduleName: "User",
+      moduleId: "04cfc677-0fd2-4f5e-adf4-2483a00c0277",
+      featureId: null,
+      isCore: true,
+      permissions: JSON.stringify([
+        { type: Action.Read, value: true },
+        { type: Action.Update, value: "id" },
+      ]),
+    },
+  },
+];

package/template/apps/api/src/neo4j.migrations/20250901_003.ts

@@ -0,0 +1,57 @@
+/**
+ * This migration creates the initial permissions for modules and features.
+ * A module can belong to a feature, and a role can have permissions on a module or a feature.
+ */
+
+import { Action, MigrationInterface } from "@carlonicora/nestjs-neo4jsonapi";
+import { permissionQuery } from "src/neo4j.migrations/queries/migration.queries";
+
+export const migration: MigrationInterface[] = [
+  ...[
+    "f9e77c8f-bfd1-4fd4-80b0-e1d891ab7113",
+    "db41ba46-e171-4324-8845-99353eba8568",
+    "04cfc677-0fd2-4f5e-adf4-2483a00c0277",
+  ].map((moduleId) => ({
+    query: permissionQuery,
+    queryParams: {
+      roleId: "53394cb8-1e87-11ef-8b48-bed54b8f8aba",
+      moduleId,
+      permissions: JSON.stringify([
+        { type: Action.Create, value: true },
+        { type: Action.Read, value: true },
+        { type: Action.Update, value: true },
+        { type: Action.Delete, value: true },
+      ]),
+    },
+  })),
+  ...[
+    "f9e77c8f-bfd1-4fd4-80b0-e1d891ab7113",
+    "db41ba46-e171-4324-8845-99353eba8568",
+    "04cfc677-0fd2-4f5e-adf4-2483a00c0277",
+  ].map((moduleId) => ({
+    query: permissionQuery,
+    queryParams: {
+      roleId: "2e1eee00-6cba-4506-9059-ccd24e4ea5b0",
+      moduleId: moduleId,
+      permissions: JSON.stringify([
+        { type: Action.Create, value: true },
+        { type: Action.Read, value: true },
+        { type: Action.Update, value: true },
+        { type: Action.Delete, value: true },
+      ]),
+    },
+  })),
+  ...["78567a47-baa8-47ed-890f-de48574a9cba", "e029e271-2896-43ad-87ef-19ab35363936"].map((moduleId) => ({
+    query: permissionQuery,
+    queryParams: {
+      roleId: "2e1eee00-6cba-4506-9059-ccd24e4ea5b0",
+      moduleId,
+      permissions: JSON.stringify([
+        { type: Action.Create, value: true },
+        { type: Action.Read, value: true },
+        { type: Action.Update, value: true },
+        { type: Action.Delete, value: true },
+      ]),
+    },
+  })),
+];

package/template/apps/api/src/neo4j.migrations/20250901_004.ts

@@ -0,0 +1,32 @@
+/**
+ * This migration creates the initial administrator user in the database.
+ */
+
+import { MigrationInterface } from "@carlonicora/nestjs-neo4jsonapi";
+
+export const migration: MigrationInterface[] = [
+  {
+    query: `
+          MERGE (u:User {id: $id})
+          ON CREATE SET u.name = $name,
+            u.email = $email,
+            u.password = $password,
+            u.isActive = $isActive,
+            u.isDeleted = $isDeleted,
+            u.createdAt = datetime(),
+            u.updatedAt = datetime()
+          WITH u
+          MATCH (r:Role {id: $adminRoleId})
+          MERGE (u)-[:MEMBER_OF]->(r)
+        `,
+    queryParams: {
+      id: "a63553fb-5d3c-11ee-9dc3-0242ac120003",
+      name: "Administrator",
+      email: "admin@{{name}}.com",
+      password: "$2a$10$ZDt9V644BLOC.HTBDrzFlOcg5WWaHIFcDaoPhSVaiEA9xGyp0NtOq",
+      isActive: true,
+      isDeleted: false,
+      adminRoleId: "53394cb8-1e87-11ef-8b48-bed54b8f8aba",
+    },
+  },
+];

package/template/apps/api/src/neo4j.migrations/queries/migration.queries.ts

@@ -0,0 +1,49 @@
+export const featureQuery = `
+  MERGE (feature:Feature {id: $featureId})
+  ON CREATE SET 
+    feature.name=$featureName, 
+    feature.isProduction=$isProduction, 
+    feature.createdAt = datetime(), 
+    feature.updatedAt = datetime()
+  ON MATCH SET 
+    feature.name=$featureName, 
+    feature.isProduction=$isProduction, 
+    feature.updatedAt = datetime()
+  RETURN feature
+`;
+
+export const moduleQuery = `
+    MERGE (module:Module {id: $moduleId})
+    ON CREATE SET 
+        module.name=$moduleName, 
+        module.permissions = $permissions,
+        module.isCore = $isCore,
+        module.createdAt = datetime(), 
+        module.updatedAt = datetime()
+    ON MATCH SET 
+        module.name = $moduleName,
+        module.isCore = $isCore,
+        module.updatedAt = CASE WHEN module.permissions <> $permissions THEN datetime() ELSE module.updatedAt END,
+        module.permissions = CASE WHEN module.permissions <> $permissions THEN $permissions ELSE module.permissions END
+    WITH module
+
+    MATCH (feature:Feature) WHERE $featureId IS NOT NULL AND feature.id = $featureId
+    WITH module, feature
+    WHERE feature IS NOT NULL
+    MERGE (module)-[:IN_FEATURE]->(feature)
+`;
+
+export const roleQuery = `
+  MERGE (role:Role {id: $roleId})
+  ON CREATE SET role.name=$roleName, role.isSelectable=$isSelectable, role.createdAt = datetime(), role.updatedAt = datetime()
+  ON MATCH SET role.name=$roleName, role.isSelectable=$isSelectable, role.createdAt = datetime(), role.updatedAt = datetime()
+  RETURN role
+`;
+
+export const permissionQuery = `
+  MATCH (role:Role {id: $roleId})
+  MATCH (module:Module {id: $moduleId})
+  MERGE (role)-[permissions:HAS_PERMISSIONS]->(module)
+  ON CREATE SET permissions.permissions = $permissions
+  ON MATCH SET permissions.permissions = $permissions
+`;

package/template/apps/api/src/types/langchain.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Ambient type declarations for LangChain v1.0 modules
+ *
+ * These declarations help TypeScript resolve LangChain modules when using
+ * classic "node" module resolution (required for NestJS CommonJS compatibility).
+ *
+ * LangChain v1.0 uses modern package.json exports which aren't fully supported
+ * by the legacy "node" resolution strategy, but work fine at runtime.
+ */
+
+// Core modules
+declare module "@langchain/core/documents" {
+  export * from "@langchain/core/dist/documents";
+}
+
+declare module "@langchain/core/prompts" {
+  export * from "@langchain/core/dist/prompts/index";
+}
+
+declare module "@langchain/core/embeddings" {
+  export * from "@langchain/core/dist/embeddings";
+}
+
+declare module "@langchain/core/language_models/chat_models" {
+  export * from "@langchain/core/dist/language_models/chat_models";
+}
+
+declare module "@langchain/core/output_parsers" {
+  export * from "@langchain/core/dist/output_parsers/index";
+}
+
+declare module "@langchain/core/messages" {
+  export * from "@langchain/core/dist/messages/index";
+}
+
+declare module "@langchain/core/document_loaders/base" {
+  export * from "@langchain/core/dist/document_loaders/base";
+}
+
+// Community modules
+declare module "@langchain/community/document_loaders/web/recursive_url" {
+  export * from "@langchain/community/dist/document_loaders/web/recursive_url";
+}
+
+declare module "@langchain/community/document_loaders/fs/csv" {
+  export * from "@langchain/community/dist/document_loaders/fs/csv";
+}
+
+declare module "@langchain/community/document_loaders/fs/docx" {
+  export * from "@langchain/community/dist/document_loaders/fs/docx";
+}
+
+// Text splitters
+declare module "@langchain/textsplitters" {
+  export * from "@langchain/textsplitters/dist/index";
+}

package/template/apps/api/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
+}

package/template/apps/api/tsconfig.json

@@ -0,0 +1,38 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "target": "ES2021",
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "importHelpers": true,
+    // Override strict settings for API (keeping existing behavior)
+    "strict": false,
+    "strictNullChecks": false,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "strictFunctionTypes": false,
+    "strictPropertyInitialization": false,
+    "noImplicitThis": false,
+    "alwaysStrict": false,
+    "forceConsistentCasingInFileNames": false,
+    "noFallthroughCasesInSwitch": false,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noImplicitReturns": false,
+    "paths": {
+      "src/*": ["src/*"],
+      "@langchain/core/*": ["node_modules/@langchain/core/dist/*"],
+      "@langchain/community/*": ["node_modules/@langchain/community/dist/*"],
+      "@langchain/textsplitters": ["node_modules/@langchain/textsplitters/dist/index"]
+    }
+  },
+  "ts-node": {
+    "transpileOnly": false,
+    "compilerOptions": {
+      "module": "commonjs"
+    }
+  },
+  "include": ["src/**/*", "test/**/*", "templates"],
+  "exclude": ["dist", "node_modules"]
+}

package/template/apps/web/.swcrc

@@ -0,0 +1,26 @@
+{
+	"jsc": {
+		"target": "es2022",
+		"parser": {
+			"syntax": "typescript", // or "ecmascript" for JavaScript
+			"tsx": true, // true if using JSX/TSX
+			"dynamicImport": true,
+			"decorators": true
+		},
+		"transform": {
+			"react": {
+				"runtime": "automatic", // for the new JSX transform
+				"pragma": "React.createElement",
+				"pragmaFrag": "React.Fragment",
+				"throwIfNamespace": true,
+				"development": false,
+				"useBuiltins": true
+			}
+		},
+		"keepClassNames": true
+	},
+	"module": {
+		"type": "commonjs" // or "es6" for ES modules
+	},
+	"sourceMaps": true // if you want source maps generated
+}

package/template/apps/web/components.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "iconLibrary": "lucide"
+}

package/template/apps/web/eslint.config.mjs

@@ -0,0 +1,33 @@
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = [
+  ...nextVitals,
+  ...nextTs,
+  {
+    rules: {
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-require-imports": "off",
+      "@typescript-eslint/no-unused-vars": "off",
+      "@typescript-eslint/no-unused-expressions": "warn",
+      "@typescript-eslint/no-empty-object-type": "off",
+      "@next/next/no-assign-module-variable": "warn",
+      "react-hooks/exhaustive-deps": "off",
+      "react-hooks/rules-of-hooks": "off",
+      // Disable React Compiler rules (not needed unless using React Compiler)
+      "react-hooks/set-state-in-effect": "off",
+      "react-hooks/preserve-manual-memoization": "off",
+      "react-hooks/purity": "off",
+      "react-hooks/refs": "off",
+      "react-hooks/incompatible-library": "off",
+      "react-hooks/static-components": "off",
+      "react-hooks/immutability": "off",
+      "react-hooks/use-memo": "off",
+    },
+  },
+  {
+    ignores: [".next/**", "out/**", "build/**", "next-env.d.ts", "node_modules/**"],
+  },
+];
+
+export default eslintConfig;

package/template/apps/web/global.d.ts

@@ -0,0 +1,7 @@
+import it from "./messages/it.json";
+
+type Messages = typeof it;
+
+declare global {
+  interface IntlMessages extends Messages {}
+}

package/template/apps/web/messages/en.json

@@ -0,0 +1,249 @@
+{
+  "foundations": {
+    "auth": {
+      "accept_invitation": "Accept Invitation",
+      "account_activated": "Account Activated",
+      "account_activated_description": "Your account is ready. Log in to access Phlow",
+      "activation_description": "Your account has been successfully activated. You will be redirected to the login page shortly.",
+      "activation_wait": "Please wait while your account is being activated...",
+      "add_email_to_reset": "Please add your email to reset your password.",
+      "buttons": {
+        "forgot_password": "Forgot Password?",
+        "login": "Login",
+        "logout": "Logout",
+        "register": "Register",
+        "reset_password": "Reset Password"
+      },
+      "errors": {
+        "activating_account": "An error occurred while activating your account.",
+        "invalid_invitation_code": "Invalid invitation code",
+        "invalid_password_reset_code": "Invalid password reset code",
+        "password_invalid_format": "Password must contain at least one number and one special character (non-alphanumeric)",
+        "password_reset_error": "An error occurred while resetting the password.",
+        "password_retype_required": "Password retype is required",
+        "password_too_short": "Password must be at least 8 characters long"
+      },
+      "fields": {
+        "retype_password": {
+          "error": "Password retype is required",
+          "error_not_match": "Passwords do not match",
+          "label": "Repeat Password",
+          "placeholder": "Repeat Password"
+        }
+      },
+      "forgot_password": "Forgot Password?",
+      "login": "Login",
+      "login_description": "Login to Phlow",
+      "password_reset": "Reset Password",
+      "register": "Register",
+      "register_confirmation": "Thank you for registering. Please check your email for the confirmation link.",
+      "register_description": "Registering for Phlow creates a company. If you want to join an existing company, please contact the company administrators.",
+      "reset_confirmation": "If your email is registered in our system, you will receive an email with instructions to reset your password.",
+      "reset_password": "You can reset your account password from this page.",
+      "reset_success": "Password Reset Successful",
+      "reset_success_description": "Your password has been successfully reset. You will be redirected to the login page shortly.",
+      "select_password": "Please add your preferred password to access Phlow."
+    },
+    "company": {
+      "click_drag_logo": "Click or drag a logo to upload it",
+      "features_and_modules": "Features and Modules",
+      "fields": {
+        "name": {
+          "error": "The company name is required",
+          "label": "Company Name",
+          "placeholder": "Enter Company Name"
+        }
+      }
+    },
+    "content": {
+      "news": "Recent Relevant Contents",
+      "latest": "Latest Contents",
+      "fields": {
+        "name": {
+          "label": "Name"
+        }
+      }
+    },
+    "notification": {
+      "archived": "Archived",
+      "buttons": {
+        "archive": "Archive Notification"
+      },
+      "empty": "No notifications available",
+      "inbox": "Inbox"
+    },
+    "role": {
+      "fields": {
+        "description": {
+          "label": "Description"
+        },
+        "name": {
+          "label": "Role Name"
+        }
+      },
+      "remove_user": {
+        "description_allowed": "Are you sure you want to remove the {role} role from {user}?",
+        "description_not_allowed": "You cannot remove the {role} role from {user} because they are the only user in that role and it requires at least one user!",
+        "subtitle_allowed": "Remove a role from a user",
+        "subtitle_not_allowed": "Cannot remove user from role",
+        "title": "Remove Role from User"
+      },
+      "roles": "{role, select, 2e1eee006cba45069059ccd24e4ea5b0 {System Administrator} other {N/A}}",
+      "roles_descriptions": "{role, select, 2e1eee006cba45069059ccd24e4ea5b0 {Has FULL ACCESS to the data and features of the company.} other {N/A}}"
+    },
+    "user": {
+      "buttons": {
+        "reactivate": "Reactivate User",
+        "resend_activation": "Resend Activation Email"
+      },
+      "deleted": "Deleted User",
+      "errors": {
+        "deleted": "Deleted User",
+        "email_exists": "Another user with this email already exists",
+        "inactive": "Inactive User"
+      },
+      "fields": {
+        "bio": {
+          "label": "Bio",
+          "placeholder": "Enter user's Bio"
+        },
+        "name": {
+          "error": "The name is required",
+          "label": "Name",
+          "placeholder": "Enter Name"
+        },
+        "password": {
+          "error": "The password is required",
+          "label": "Password",
+          "placeholder": "Enter Password"
+        },
+        "phone": {
+          "label": "Phone Number",
+          "placeholder": "Enter user's Phone Number"
+        },
+        "title": {
+          "label": "Title",
+          "placeholder": "Enter user's Title"
+        }
+      },
+      "reactivate": {
+        "description": "Are you sure you want to reactivate {name}'s account? The user will be able to log in to Phlow again and interact with the law firm's knowledge.",
+        "subtitle": "Are you sure you want to reactivate this user?",
+        "title": "Reactivate User"
+      },
+      "resend_activation": {
+        "description": "Are you sure you want to resend the activation email to {email}?",
+        "email_sent": "Email Sent",
+        "email_sent_description": "The activation email has been sent to {email}",
+        "subtitle": "Are you sure you want to resend the activation email to this user?",
+        "title": "Resend Activation Email"
+      },
+      "send_activation_email": "Send Activation Email"
+    }
+  },
+  "generic": {
+    "avatar": "Avatar",
+    "blocknote": {
+      "placeholder": "Type text or enter '/' for commands"
+    },
+    "buttons": {
+      "cancel": "Cancel",
+      "confirm_create": "Create",
+      "confirm_delete": "Confirm Deletion",
+      "confirm_update": "Update",
+      "create": "Create New",
+      "delete": "Delete",
+      "is_deleting": "Deleting...",
+      "remove": "Remove",
+      "select_date": "Select Date",
+      "show_less": "Show less",
+      "show_more": "Show more"
+    },
+    "create": "New",
+    "create_new": "Create New",
+    "dashboard": "Phlow - {companyName}",
+    "date": {
+      "create": "Creation",
+      "update": "Last Updated"
+    },
+    "delete": {
+      "confirmation": "Please type the name of the {type} to confirm deletion",
+      "description": "Deleting this {type} will result in the loss of all associated data. This action cannot be undone.",
+      "subtitle": "Are you sure you want to delete this {type}?",
+      "title": "Delete {type}"
+    },
+    "description": "Phlow is an expertise and knowledge development platform.",
+    "edit": {
+      "create": {
+        "description": "Create a new {type}",
+        "title": "New {type}"
+      },
+      "update": {
+        "description": "Update the existing {type} {name}",
+        "title": "Update {type}"
+      }
+    },
+    "errors": {
+      "create": "Creation Error",
+      "delete": "Deletion Error",
+      "error": "Error",
+      "file": "File Error",
+      "file_large": "The file appears to be too large to upload. Please try a smaller file.",
+      "file_max": "The file is too large. The maximum size is {size}MB",
+      "file_no_select": "No file selected",
+      "invalid_email": "Invalid email address",
+      "missing_company_name": "The company name is required",
+      "missing_name": "Name is required",
+      "update": "Update Error",
+      "upload": "Upload Error",
+      "upload_description": "An error occurred while uploading the file. Please try again.",
+      "valid_url": "Please enter a valid URL"
+    },
+    "fields": {
+      "email": {
+        "error": "The email address is required",
+        "label": "Email",
+        "placeholder": "Add email address"
+      }
+    },
+    "hide_password": "Hide Password",
+    "home": "Home Page",
+    "levels": "{level, select, 1 {Not aware} 2 {Aware} 3 {Skilled} 4 {Expert} 5 {Strategist} other {N/A}}",
+    "loading": "Loading...",
+    "my_profile": "My Profile",
+    "permissions": "Users",
+    "pick_date_time": "Pick date & time",
+    "query_knowledge": "Query Knowledge",
+    "recent_pages": "Recent Pages",
+    "relationships": {
+      "author": {
+        "error": "Author is required",
+        "label": "Author",
+        "placeholder": "Select Author"
+      }
+    },
+    "relevance": "Relevance",
+    "relevant": "Relevant Contents",
+    "relevant_users": "Relevant Users",
+    "remove_item": "Remove item",
+    "search": {
+      "button": "Search...",
+      "no_results": "No {type} found",
+      "placeholder": "Search {type}...",
+      "placeholder_global": "Search...",
+      "recent_searches": "Recent Searches"
+    },
+    "settings": "Settings",
+    "settings_sidebar": "{item, select, company {Law Firm} crm {Customer Relationship Management} tariff {Legal Tariff} quote {Quotes} other {N/A}}",
+    "show_password": "Show Password",
+    "sidebar": "{type, select, expertise {Expertise} knowledge {Knowledge} other {N/A}}",
+    "theme": "Change Theme",
+    "title": "Phlow"
+  },
+  "types": {
+    "companies": "{count, plural, =1 {Company} other {Companies}}",
+    "notifications": "{count, plural, =1 {Notification} other {Notifications}}",
+    "roles": "{count, plural, =1 {System Role} other {System Roles}}",
+    "users": "{count, plural, =1 {User} other {Users}}"
+  }
+}