AssetHub Documentação

Visão geral

AssetHub é um sistema completo de gestão de ativos construído com Laravel 11, Vue 3 e Tailwind CSS. A versão 3.0 adiciona um Translation Editor completo, locales personalizados, importação/exportação CSV e localização efetiva de fuso horário/moeda — sobre a base do v2 (rastreamento batch/lot, alocações, disposições e páginas públicas de entrega QR).

Requisitos do servidor

• PHP 8.2 ou superior
• MySQL 5.7+ ou MariaDB 10.3+
• Composer 2.x
• Node.js 18+ e npm 9+
• Servidor web: Apache ou Nginx

Extensões PHP requeridas

• OpenSSL, PDO, PDO_MySQL, Mbstring, Tokenizer, XML, Ctype, JSON, GD, Fileinfo

Espaço em disco

~ 200 MB mínimo. Reserve espaço extra para fotos de ativos e anexos de documentos.

Instalação

Opção A — Instalador web (Recomendado)

1. Envie os arquivos do projeto para seu servidor web.
2. Aponte o document root do domínio para public/.
3. Defina permissões: storage/ e bootstrap/cache/ devem ser graváveis (chmod 775).
4. Copie .env.example para .env e defina APP_KEY (execute php artisan key:generate se tiver SSH/Terminal, ou veja Configuração cPanel → Passo 5 para alternativas no Gerenciador de Arquivos).
5. Acesse https://yourdomain.com/install no navegador.
6. Siga o assistente — Requirements → Database → Migrate → Admin Account → Done.

Opção B — Instalação via CLI

# 1. Instalar dependências
composer install --no-dev --optimize-autoloader
npm install
npm run build

# 2. Configurar ambiente
cp .env.example .env
php artisan key:generate

# 3. Editar .env para credenciais do BD
# DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD

# 4. Criar tabelas e dados iniciais
php artisan migrate --seed

# 5. Criar link simbólico storage para uploads
php artisan storage:link

# 6. Cachear config para produção
php artisan config:cache
php artisan route:cache
php artisan view:cache

# 7. Marcar como instalado
echo "Installed" > storage/installed.lock

Assistente Passo 2 — Configuração do banco de dados

Quando o assistente chegar ao Passo 2, você deve informar os detalhes de conexão MySQL do banco criado no painel de hospedagem. O banco deve já existir (pode estar vazio — a próxima etapa do assistente criará as tabelas).

Onde encontrar essas credenciais por painel de hospedagem

• Hostinger: hPanel → Databases → Management → clique no seu banco de dados. A página mostra nome, usuário e um botão "Show password".
• cPanel: cPanel → MySQL Databases. A lista de bancos mostra os nomes; os usuários aparecem abaixo. Use "Change Password" se necessário.
• Plesk: Plesk → Databases → clique no nome do banco de dados. A página de detalhes mostra as credenciais e oferece redefinição de senha.
• DirectAdmin: DirectAdmin → MySQL Management → clique no banco de dados. As credenciais e a redefinição de senha estão na página de detalhes.
• BD externo / gerenciado: AWS RDS, DigitalOcean Managed Database, etc. Use o hostname personalizado, a porta (geralmente 3306, mas verifique), o nome do BD, o usuário e a senha do console na nuvem. Certifique-se de que o IP do servidor esteja na whitelist do firewall do BD.

Erros comuns e como corrigi-los

Localhost (Desenvolvimento local)

Guia rápido para rodar o AssetHub no seu computador para testes ou desenvolvimento antes do deploy em produção. Escolha o ambiente que corresponde ao seu sistema operacional.

Opção 1 — Laravel Herd (Recomendado, macOS e Windows)

Laravel Herd é o ambiente local oficial do time Laravel — gratuito, nativo, sem Docker. Inclui PHP 8.2/8.3/8.4, Nginx e (no Herd Pro) MySQL/Redis.

1. Baixe e instale o Laravel Herd em herd.laravel.com.
2. Coloque a pasta do projeto AssetHub dentro de ~/Herd/ (macOS) ou %USERPROFILE%\Herd\ (Windows). O Herd cria um domínio .test automaticamente — ex.: http://assethub.test.
3. Abra Herd → Sites e confirme que a versão do PHP é 8.2 ou 8.3. Clique com o direito no site → Secure para habilitar HTTPS (necessário para o leitor de QR).
4. Crie um banco MySQL. Com Herd Pro, use Services → MySQL → Open in TablePlus. Caso contrário, instale o MySQL Community ou use SQLite (DB_CONNECTION=sqlite, touch database/database.sqlite).
5. Copie .env.example para .env, preencha as credenciais do BD e execute php artisan key:generate na raiz do projeto.
6. Abra http://assethub.test/install no navegador e siga o assistente do instalador.

Opção 2 — XAMPP (Windows, macOS, Linux)

XAMPP empacota Apache, MySQL/MariaDB e PHP. Grátis e multiplataforma. Garanta escolher uma versão com PHP 8.2 ou mais novo.

