Download the PHP package sierratecnologia/gamer without Composer

On this page you can find all versions of the php package sierratecnologia/gamer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of sierratecnologia/gamer

Informations about the package gamer

SierraTecnologia Gamer

SierraTecnologia Gamer Various functionality, and basic controller included out-of-the-box.

Packagist Scrutinizer Code Quality Travis StyleCI License Build Status codecov

[x] Point Transaction system for laravel X

📚 Índice

  1. Introdução
  2. Instalação
  3. Arquitetura e Estrutura Interna
  4. Principais Funcionalidades
  5. Uso Prático
  6. Integração com o Ecossistema SierraTecnologia
  7. Extensão e Customização
  8. Exemplos Reais
  9. Configuração de Ferramentas de Qualidade
  10. Guia de Contribuição

🎮 Introdução

O que é o Gamer?

Gamer é um módulo de gamificação completo e extensível para aplicações Laravel, desenvolvido pela SierraTecnologia / Rica Soluções. O pacote oferece um sistema robusto de pontuação, conquistas, competições, badges e progressão de usuários, permitindo aumentar o engajamento e a retenção de usuários em plataformas web e APIs.

Objetivo e Motivação

O projeto nasceu da necessidade de criar experiências interativas e engajadoras em plataformas corporativas, educacionais e de e-commerce. Com o Gamer, é possível:

Contexto no Ecossistema SierraTecnologia

O Gamer faz parte do ecossistema modular da SierraTecnologia / Rica Soluções, integrando-se nativamente com outros módulos como:

Benefícios para Plataformas de Engajamento

📦 Instalação

Requisitos Mínimos

Dependências Principais

Instalação via Composer

Publicação de Configurações e Migrations

Após a instalação, publique os arquivos de configuração e execute as migrations:

Publicação de Assets e Views (Opcional)

Registro de Service Provider

O Service Provider é registrado automaticamente através do Laravel Auto-Discovery. Caso necessário, adicione manualmente em config/app.php:

Configuração do Arquivo .env

Para integração com serviços externos, adicione ao .env:

🏗️ Arquitetura e Estrutura Interna

Estrutura de Diretórios

Componentes Centrais

1. Sistema de Pontos e Transações

2. Trait Pointable

Funcionalidades:

3. Sistema de Competições

4. Sistema de Scores e Séries

5. Sistema de Eventos

6. Observers

Padrões Arquiteturais

Event-Driven Architecture

O Gamer utiliza Spatie Event Sourcing para rastreamento completo de eventos:

Repository Pattern

Exemplo de Repository:

Service Layer

Comunicação entre Camadas

Integração com Eloquent

O sistema utiliza relacionamentos polimórficos para máxima flexibilidade:

🚀 Principais Funcionalidades

1. Sistema de Pontuação e Níveis

Adicionar Pontos

Consultar Saldo Atual

Histórico de Transações

2. Sistema de Conquistas e Badges

(Em desenvolvimento - estrutura preparada em migrations)

3. Eventos Automáticos de Gamificação

O sistema observa automaticamente eventos do Laravel:

Eventos de Autenticação

Eventos de Eloquent

4. Sistema de Competições

5. Dashboard e APIs de Ranking

Controllers Disponíveis

Rotas Disponíveis

6. Exemplo Prático de Fluxo Completo

💻 Uso Prático

Como Implementar o Sistema de Pontos em um Projeto Laravel

Passo 1: Implementar o Contrato e Trait

Passo 2: Criar Eventos de Gamificação

Passo 3: Registrar Listeners

Como Criar Badges e Conquistas Personalizadas

Estrutura de Badge (em desenvolvimento)

Como Conectar o Gamer a Eventos e Listeners Existentes

Usando Observers

Usando Event Subscribers

Boas Práticas de Integração

  1. Separe a lógica de pontuação

    • Use Listeners/Subscribers para manter controllers limpos
    • Centralize regras de negócio em Services

  2. Documente regras de pontuação

  3. Use transações de banco de dados

  4. Valide dados antes de atribuir pontos

