.. _auto_project_create:

*CREATES A NEW PROJECT*
=======================

Creates a new project (or updates an existing one) within the d3VIEW platform, registering its name, code, visual identity, folder path, access roles, and optional dashboard layout. Use this worker to programmatically provision or update project workspaces as part of an onboarding or workflow automation pipeline.

When to use
-----------

Tagged: ``onboarding``, ``platform``, ``project_create``, ``project_management``, ``workspace``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Project Name
     - project_name
     - text
     - —
     - ✓
     - Human-readable display name for the new project (e.g., 'Frontal Crash 2025'); must be unique within the parent context.
   * - Project Code
     - project_code
     - text
     - —
     - ✓
     - Short alphanumeric identifier / slug for the project used in URLs and API references (e.g., 'FC2025'); required and must be unique.
   * - Project Color
     - project_color
     - text
     - —
     - ✓
     - Hex color code (e.g., '#3A86FF') used as the project's visual accent in the platform UI; required.
   * - Project Folder
     - project_folder
     - textarea
     - —
     - 
     - Absolute or relative filesystem path to the root folder associated with this project; leave blank to use the platform default.
   * - Project Icon
     - project_icon
     - text
     - fa fa-folder
     - ✓
     - Font-Awesome icon class string for the project tile (e.g., 'fa fa-folder'); defaults to 'fa fa-folder' if left unchanged.
   * - Description
     - description
     - textarea
     - —
     - 
     - Free-text description of the project's purpose, scope, or contents; optional but recommended for discoverability.
   * - Tags
     - tags
     - textarea
     - —
     - 
     - Comma- or newline-separated labels used for filtering and search (e.g., 'crash, 2025, OEM-A'); optional.
   * - Thumbnail
     - thumbnail
     - file
     - —
     - 
     - Image file (PNG/JPG) displayed as the project tile thumbnail in the platform UI; optional.
   * - Parent Project
     - parent_id
     - remote_lookup
     - —
     - 
     - Remote lookup reference to an existing project that will become the parent of this new project, enabling hierarchical project nesting; leave blank for a top-level project.
   * - Users and Roles
     - users_roles
     - dataset
     - —
     - 
     - Dataset mapping platform users to their assigned roles within this project (columns: ID, User, Role); leave empty to inherit workspace defaults.
   * - Layout
     - layout
     - textarea
     - —
     - 
     - JSON dashboard layout definition authored in the dashboard editor; controls the initial KPI/widget arrangement visible to project members; optional.
   * - Existing Project
     - existing_project_id
     - remote_lookup
     - —
     - 
     - Remote lookup reference to an existing project; if provided, that project is updated with the supplied inputs instead of creating a new one.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Project ID
     - project_id
     - scalar
     - Platform-assigned integer or UUID uniquely identifying the newly created (or updated) project; use as a reference key in downstream workers.

Disciplines
-----------

- platform.dashboard
- platform.workflow

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>project_create</code>. Schema hash: <code>e31b38e9ec05</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>