1. Baixe o XAMPP 8.2+ em apachefriends.org e instale.
2. Copie o projeto AssetHub para C:\xampp\htdocs\AssetHub\ (Windows) ou /Applications/XAMPP/htdocs/AssetHub/ (macOS).
3. Abra o XAMPP Control Panel e inicie Apache e MySQL. Se as portas estiverem ocupadas, use Config → service.conf para trocar o Apache para 8080.
4. Vá em http://localhost/phpmyadmin → Novo → crie um banco chamado assethub com agrupamento utf8mb4.
5. Na pasta do projeto: copie .env.example para .env, defina DB_DATABASE=assethub, DB_USERNAME=root, deixe DB_PASSWORD vazio (padrão XAMPP). Execute php artisan key:generate.
6. Acesse http://localhost/AssetHub/public/install para executar o assistente do instalador.

Opção 3 — Laragon (Windows)

Laragon é um stack portátil para Windows projetado para Laravel — vhosts automáticos, URLs limpas, MySQL/MariaDB e HeidiSQL incluído.

1. Baixe o Laragon Full em laragon.org e instale.
2. No Laragon: Menu → PHP → Versão — mude para PHP 8.2 ou 8.3.
3. Copie o projeto AssetHub para C:\laragon\www\AssetHub\.
4. Clique em Start All. O Laragon cria o vhost automaticamente: http://assethub.test (apontando para a pasta public/).
5. Abra o HeidiSQL (incluído) → crie o banco assethub. Credenciais padrão: usuário root, senha vazia.
6. Edite o .env com as credenciais do BD, execute php artisan key:generate e acesse http://assethub.test/install.

Opção 4 — Servidor PHP embutido (sem servidor web)

A opção mais simples: o Laravel vem com artisan serve, que inicia um servidor PHP de desenvolvimento. Não exige Apache nem Nginx. Ideal para testes rápidos.

# Instalar dependências e configurar
cd /path/to/AssetHub
composer install
cp .env.example .env
php artisan key:generate

# Rodar migrations e seed dos dados iniciais
php artisan migrate --seed

# Iniciar o servidor de desenvolvimento
php artisan serve
# Depois acesse: http://127.0.0.1:8000/install

Problemas comuns no localhost

O leitor de QR não abre a câmera em http://

APIs de câmera do navegador exigem HTTPS, com uma exceção: http://localhost e http://127.0.0.1 são tratados como contextos seguros. Se você acessar o AssetHub via seu IP de LAN (ex.: http://192.168.1.10), a câmera será recusada. Use localhost para desenvolvimento, ou habilite HTTPS via Herd / mkcert.

Permission denied em storage (macOS / Linux)

Se aparecerem erros de escrita quando o app tenta logar ou cachear, corrija as permissões: chmod -R 775 storage bootstrap/cache. No Windows normalmente não é necessário.

Porta já em uso

Se a porta 8000 estiver ocupada por outro app, use uma porta diferente:

php artisan serve --port=8001

Testar e-mails localmente

SMTP real não está disponível na maioria das configurações localhost. Duas opções seguras: (1) defina MAIL_MAILER=log no .env — os e-mails são gravados em storage/logs/laravel.log em vez de enviados; ou (2) use Mailtrap / MailHog para capturar o e-mail de saída em uma caixa falsa.

MAIL_MAILER=log
# Todos os e-mails são gravados em storage/logs/laravel.log

Assets do frontend (Vite / Tailwind)

O frontend Vue/Tailwind do AssetHub vem pré-compilado no pacote. Se editar componentes Vue ou a config do Tailwind, você precisará do Node.js 18+:

npm install
npm run dev    # Hot-reload durante o desenvolvimento
npm run build  # Build de produção (executar antes do deploy)

Implantação no Hostinger Single (Hospedagem compartilhada)

Este é o caminho recomendado para usuários sem VPS ou experiência técnica. O AssetHub é totalmente compatível com o plano Hostinger Single Web Hosting mais barato (~$2,99/mês). Sem SSH, sem Composer, sem linha de comando — o Single inclui cron jobs nativos, PHP 8.3 e SSL gratuito.

Passo 1 — Prepare sua hospedagem

1. Faça login no Hostinger hPanel.
2. Vá em Hospedagem → Gerenciar para seu domínio.
3. Defina a versão do PHP como 8.2 ou 8.3 via Avançado → Configuração PHP.
4. Garanta que estas extensões PHP estejam ativas (geralmente padrão):
   • OpenSSL, PDO, PDO_MySQL, Mbstring, GD, Tokenizer, XML, Ctype, JSON, Fileinfo

Passo 2 — Criar banco de dados MySQL

1. No hPanel, vá em Bancos de dados → MySQL Databases.
2. Clique em Criar novo banco de dados.
3. Anote estes 3 valores:
   • Nome do banco de dados — ex.: u123_AssetHub
   • Usuário — ex.: u123_admin
   • Senha — gerada automaticamente, guarde com segurança

Passo 3 — Enviar arquivos

1. Vá em Arquivos → File Manager no hPanel.
2. Navegue até public_html/ (é a raiz do seu domínio).
3. Apague qualquer index.html ou default.php padrão nessa pasta.
4. Clique em Enviar arquivos e envie o source.zip completo do pacote.
   Ou envie o conteúdo da pasta /source/ diretamente via FTP, se preferir.
5. Se enviou um ZIP, clique com botão direito → Extrair. Após extração, todos os arquivos devem estar na raiz de public_html/.
6. Verifique se public_html/ contém: app/, public/, vendor/, .htaccess, index.php (em public/), .env, etc.

Passo 4 — Rodar o instalador

