Guide Plutonium - Démarrage

VérifiéSûr

Guide de référence pour débuter avec les applications Plutonium, couvrant l'architecture des ressources, les générateurs clés et les bonnes pratiques de développement.

Spar Skills Guide Bot
DeveloppementIntermédiaire
3002/06/2026
Claude Code
#plutonium#rails#generators#scaffolding#reference

Recommandé pour

Notre avis

Guide de premier niveau pour démarrer sur une application Plutonium, listant les générateurs, l'architecture des ressources et les bonnes pratiques.

Points forts

  • Offre une vue d'ensemble claire de l'architecture en couches (modèle, définition, politique, contrôleur)
  • Fournit des générateurs prêts à l'emploi pour créer des ressources, packages et portails
  • Référence directe aux compétences spécialisées pour approfondir chaque concept

Limites

  • Ne détaille pas la configuration avancée des champs ou des actions
  • Suppose que l'utilisateur maîtrise déjà Ruby on Rails et les concepts de base de Plutonium
  • Ne couvre pas la résolution des erreurs ou les cas particuliers
Quand l'utiliser

Quand vous commencez à travailler sur une application Plutonium ou que vous avez besoin d'un rappel rapide sur les générateurs et l'architecture.

Quand l'éviter

Quand vous devez mettre en œuvre des fonctionnalités spécifiques comme des filtres complexes ou des autorisations détaillées – préférez alors la compétence dédiée.

Analyse de sécurité

Sûr
Score qualité85/100

This skill provides high-level development guidelines for Plutonium applications. It includes examples of 'rails generate' commands (scaffold, connect, package, portal) with safe options. No destructive, exfiltrating, or obfuscated actions are present.

Aucun point d'attention détecté

Exemples

Create a Post resource
I need to create a Post resource with a title field in the main_app. Use the plutonium generator and connect it to the admin portal.
Create a blogging package
Create a new Plutonium package called 'blogging' with a generator and then add a portal for it.
Understand resource architecture
Explain the layered architecture of a Plutonium resource (model, definition, policy, controller) and when to customize each layer.

name: plutonium description: High-level guide for working with Plutonium applications - read this first

Plutonium Development Guide

Read this first when working on a Plutonium application.

Core Rules

  1. Always use generators - Never manually create resources, packages, or portals
  2. Check relevant skills first - Each concept has a dedicated skill with details
  3. Definitions over controllers - UI customization belongs in definitions, not controllers
  4. Policies for authorization - All permission logic goes in policies

Key Generators

rails g pu:res:scaffold Post title:string --dest=main_app    # Create resource
rails g pu:res:conn Post --dest=admin_portal                 # Connect to portal
rails g pu:pkg:package blogging                              # Create feature package
rails g pu:pkg:portal admin_portal                           # Create portal

Always specify --dest to avoid interactive prompts.

Resource Architecture

A resource has four layers:

| Layer | Purpose | Customize when... | |-------|---------|-------------------| | Model | Data, validations, associations | Adding business logic | | Definition | UI - fields, actions, filters | Changing how things look/behave | | Policy | Authorization - who can do what | Restricting access | | Controller | Request handling | Rarely - use hooks if needed |

Skill Reference

| Topic | Skill | |-------|-------| | Creating resources | plutonium-create-resource | | Connecting to portals | plutonium-connect-resource | | Field configuration | plutonium-definition-fields | | Actions & interactions | plutonium-definition-actions | | Search, filters, scopes | plutonium-definition-query | | Authorization | plutonium-policy | | Custom views | plutonium-views | | Custom forms | plutonium-forms | | Nested resources | plutonium-nested-resources | | Packages & portals | plutonium-package, plutonium-portal | | Authentication | plutonium-rodauth |

Skills similaires