111 lines
6.9 KiB
JavaScript
111 lines
6.9 KiB
JavaScript
export const createSectionWorkflow = {
|
|
id: "create_section",
|
|
name: "Create New Section",
|
|
description: "Full workflow for creating a new website section: table + fields + module + template + content.",
|
|
steps: [
|
|
{
|
|
step: 1,
|
|
action: "Understand requirements",
|
|
description: "Clarify with user: section name, type (multi/single/category), fields needed, whether it needs URL (enlace), SEO meta tags.",
|
|
tool: null,
|
|
critical: "Ask before acting. Multi = multiple records (blog, products). Single = one record (about page). Category = grouping for other sections."
|
|
},
|
|
{
|
|
step: 2,
|
|
action: "Check existing tables",
|
|
description: "List current tables to avoid naming conflicts and understand existing structure.",
|
|
tool: "list_tables",
|
|
critical: "Table names must be unique. Check if a similar section already exists."
|
|
},
|
|
{
|
|
step: 3,
|
|
action: "Create the table",
|
|
description: "Create the database table with correct type and configuration.",
|
|
tool: "create_table",
|
|
critical: "type must be: 'multi' (multiple records), 'single' (one record), 'category' (grouping), or 'separador' (menu separator). Set enlace=true if records need their own URL page."
|
|
},
|
|
{
|
|
step: 4,
|
|
action: "Add fields to the table",
|
|
description: "Create all necessary fields with correct types and configuration.",
|
|
tool: "edit_table_field",
|
|
critical: "Can batch multiple fields in one call. Field types: textfield, textbox, wysiwyg, date, checkbox, list, upload, multitext, codigo, separator."
|
|
},
|
|
{
|
|
step: 5,
|
|
action: "Verify table schema",
|
|
description: "Get the complete schema to confirm all fields were created correctly.",
|
|
tool: "get_table_schema",
|
|
critical: "Verify all fields exist with correct types before proceeding to module creation."
|
|
},
|
|
{
|
|
step: 6,
|
|
action: "Design and create the listing module",
|
|
description: "Create an HTML module that displays a list/grid of records from this section.",
|
|
tool: "save_module",
|
|
critical: "Use Twig syntax. Access records with the 'get' filter. Primary key is 'num' not 'id'. Upload fields are ALWAYS arrays: use record.field[0].urlPath | imagec(width)."
|
|
},
|
|
{
|
|
step: 7,
|
|
action: "Set module example data",
|
|
description: "Set example/static data for module preview. MUST call get_module first to discover ALL variables.",
|
|
tool: "set_module_example_data",
|
|
critical: "Every builder variable must have example data. Missing variables cause blank previews."
|
|
},
|
|
{
|
|
step: 8,
|
|
action: "Add sample content",
|
|
description: "Create 2-3 sample records with realistic content and images. If table has enlace=true, include the 'enlace' field with a URL slug.",
|
|
tool: "create_or_update_record",
|
|
critical: "Date format: YYYY-MM-DD HH:mm:ss. Checkbox: 1 or 0. Upload fields: use upload_record_image separately. For sections with enlace, creating records first ensures directory structure is ready."
|
|
},
|
|
{
|
|
step: 9,
|
|
action: "Create detail template (if enlace=true)",
|
|
description: "If the section has enlace enabled, create the detail page template that shows when navigating to a record's URL.",
|
|
tool: "save_general_section",
|
|
critical: "Use 'thisrecord' variable to access the current record. Same Twig rules apply. Note: save_general_section will auto-initialize the directory if needed."
|
|
},
|
|
{
|
|
step: 10,
|
|
action: "Verify the result",
|
|
description: "Check module rendering with actual variable values.",
|
|
tool: "check_module",
|
|
critical: "Test with actual variable values to ensure no rendering errors."
|
|
}
|
|
],
|
|
context: {
|
|
twig_filters: "Use 'get' filter for DB queries: {% set items = 'tablename' | get('WHERE active=1', 'ORDER BY num DESC', 10) %}. Use 'imagec' for image resize: {{ path | imagec(400) }}. Use 'module' to include other modules: {{ 'modulename' | module(vars) }}.",
|
|
field_types: "textfield (single line), textbox (multiline), wysiwyg (rich HTML), date (YYYY-MM-DD), checkbox (0/1), list (dropdown/radio/checkbox), upload (files/images), multitext (key-value pairs), codigo (code editor), separator (visual divider).",
|
|
list_field_config: "Static options: optionsType='text', optionsText='value1|Label 1\\nvalue2|Label 2'. Table relation: optionsType='table', optionsTablename='tablename', optionsValueField='num', optionsLabelField='name'. SQL: optionsType='query', optionsText='SELECT num,name FROM cms_tablename'.",
|
|
builder_vars: "data-field-type attribute on HTML elements creates editable fields. Types: textfield, headfield, textbox, wysiwyg, link, upload, uploadBackground, uploadMulti, list, multiv2. Variable names derived from labels (lowercase, no spaces/accents).",
|
|
upload_rules: "Upload fields ALWAYS return arrays. Single image: {{ record.imagen[0].urlPath | imagec(WIDTH) }}. Gallery loop: {% for img in record.galeria %}{{ img.urlPath }}{% endfor %}. Check existence: {% if record.imagen and record.imagen|length > 0 %}."
|
|
},
|
|
rules: [
|
|
"Table names WITHOUT 'cms_' prefix in all tool calls",
|
|
"Primary key is ALWAYS 'num', never 'id'",
|
|
"Upload fields are ALWAYS arrays of objects with urlPath property",
|
|
"Use ONLY Twig FILTERS (pipe syntax), not Twig functions",
|
|
"Date format: YYYY-MM-DD HH:mm:ss",
|
|
"Checkbox values: 1 or 0 (number, not boolean)",
|
|
"Enlace (URL slug): auto-formatted to /path/ with slashes",
|
|
"Variable names in modules: lowercase, no spaces, no accents, no special chars",
|
|
"c-if='varname' for conditional rendering, c-hidden='true' for invisible config vars",
|
|
"When using 'get' filter: SQL string syntax, NOT objects. Example: 'WHERE num > 5'"
|
|
],
|
|
warnings: [
|
|
"DO NOT use record.imagen.urlPath — it's record.imagen[0].urlPath (array!)",
|
|
"DO NOT use 'id' as primary key — Acai uses 'num'",
|
|
"DO NOT forget to set example data after creating a module — it will look blank",
|
|
"DO NOT create a detail template if enlace is false — there's no URL to navigate to",
|
|
"DO NOT use Twig functions like range() — only filters (pipe syntax) are available",
|
|
"For best results with new enlace sections, create records BEFORE calling save_general_section to ensure directory structure exists"
|
|
],
|
|
resources: [
|
|
"acai://resources/guia-builder-vars",
|
|
"acai://resources/guia-twig-filters",
|
|
"acai://resources/guia-atributos-acai",
|
|
"acai://resources/guia-registros"
|
|
]
|
|
};
|