1. Abra o navegador e acesse https://yourdomain.com/install.
2. Você verá o AssetHub Installer.
3. Passo 1: Requirements — Todas as verificações devem passar (verde). Se alguma falhar, contate o suporte da Hostinger para ativar a extensão PHP ausente.
4. Passo 2: Database — Informe as credenciais do Passo 2 acima:
   • Host: localhost
   • Porta: 3306
   • Banco de dados: u123_AssetHub
   • Usuário: u123_admin
   • Senha: (a gerada pela Hostinger)
5. Passo 3: Migrate — Clique em "Run Migrations & Seed". Demora ~10 segundos. Não atualize a página.
6. Passo 4: Admin — Crie sua conta de administrador. Use uma senha forte.
7. Pronto! — Você verá a URL Cron (salve-a!) e um botão de login.

Passo 5 — Configurar alertas de e-mail automáticos via Hostinger Cron

O AssetHub usa o scheduler do Laravel para tarefas em segundo plano: alertas de garantia, lembretes de manutenção, validade de documentos, atualização de depreciação e checkouts em atraso. Configure um cron job no hPanel e o Laravel decide qual tarefa rodar e quando.

1. No hPanel, vá em Avançado → Cron Jobs.
2. Clique em Criar Cron job.
3. Selecione o tipo: Custom (não "PHP" — precisamos passar um argumento).
4. Para o comando, informe (substitua uXXXXXX pelo seu usuário Hostinger):

   /usr/bin/php /home/uXXXXXX/public_html/artisan schedule:run

   Dica: abra o File Manager, localize o arquivo artisan (raiz do projeto), clique com botão direito → Propriedades para copiar o caminho completo.
5. Defina a programação como A cada minuto — os cinco campos (Minuto, Hora, Dia, Mês, Dia da semana) em *.
6. Clique em Salvar.

Pronto — o AssetHub agora envia automaticamente lembretes de checkout em atraso, alertas de manutenção, validade de documentos, garantias, e atualiza valores de depreciação. O Laravel agenda internamente cada job na frequência correta (diário 08:00, mensal, etc.).

Passo 6 — Configurar e-mail (SMTP)

A Hostinger fornece contas de e-mail com cada plano. Para usá-las nas notificações do AssetHub:

1. No hPanel, vá em E-mails → Contas de e-mail e crie uma (ex.: noreply@yourdomain.com).
2. Edite o arquivo .env em public_html/ via File Manager:

   MAIL_MAILER=smtp
   MAIL_HOST=smtp.hostinger.com
   MAIL_PORT=587
   MAIL_USERNAME=noreply@yourdomain.com
   MAIL_PASSWORD=your_email_password
   MAIL_ENCRYPTION=tls
   MAIL_FROM_ADDRESS=noreply@yourdomain.com
   MAIL_FROM_NAME="Your Company Name"

3. Salve o arquivo.
4. Faça login no AssetHub → Configurações → aba Email → Enviar e-mail de teste. Se receber, está pronto.

Problemas comuns no Hostinger Single

"500 Internal Server Error" após envio

• Verifique se .htaccess existe na raiz de public_html/ e contém as regras de rewrite.
• Verifique se a versão do PHP está em 8.2 ou 8.3 no hPanel.
• Confira storage/logs/laravel.log via File Manager para ver o erro real.

"Permission denied" em uploads

Normalmente a Hostinger define as permissões corretas, mas se não:

• Clique com o direito em storage/ no File Manager → Permissões → defina 755 recursivamente.
• O mesmo para bootstrap/cache/.

O leitor de QR não abre a câmera

APIs de câmera do navegador exigem HTTPS. A Hostinger fornece SSL gratuito via Let's Encrypt — ative em SSL → Gerenciar no hPanel.

E-mails agendados não são enviados

• No hPanel → Cron Jobs → verifique a coluna Last run na entrada de cron. Se vazia, o cron não está disparando — confirme o caminho do artisan.
• Teste o comando manualmente: abra Terminal no hPanel (se disponível) e rode o comando do cron. Se der erro, a mensagem indicará o problema (versão errada do PHP, caminho errado, etc.).
• Verifique se o SMTP está configurado corretamente (Configurações → Email → Enviar teste).
• Verifique storage/logs/laravel.log em busca de erros do scheduler.

Desempenho lento

O Hostinger Single tem CPU/RAM compartilhados. Se sua equipe tiver mais de 20 usuários, considere:

• Upgrade para Premium (~$3,99/mês) — servidores mais rápidos, mais recursos, vários bancos.
• Ou Business (~$5,99/mês) — recursos dedicados, backups diários, ambiente de staging.

Implantando no cPanel (Hospedagem Compartilhada)

Este guia cobre a hospedagem compartilhada cPanel padrão (Namecheap, Bluehost, GoDaddy e a maioria dos hosts econômicos). O AssetHub vem com vendor/ e ativos de frontend pré-compilados — sem necessidade de Composer, npm ou Terminal web. Se seu cPanel não tiver Terminal, use SSH Access ou as alternativas do Gerenciador de Arquivos abaixo.

Passo 1 — Definir versão PHP e extensões

1. Faça login no cPanel.
2. Abra o MultiPHP Manager (ou Select PHP Version) e defina seu domínio como PHP 8.2 ou 8.3.
3. Abra o MultiPHP INI Editor ou PHP Extensions e confirme que estas estão habilitadas:
   • OpenSSL, PDO, PDO_MySQL, Mbstring, GD, Tokenizer, XML, Ctype, JSON, Fileinfo
