mcpField
S
smartx-development

smartx-development

github.com/thalysjuvenalDevelopment19148 installsUpdated 6w ago
Repository

About smartx-development

A development skill for building TOTVS Smart X routines, from data models and interfaces to menu launchers. It covers new implementations, ADVPL integration, legacy MVC browse migration, and troubleshooting.

Key features

  1. 01Object-to-Launcher architecture
  2. 02Model and Interface classes
  3. 03PO-UI screen rendering
  4. 04ADVPL action integration
  5. 05Legacy MVC browse migration

Use cases

  1. 01Building a Smart X routine
  2. 02Connecting ADVPL functions to page or table actions
  3. 03Migrating an MVC browse to Smart X

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/thalysjuvenal/advpl-specialist --skill smartx-development

After installing, type/smartx-developmentin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

patterns-advpl-integration.md
patterns-interface.md
patterns-launcher-browse.md
patterns-migration.md
patterns-model.md
reference.md
troubleshooting.md

Details

From the project README

Smart X

This skill covers developing TOTVS Smart X routines: the Object -> Model -> Interface -> Launcher chain that turns a data dictionary table (SX2/SX3) into an automatically-rendered PO-UI screen without hand-written Angular components. It documents the required includes and annotations for the Model (totvs.framework.structure.model.th) and Interface (totvs.framework.structure.Interface.th) TLPP classes, the Launcher function that registers the routine in the Protheus menu, integrating existing ADVPL functions into the interface via pageActions/tableActions/events, and converting only the browse (Data View) of a legacy MVC routine to Smart X while keeping ModelDef/ViewDef/MenuDef intact.

Activate this skill when the user is creating a new Smart X routine from scratch, wiring an ADVPL function call into a Smart X page/table action, converting a legacy MVC browse to a Smart X browse, or debugging a Smart X screen/model/interface issue. It does not cover classic MVC routine development without Smart X (see advpl-code-generation, file patterns-mvc.md), nor data dictionary configuration scripts for SX2/SX3 themselves (see sx-configuration). It is also unrelated to Smart View, the TReports analytics tool whose custom business objects are covered by smartview-development -- the names are similar, the frameworks are not.

The referenced files are written in Brazilian Portuguese.

Reference fileRead when
reference.mdAlways -- Smart X concept, Object/Model/Interface/Launcher architecture, includes/annotations, minimal end-to-end example
patterns-model.mdWriting or reviewing the Model (model.tlpp) class and its data/business-rule definitions
patterns-interface.mdWriting or reviewing the Interface (interface.tlpp) class and its UI contract (browse/forms)
patterns-launcher-browse.mdConverting only the browse (Data View) of an existing MVC routine to Smart X rendering
patterns-advpl-integration.mdCalling existing ADVPL functions from Smart X via pageActions, tableActions, or events like onChange
patterns-migration.mdMigrating a full legacy routine to a 100% Smart X implementation
troubleshooting.mdDiagnosing errors or unexpected behavior in a Smart X screen, Model, or Interface

Comments

Markdown supported