README

Core contracts, service provider e primitivas para o framework Arqel — admin panels para Laravel declarados em PHP e renderizados em React.

Posição no ecossistema

Este pacote é a fundação de todos os pacotes arqel-dev/*. É onde vivem:

• O ArqelServiceProvider que faz auto-discovery na app Laravel consumidora
• Contracts (HasResource, HasFields, HasActions, HasPolicies, Renderable)
• Classe abstracta base Resource e ResourceRegistry
• Sistema de Panel e PanelRegistry
• Middleware Inertia (HandleArqelInertia)
• Comandos Artisan: arqel:install, arqel:resource, arqel:field, arqel:action
• Facade Arqel
• Suporte para serialização de schemas de Fields para Inertia props

Os pacotes específicos (arqel-dev/fields, arqel-dev/table, arqel-dev/form, ...) dependem de arqel-dev/core e estendem os contracts/classes base daqui.

Instalação

composer require arqel-dev/core

Normalmente instala-se via o meta-pacote arqel-dev/framework, que puxa arqel-dev/core e companheiros obrigatórios.

Convenções

• Namespace: Arqel\Core\
• declare(strict_types=1) em todos os ficheiros PHP
• Classes final por default — só sem final quando extensibilidade é design intent documentado
• ADR-018: auto-discovery via extra.laravel.providers

Links

• Source: packages/core/
• Skill para AI agents: SKILL.md
• Docs (public): arqel.dev/docs (em breve)
• Contracts e APIs detalhadas: PLANNING/05-api-php.md
• Planning tickets: PLANNING/08-fase-1-mvp.md §3

Licença

MIT — ver LICENSE na raiz do monorepo.