4. Se alguma extensão estiver ausente, habilite-a na lista de extensões ou entre em contato com o suporte do host.

Passo 2 — Habilitar SSL (HTTPS)

1. Vá em SSL/TLS Status (ou Let's Encrypt SSL / AutoSSL).
2. Execute o AutoSSL ou instale um certificado gratuito para seu domínio.
3. O HTTPS é obrigatório para que o leitor de QR do navegador acesse a câmera.

Passo 3 — Criar banco de dados MySQL e usuário

1. Abra o Manage My Databases (em Bancos de dados).
2. Em Create New Database, informe um nome (ex.: assethub) e clique em Create. O cPanel adiciona o prefixo da sua conta automaticamente — o nome completo ficará como cpaneluser_assethub.
3. Em MySQL Users, crie um usuário com senha forte. Copie o nome de usuário completo com prefixo.
4. Em Add User To Database, selecione o usuário e o banco, clique em Add e conceda ALL PRIVILEGES. Este passo é fácil de esquecer — sem ele você terá erros Access denied (1045).
5. Anote esses três valores exatamente como aparecem no cPanel:
   • Nome do banco de dados — ex.: u123_AssetHub
   • Usuário — ex.: u123_admin
   • Senha — gerada automaticamente, guarde com segurança

Passo 4 — Enviar arquivos

1. Abra o Gerenciador de Arquivos e vá para public_html/ (raiz de documentos do seu domínio).
2. Habilite Configurações → Mostrar arquivos ocultos para que você possa ver .htaccess e .env.
3. Exclua qualquer index.html padrão em public_html/ se houver.
4. Envie o pacote source.zip e Extraia-o, ou envie o conteúdo da pasta /source/ via FTP.
5. Após a extração, public_html/ deve conter app/, public/, vendor/, o .htaccess raiz e artisan no mesmo nível.

Passo 5 — Preparar o .env antes de executar o instalador

Conclua este passo antes de acessar /install. O Laravel requer uma APP_KEY válida e as configurações corretas de banco de dados no .env.

1. No Gerenciador de Arquivos, copie .env.example para .env (mesma pasta que artisan).
2. Edite o .env e defina no mínimo:

   APP_NAME=AssetHub
   APP_ENV=production
   APP_DEBUG=false
   APP_URL=https://yourdomain.com
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=cpaneluser_assethub
   DB_USERNAME=cpaneluser_admin
   DB_PASSWORD="your_password"
   
   SESSION_DRIVER=file
   CACHE_STORE=file

3. Defina DB_CONNECTION=mysql — o .env.example padrão usa SQLite; hospedagem compartilhada requer MySQL.
4. Defina SESSION_DRIVER=file e CACHE_STORE=file antes da primeira migration (evita erros de "tabela de sessões não encontrada").
5. Envolva DB_PASSWORD em aspas duplas se contiver caracteres especiais (#, $, !, etc.).

Gerar APP_KEY (sem necessidade de Terminal)

Muitos planos cPanel não incluem Terminal web. Use um destes métodos:

• SSH Access (cPanel → Segurança → SSH Access): conecte-se com PuTTY ou PowerShell, depois execute cd ~/public_html && php artisan key:generate.
• Auxiliar do Gerenciador de Arquivos — crie temporariamente o arquivo public/genkey.php, acesse-o no navegador, copie o resultado para APP_KEY= e exclua o arquivo imediatamente.

  <?php
  echo 'base64:' . base64_encode(random_bytes(32));

• No seu PC — se PHP estiver instalado localmente, execute php -r "echo 'base64:'.base64_encode(random_bytes(32));" e cole o resultado no .env.

• Defina as permissões de storage/ e bootstrap/cache/ como 755 (recursivo) se o instalador reportar erros de gravação.

Passo 6 — Executar o instalador web

1. Abra https://seudominio.com/install no navegador.
2. Passo 1: Requisitos — todas as verificações devem passar (verde). Corrija qualquer extensão PHP ausente conforme o Passo 1 acima.
3. Passo 2: Banco de dados — informe os nomes exatos com prefixo do Passo 3:
   • Host: 127.0.0.1 or localhost
   • Porta: 3306
   • Banco de dados: cpaneluser_assethub
   • Usuário: cpaneluser_admin
   • Senha: (your MySQL password)
4. Passo 3: Migrate — clique em "Run Migrations & Seed". Leva ~10 segundos. Não atualize a página.
5. Desmarque Include demo data para uma instalação de produção limpa.
6. Passo 4: Admin — crie sua conta de administrador.
7. Pronto! — salve a URL Cron exibida na tela final.

Passo 7 — Configurar Cron Jobs para alertas por e-mail

O AssetHub precisa de um cron job rodando a cada minuto para que o Laravel possa enviar alertas de garantia, lembretes de manutenção e outros e-mails agendados.

1. No cPanel, vá em Advanced → Cron Jobs.
2. Em Add New Cron Job, defina a programação como A cada minuto (* * * * *).
3. Informe o comando (substitua CPANELUSER pelo seu nome de usuário do cPanel em Informações Gerais):

   /usr/local/bin/php /home/CPANELUSER/public_html/artisan schedule:run

   Dica: o caminho do PHP pode ser /usr/local/bin/php ou /usr/bin/php — pergunte ao host se não tiver certeza. O caminho do artisan é onde você enviou o projeto (geralmente /home/CPANELUSER/public_html/artisan).
4. Clique em Add New Cron Job para salvar.

Passo 8 — Configurar e-mail (SMTP)

Crie uma conta de e-mail no cPanel para notificações de saída:

1. Vá em Email Accounts → crie, por ex., noreply@seudominio.com.
2. Edite o .env no Gerenciador de Arquivos:

   MAIL_MAILER=smtp
   MAIL_HOST=mail.yourdomain.com
   MAIL_PORT=587
   MAIL_USERNAME=noreply@yourdomain.com
   MAIL_PASSWORD=your_email_password
   MAIL_ENCRYPTION=tls
   MAIL_FROM_ADDRESS=noreply@yourdomain.com
   MAIL_FROM_NAME="Your Company Name"

3. Salve, depois no AssetHub: Configurações → E-mail → Enviar e-mail de teste.

Problemas comuns no cPanel

"Access denied for user" (SQLSTATE 1045)

• Copie o nome do banco de dados e o nome de usuário exatamente do cPanel — incluindo o prefixo da conta.
• Confirme que concluiu Add User To Database com ALL PRIVILEGES.
• Redefina a senha MySQL no cPanel e atualize o .env — use aspas ao redor de DB_PASSWORD se contiver caracteres especiais.

Migration falha após o passo de Banco de dados ter passado

• O instalador testa as credenciais do formulário, mas o Migrate lê do .env. Certifique-se de que ambos coincidam.
• Exclua bootstrap/cache/config.php se existir, depois tente novamente.
• Certifique-se de que DB_CONNECTION=mysql está definido no .env (não sqlite).

"Invalid default value" durante a migration (1067)

Corrigido no AssetHub v2.1.0+ (a tabela checkouts usa colunas dateTime). Se tiver uma cópia mais antiga, atualize o arquivo de migration ou baixe o pacote mais recente do CodeCanyon.

"500 Internal Server Error" após envio

• Verifique se o .htaccess raiz existe e se o PHP é 8.2+.
• Verifique storage/logs/laravel.log para ver o erro real.
• Confirme que APP_KEY está definido no .env — chave vazia causa erros 500.

Sem Terminal no cPanel

Isso é normal em muitos planos compartilhados. Use SSH Access (se habilitado), o método temporário genkey.php do Passo 5, ou gere a chave no seu PC local.

A câmera do leitor QR não abre

Habilite o SSL em SSL/TLS Status → AutoSSL e acesse o site por https://.

Configuração

Arquivo .env

Configurações in-app

A maioria das opções não sensíveis pode ser configurada em Admin → Configurações:

• Geral: nome/e-mail/telefone da empresa, prefixo de asset tag
• Email: enviar e-mail de teste para verificar SMTP
• Notificações: limites de alerta de garantia, janela de lembrete de manutenção
• Localização: fuso horário (lista pesquisável, incl. Europe/Skopje), formato de data, código de moeda (incl. MKD — Denar macedônio), símbolo e posição do símbolo — aplicados em todo o app após salvar
• Geral → Public Asset Page: visibilidade do QR (público / login / desativado) e regenerar todos os códigos QR após alterações de URL
• A aba Localização vincula a Administration → Translations para o Translation Editor completo (somente admin)
• Branding: nome e logo — atualiza logo do login, rodapé, badge e título da aba do navegador (v4.0+). Subtítulo do login: edite auth.login_subtitle em Administration → Translations
• Appearance (v4.0+): personalize cores de marca, status e texto para modos claro e escuro — veja o guia de rebrand nas FAQ

Suporte Multilíngue

O AssetHub inclui 11 idiomas prontos para uso, incluindo árabe RTL e hindi. Os usuários trocam de idioma pelo menu de bandeiras no canto superior direito.

Idiomas incluídos

Como trocar de idioma

1. Clique no ícone de bandeira (canto superior direito) para abrir o menu.
2. Escolha seu idioma na lista.
3. A página recarrega; todos os rótulos, datas e formatos de moeda mudam.
4. Sua escolha é salva tanto na sua conta de usuário quanto em um cookie (1 ano).

Adicionando um idioma personalizado (admin)

Vá em Administration → Translations (usuários admin com permissão manage translations):

• Clique em "Add Locale" — informe um código (ex.: mk para macedônio), nome de exibição, nome nativo, nome do arquivo SVG da bandeira, direção (LTR/RTL) e um locale base para copiar traduções.
• O novo locale aparece no seletor de idioma e na lista de idioma padrão em Settings → Localization.
• Traduções armazenadas no BD substituem automaticamente as traduções de arquivo em lang/{code}/.

Translation Editor

O editor lista cada chave de tradução agrupada por arquivo (ex.: assets, nav, settings). As chaves mostram a linha de base do arquivo e qualquer override no BD.

• Filtre por locale, grupo de tradução ou texto de busca.
• Clique em um valor para editar inline; as alterações são salvas no banco de dados imediatamente.
• Redefina uma chave para voltar à linha de base do arquivo.
• Locales integrados (en, vi, es, …) podem ser editados; locales personalizados são totalmente orientados pelo BD.
• Somente usuários com a permissão manage translations podem acessar esta página.

CSV import / export

• Export — baixe todas as chaves de um locale como CSV (group,key,value).
• Import — envie um CSV com as mesmas colunas; overrides existentes no BD são atualizados e novas chaves são inseridas.

Locale padrão por usuário

Cada usuário tem uma coluna locale. Notificações por email são enviadas automaticamente no idioma preferido do destinatário graças ao contrato HasLocalePreference do Laravel.

O idioma padrão do site é definido em Settings → Localization → Default Language. Usuários individuais substituem isso pelo seletor de idioma no cabeçalho.

Lista de funcionalidades

Usuários e Funções

O AssetHub vem com 5 funções pré-configuradas:

As permissões são armazenadas como funções Spatie — administradores podem ajustar por permissão via banco de dados.

Gestão de ativos

Criando ativos

1. Navegue até Ativos → Novo ativo.
2. Preencha nome, categoria, marca, modelo, número de série.
3. Adicione data de compra e preço (obrigatórios para depreciação).
4. Envie imagens (vários arquivos suportados, máx. 5 MB cada).
5. Salve — asset tag e código QR são gerados automaticamente.

Formato do Asset Tag

Padrão: {PREFIX}-{YEAR}-{NNNN}, ex.: AS-2026-0001. Configurável em Configurações → Geral → Prefixo Asset Tag.

Importação em massa

1. Clique em Importar na página de Ativos.
2. Baixe o modelo Excel.
3. Preencha seus dados — colunas obrigatórias: name, category_name.
4. Envie o arquivo.

Ativos em lote / batch (v2)

Para itens idênticos em quantidade (cadeiras, teclados, uniformes), escolha Tipo de rastreamento → Batch / Lot no formulário Novo ativo em vez de criar registros duplicados.

1. Informe a quantidade e a unidade (peça, conjunto, caixa). Ao salvar, o estoque é colocado no pool do armazém.
2. Abra o ativo → aba Allocations → Allocate para alocar unidades a um funcionário ou departamento.
3. Use Return, Adjust (danificado/perdido/reparo) ou ações de disposição — o resumo em tempo real deve conciliar com a quantidade total.
4. Ativos batch suportam apenas preço unitário; a depreciação é opcional e desativada por padrão para configuração mais rápida.

Códigos QR

Cada ativo recebe automaticamente um código QR ao ser criado. A leitura abre a página pública ou autenticada do ativo (veja abaixo). A leitura no app vai direto para a tela de detalhes do ativo.

Imprimir etiquetas

• Etiqueta única: clique no ícone de impressora em qualquer linha de ativo.
• Formato PDF: A4, 2 etiquetas por linha, inclui asset tag, nome, marca, série.

Escaneamento

Clique em Escanear QR na página de Ativos. Permita o acesso à câmera. O leitor usa html5-qrcode e funciona em qualquer navegador moderno. Nota: acesso à câmera requer HTTPS ou localhost.

Página pública de entrega QR (v2)

Cada ativo também tem uma URL pública imprimível em /a/{asset_tag} — útil para entrega física sem login.

• Configure em Settings → General → Public Asset Page: Público, Login obrigatório ou Desativado.
• A página mostra foto, campos principais e (para lotes) detalhamento de quantidade. Os usuários podem imprimi-la como ficha de entrega.
• Após alterar APP_URL, clique em Regenerate all QR codes no mesmo painel de configurações.

Fluxos de trabalho

Atribuição de ativo

1. Abra a página de detalhe de um ativo.
2. Clique em Atribuir (visível se o ativo estiver disponível).
3. Escolha um usuário, data de devolução opcional, notas.
4. Envie — a transação é criada e a notificação por e-mail enviada.

Solicitações de ativos

Funcionários podem enviar solicitações para ativos de que precisam. As solicitações têm 4 status: pending → approved → fulfilled, ou rejected. E-mails de aprovação são enviados automaticamente.

Check-in / Check-out

Para ativos compartilhados (câmeras, projetores, veículos). Reservas têm faixas de data; o sistema evita checkouts sobrepostos. A visão calendário mostra todas as reservas de relance.

Disposições — Baixa formal (v2)

Itens desgastados ou danificados são baixados em lotes documentados com separação de funções (proponente ≠ aprovador). Requer as permissões manage disposals e approve disposals.

1. Barra lateral → Disposals → New Disposal. Defina título e período (Q1–Q4, anual ou ad-hoc).
2. Abra o rascunho → Add items — unidades batch danificadas elegíveis ou ativos individuais em condição Poor.
3. Clique em Submit for approval — o lote é bloqueado.
4. Um aprovador diferente clica em Approve & execute — ativos/unidades são marcados como disposed.
5. Imprima o disposal minutes (PDF) para registros de conformidade.

Depreciação

O AssetHub calcula a depreciação dos ativos usando um de três métodos:

Os padrões são herdados da categoria do ativo. As entradas de cronograma são geradas mensalmente. O current_value do ativo é atualizado automaticamente no 1º de cada mês.

Campos personalizados

Admin → Campos personalizados permite adicionar atributos personalizados ilimitados aos ativos:

• Tipos: texto, número, data, seleção (dropdown), área de texto, arquivo, caixa de seleção
• Escopo: aplicar a todas as categorias ou a uma específica
• Reordenar: arraste a alça
• Campos obrigatórios são validados ao salvar o ativo

Relatórios

Doze relatórios integrados, acessíveis pelo menu Relatórios:

1. Resumo de ativos — totais por status, condição, categoria, departamento
2. Depreciação — perda de valor por categoria, ativos mais depreciados
3. Transações — atividade de atribuição, devolução, transferência ao longo do tempo
4. Custo de manutenção — gastos por mês, categoria, tipo
5. Expiração de garantia — ativos que precisam atenção em 30/60/180 dias
6. Ativos por departamento — distribuição de ativos e uso de orçamento por departamento
7. Ativos por origem — distribuição entre compra, projeto, doação, transferência
8. Resumo de auditoria de inventário — discrepâncias em ciclos periódicos de auditoria
9. Atribuições a funcionários (v2) — quem possui o quê, incluindo alocações batch
10. Departamento / Localização (v2) — ativos e quantidades por departamento ou localização
11. Conciliação de inventário (v2) — estoque vs alocado vs danificado/perdido/disposed
12. Ativos danificados (v2) — itens marcados para reparo ou baixa

Todos os relatórios suportam exportação Excel e PDF pelos botões no cabeçalho da página. Relatórios v2 são conscientes de quantidade (contagem de ativos + unidades totais).

Ganchos web

O AssetHub pode notificar serviços externos em eventos importantes.

Eventos disponíveis

• asset.created, asset.updated, asset.deleted
• asset.assigned, asset.returned, asset.transferred
• request.created, request.approved, request.rejected, request.fulfilled
• maintenance.scheduled, maintenance.started, maintenance.completed
• checkout.created, checkout.returned

Formato do Payload

{
  "event": "asset.assigned",
  "timestamp": "2026-05-05T08:00:00+00:00",
  "data": {
    "asset_id": 1,
    "asset_tag": "AS-2026-0001",
    "asset_name": "HP EliteDesk 800",
    "to_user_id": 4,
    "transaction_id": 12
  }
}

Verificação de assinatura

Se um secret estiver configurado, as requisições incluem o cabeçalho X-AssetHub-Signature contendo HMAC-SHA256 do corpo. Verifique do seu lado:

$expected = hash_hmac('sha256', $rawBody, $secret);
if (hash_equals($expected, $request->header('X-AssetHub-Signature'))) {
  // válido
}

Política de retry

Entregas falhas são retentadas 3 vezes com 200 ms de atraso. Após 10 falhas consecutivas, o webhook é desativado automaticamente.

Tarefas agendadas

O AssetHub usa o scheduler do Laravel para jobs em segundo plano. Você precisa apenas de uma entrada de cron — o Laravel despacha internamente cada job no momento correto.

Hospedagem compartilhada (Interface de Cron Jobs do cPanel / Hostinger)

Consulte a seção Configuração cPanel → Passo 7 ou Configuração Hostinger → Passo 5 para instruções com capturas de tela. Em resumo: Advanced → Cron Jobs, comando:

/usr/bin/php /home/uXXXXXX/public_html/artisan schedule:run

Programação: a cada minuto (* nos cinco campos).

Comando cron do cPanel

Substitua CPANELUSER pelo seu nome de usuário do cPanel:

/usr/local/bin/php /home/CPANELUSER/public_html/artisan schedule:run

VPS / servidor dedicado (crontab)

Execute crontab -e como seu usuário web (geralmente www-data) e adicione:

* * * * * cd /path/to/AssetHub && php artisan schedule:run >> /dev/null 2>&1

Alternativa: pinger de URL externo

Se seu host não tem cron, use a URL Cron no app (Configurações → aba Sistema) com cron-job.org (grátis, a cada 15 min).

Jobs executados automaticamente

Upgrade Guides

Step-by-step guides for updating an existing installation. Open the guide that matches your current version.

• v3.1 → v4.0 — Full upgrade guide — Appearance settings, browser tab title from Branding. No migration required.
• v3.0 → v3.1 — Full upgrade guide — Visible languages checklist in navbar picker. No migration required.
• v2.x → v3.0 — Full upgrade guide — Translation Editor, custom locales, localization settings.
• v1.x → v2.0 — Full upgrade guide — Batch assets, disposals, public QR page, operational reports.

Solução de problemas

"Permission denied" em storage

chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

O leitor de QR não abre a câmera

APIs de câmera do navegador exigem HTTPS. Instale um certificado SSL ou use localhost para testar.

E-mails não chegam

Verifique storage/logs/laravel.log por erros. Use Configurações → Email → Enviar e-mail de teste para verificar credenciais SMTP. Garanta que seu servidor SMTP permita o IP de envio.

Banco de dados "Access denied" (1045) no cPanel

Usuário/senha incorretos, falta de atribuição do usuário ao banco de dados, ou caracteres especiais na senha que quebram a análise do .env. Consulte Configuração cPanel → Problemas comuns.

Erro de migration 1067 (Invalid default value)

O modo estrito do MySQL em hospedagem compartilhada rejeita múltiplas colunas timestamp NOT NULL. Corrigido na v2.1.0+. Atualize seu pacote ou altere checkout_date / expected_return_date para dateTime na migration de checkouts.

APP_KEY ausente / Erro 500 antes da instalação

O Laravel requer APP_KEY no .env antes de carregar o app. Se o cPanel não tiver Terminal, veja Configuração cPanel → Passo 5 para métodos SSH, genkey.php ou geração local.

Resetar instalação

Apague storage/installed.lock e acesse /install de novo. Dados existentes serão apagados se você rodar migrações novamente.

Desempenho — lista de ativos lenta

Execute php artisan optimize para cachear config, rotas, views. Garanta que o MySQL tenha índices em assets.asset_tag, assets.serial_number, assets.status (criados automaticamente pelas migrações).

Upgrading from v3.0.x to v3.1

Download the v3.1 package from CodeCanyon, replace application files (keep your .env and storage/ uploads). No new migrations are required. The new visible_locales setting is optional — if unset, all languages remain visible in the navbar picker.

v3.0 → v3.1 — Full upgrade guide

Atualização de v2.x para v3.0

Baixe o ZIP v3 do CodeCanyon, substitua os arquivos da aplicação (mantenha seu .env e uploads em storage/), depois execute php artisan migrate. Novas tabelas para locales personalizados e overrides de tradução são adicionadas automaticamente. Configurações e ativos existentes são preservados.

v2.x → v3.0 — Full upgrade guide

Atualização de v1.x para v2.0

Baixe o ZIP v2 do CodeCanyon, substitua os arquivos da aplicação (mantenha seu .env e uploads em storage/), depois execute php artisan migrate. A atualização não quebra compatibilidade — ativos individuais existentes continuam funcionando; novas tabelas batch/disposal são adicionadas automaticamente.

v1.x → v2.0 — Full upgrade guide

Registro de alterações

v3.1.0 — Visible Language Picker (2026-06)

• Settings → Localization: checklist to choose which languages appear in the navbar language dropdown (built-in + custom locales)
• Default language is always visible; picker auto-hides when only one language is selected
• Backend validates locale switches; users on a hidden locale fall back to the default language
• No database migration required — upgrade is file-replace only
• Branding do login: rodapé e badge seguem Settings → Branding → App Name (sem editar código)

v3.0.0 — Localização e Translation Editor (2026-06)

• Interface do Translation Editor em Administration → Translations (Add Locale, edição inline, busca/filtro por grupo)
• Locales personalizados armazenados no BD — código, nome de exibição, nome nativo, SVG de bandeira, direção, locale base
• Importação/exportação CSV para atualizações em massa de traduções
• Configurações de fuso horário e moeda agora aplicadas em todo o app (config/localization.php incl. Europe/Skopje, MKD)
• Settings → Localization: dropdowns de fuso horário/moeda com busca e suporte a valores personalizados
• Hindi (hi) adicionado como 11.º locale integrado; date_format respeitado nas páginas Vue
• manage translations com controle de permissão; overrides do banco se fundem com a linha de base dos arquivos lang/

v2.0.0 — Lançamento operacional (2026-06)

• Ativos em lote / batch — rastreamento de quantidade, alocações, devoluções, conciliação em tempo real
• 4 relatórios operacionais: Employee Assignments, Department/Location, Inventory Reconciliation, Damaged Assets
• Módulo de disposições — lotes de baixa, aprovação com separação de funções, ata PDF imprimível
• Página pública de ativos QR em /a/{tag} com visibilidade configurável
• Relatórios legados atualizados para mostrar contagem de ativos + unidades totais
• Códigos QR vinculam à página pública de entrega; o log de transações registra a quantidade em movimentações batch
• Dados demo atualizados, guia do usuário (enviado separadamente em documentation/) e strings i18n

v1.0.0 — Lançamento inicial (2026-05)

• CRUD de ativos com geração automática de QR
• 5 funções de usuário (Admin, IT Manager, Contador, Supervisor, Funcionário) com permissões granulares
• Rastreamento de Origem de ativo (compra centralizada, descentralizada, projeto de investimento, doação, transferência interna)
• Fluxos de atribuição, devolução com notificações por e-mail
• Fluxo de aprovação de transferência (pending → approved/rejected) com controle de permissão
• Fluxo de aprovação de solicitações de ativos
• Check-in/check-out com visão calendário
• Programação de manutenção com auto-renovação
• Anexos de documentos com alertas de validade
• Depreciação com 3 métodos + alertas de fim de vida útil
• Módulo de Auditoria de inventário — contagem periódica com rastreamento de discrepâncias
• Campos personalizados com 7 tipos de entrada e ordenação drag-drop
• 8 relatórios com gráficos, exportação Excel e PDF (incl. Ativos por origem, Resumo de auditoria)
• Log de auditoria via Spatie Activitylog com visualizador de diff
• Webhooks com assinatura HMAC e auto-retry
• UI multi-idioma: 10 idiomas (en, vi, es, fr, de, zh, ja, pt-BR, ru, ar com RTL)
• UI de Configurações para empresa, e-mail, notificações, localização, traduções
• Assistente de instalação via web
• Modo escuro com paleta emerald-teal

Créditos

Bibliotecas open-source utilizadas

• Laravel 11 — MIT
• Vue 3 — MIT
• Inertia.js — MIT
• Tailwind CSS — MIT
• Spatie Permission, Media Library, Activitylog — MIT
• Phosphor Icons — MIT (duotone weight)
• ApexCharts — MIT
• html5-qrcode — Apache 2.0
• Simple QrCode — MIT
• Laravel Excel — MIT
• Laravel DomPDF — MIT