🔗 Integração com o Ecossistema SierraTecnologia

Módulos do Ecossistema

O Gamer integra-se nativamente com:

1. Tracking (sierratecnologia/tracking)

2. Finder (sierratecnologia/finder)

3. Informate (Notificações)

4. Market (E-commerce)

5. Audit (Auditoria)

Padrões Compartilhados

Event Sourcing com Spatie

Base Models (Pedreiro)

Padrões de CI/CD

Todos os módulos SierraTecnologia seguem:

Versionamento Semântico

O Gamer segue Semantic Versioning 2.0.0:

Versão atual: 0.4.4 (stable)

🛠️ Extensão e Customização

Como Criar Novos Tipos de Conquistas

Passo 1: Criar Model de Conquista

Passo 2: Criar Service de Verificação

Como Personalizar a Lógica de Progressão

Sistema de Níveis

Recomendações para Manter Compatibilidade

  1. Não modifique tabelas core do Gamer

    • Use migrations separadas para extensões
    • Prefira relacionamentos polimórficos

  2. Estenda em vez de modificar

  3. Use eventos para customizações

  4. Namespace suas extensões

📊 Exemplos Reais

Caso de Uso 1: Plataforma Educacional

Contexto: Plataforma de cursos online da SierraTecnologia

Implementação:

Resultados:

Caso de Uso 2: Marketplace Gamificado

Contexto: E-commerce B2C integrado com Market

Resultados:

🧪 Configuração de Ferramentas de Qualidade

PHPUnit - Testes Automatizados

Executar testes:

PHPCS - Padrão PSR-12

Executar verificação:

PHPStan - Análise Estática (Nível 8)

Executar análise:

PHPMD - Boas Práticas

Executar PHPMD:

Psalm - Verificação de Tipos

👥 Guia de Contribuição

Como Contribuir

Contribuições são muito bem-vindas! Para contribuir com o Gamer:

  1. Fork o repositório
  2. Crie uma branch para sua feature (git checkout -b feature/nova-funcionalidade)
  3. Commit suas mudanças seguindo os padrões
  4. Push para a branch (git push origin feature/nova-funcionalidade)
  5. Abra um Pull Request

Padrões de Commits

Seguimos Conventional Commits:

Tipos:

Exemplos:

Padrões de Branches

Versionamento Semântico

Seguimos SemVer 2.0.0:

Execução Local das Ferramentas

Checklist de Pull Request

Antes de submeter um PR, verifique:

Changelog

Refer to the Changelog for a full history of the project.

Support

The following support channels are available at your fingertips:

Contributing & Protocols

Thank you for considering contributing to this project! The contribution guide can be found in CONTRIBUTING.md.

Bug reports, feature requests, and pull requests are very welcome.

Security Vulnerabilities

If you discover a security vulnerability within this project, please send an e-mail to [email protected]. All security vulnerabilities will be promptly addressed.

About SierraTecnologia

SierraTecnologia is a software solutions startup, specialized in integrated enterprise solutions for SMEs established in Rio de Janeiro, Brazil since June 2008. We believe that our drive The Value, The Reach, and The Impact is what differentiates us and unleash the endless possibilities of our philosophy through the power of software. We like to call it Innovation At The Speed Of Life. That's how we do our share of advancing humanity.

License

This software is released under The MIT License (MIT).

(c) 2008-2020 SierraTecnologia, Some rights reserved.

All versions of gamer with dependencies

PHP Build Version
Package Version
Requires sierratecnologia/audit Version ^0.4.0
sierratecnologia/pedreiro Version ^0.4.0
sierratecnologia/muleta Version ^0.4.0
markrogoyski/math-php Version *
php-ai/php-ml Version >=0.8
spatie/laravel-event-sourcing Version ^4.3
jordanbrauer/unit-converter Version ^0.8.4
lorisleiva/laravel-actions Version ^1.1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package sierratecnologia/gamer contains the following files

Loading the files please wait ...