返回 Skill 列表
extension
分类: 开发与工程无需 API Key

agregadores-performance-potencial

用于实现聚合服务,这些服务根据证据计算绩效和潜力轴。

person作者: jakexiaohubgithub

Instruções da Skill

Implemente serviços puros, determinísticos e testáveis. Agregadores não escrevem no banco e não conhecem UI.

Regras e Passos

  1. Modelagem (M):

    • Identifique dimensões do eixo (ex.: Entrega, Qualidade, Autonomia).
    • Defina pesos e normalização por complexidade de contexto.
  2. Lógica (L):

    • Implemente agregadores separados:

      • PerformanceAggregator
      • PotentialAggregator
    • Garanta a regra: Potencial só cresce com progressão de complexidade.

  3. Integração:

    • Receba evidências via eventos.
    • Retorne DTOs (AxesResult), nunca Models.
  4. Teste (T):

    • Teste cálculos com múltiplos contextos e ciclos.
    • Teste teto de potencial sem progressão.

Uso de Ferramentas

  • Use classes em app/Domains/Aggregation.
  • Não use Eloquent dentro dos testes de cálculo (prefira mocks ou collections).