1
Pré-requisitos
O que precisa estar instalado antes de começar
| Software | Versão Mínima | Observação | Status |
|---|---|---|---|
| Laragon Full | 6.0+ | Inclui PHP, MySQL e Apache | Instalar |
| PHP | 8.2+ | Já vem com o Laragon | Incluso |
| Composer | 2.x | Gerenciador de pacotes PHP | Instalar |
| Navegador | Chrome / Edge | Qualquer navegador moderno | Disponível |
| Node.js | 18+ | Apenas se recompilar assets | Opcional |
2
Instalar o Laragon
Ambiente de desenvolvimento local para Windows
1
Baixar o Laragon Full
Acesse laragon.org/download e baixe a versão Full (inclui PHP, MySQL, Apache e Redis).
2
Executar o instalador como Administrador
Deixe o caminho padrão:
C:\laragon\ — não altere.3
Selecionar PHP 8.2+
Clique com botão direito no ícone do Laragon (bandeja) → PHP → selecione versão 8.2 ou 8.3.
4
Iniciar o Laragon
Abra o Laragon e clique em Start All. O ícone ficará verde na bandeja do sistema.
3
Instalar o Composer
Gerenciador de dependências PHP
1
Baixar o instalador
Acesse getcomposer.org/download e baixe o Composer-Setup.exe.
2
Executar o instalador
Quando pedir o caminho do PHP, aponte para:
C:\laragon\bin\php\php8.x\php.exe3
Verificar a instalação
Abra o terminal do Laragon e execute o comando abaixo. Deve exibir a versão do Composer.
composer --version # Resultado esperado: Composer version 2.x.x
4
Copiar o Projeto
Transferir os arquivos do sistema para o novo computador
1
Copiar via pendrive ou HD externo
Copie a pasta oxini completa para dentro de
C:\laragon\www\2
Estrutura esperada após a cópia
Confirme que os arquivos estão no caminho correto:
C:\laragon\www\oxini\app\
C:\laragon\www\oxini\database\
C:\laragon\www\oxini\public\
C:\laragon\www\oxini\resources\
C:\laragon\www\oxini\.env.example
C:\laragon\www\oxini\composer.json
Não copie a pasta vendor/
A pasta vendor/ não precisa ser copiada — ela será gerada pelo Composer automaticamente no próximo passo. Isso economiza espaço no pendrive.
5
Configurar o Sistema
Instalar dependências e gerar chave de segurança
Abra o Terminal do Laragon (clique com botão direito no ícone → Terminal) e execute:
# 1. Entrar na pasta do projeto cd C:\laragon\www\oxini # 2. Instalar todas as dependências PHP composer install # 3. Copiar o arquivo de configuração copy .env.example .env # 4. Gerar a chave de segurança da aplicação php artisan key:generate
Editar o arquivo .env:
Abra o .env com o Bloco de Notas e ajuste as linhas abaixo:
APP_NAME="OXINI Acabamentos" APP_URL=http://oxini.test # Opção 1 — SQLite (mais simples, recomendado para 1 PC) DB_CONNECTION=sqlite # Opção 2 — MySQL (recomendado para uso em rede) # DB_CONNECTION=mysql # DB_HOST=127.0.0.1 # DB_PORT=3306 # DB_DATABASE=oxini # DB_USERNAME=root # DB_PASSWORD=
SQLite ou MySQL?
Use SQLite se o sistema rodar em apenas um computador — é mais simples e não precisa de servidor de banco. Use MySQL se vários computadores acessarem o sistema em rede — crie o banco pelo HeidiSQL antes (já vem instalado no Laragon).
6
Criar o Banco de Dados
Executar as migrations e popular os dados iniciais
# Criar todas as tabelas e inserir dados iniciais php artisan migrate --seed # Criar o link para arquivos de upload (logos, imagens) php artisan storage:link
Dados criados automaticamente pelo seeder
Usuário administrador padrão, categorias da tabela de valores (Pessoa Física, Pessoa Jurídica, Kit Box, Ferragens, Puxadores, Acessórios, Inox, Latão, Zamak) e configuração inicial da empresa OXINI.
7
Primeiro Acesso
Entrar no sistema e realizar as configurações iniciais
1
Iniciar o Laragon
Abra o Laragon e clique em Start All.
2
Abrir no navegador
Acesse: http://oxini.test
3
Fazer login com as credenciais abaixo
Use o acesso administrador criado automaticamente pelo seeder.
Credenciais de Acesso — Administrador
admin@oxini.com.br
admin123
Altere a senha no primeiro acesso
Após entrar, acesse Configurações → Usuários e troque a senha padrão imediatamente por uma senha segura.
Configurações iniciais recomendadas após o login:
- →Acesse Configurações → Dados da Empresa — preencha nome, CNPJ, endereço, telefone e faça upload do logotipo
- →Acesse Cadastros → Tabela de Valores — cadastre seus produtos e serviços com preços
- →Acesse Configurações → Usuários — crie os usuários operadores e visualizadores
- →Acesse Cadastros → Clientes — comece a cadastrar seus clientes
- →Acesse Produção → Ordens de Serviço — crie a primeira OS de teste
8
Checklist Final
Confirme que todos os passos foram concluídos
| # | Ação | Resultado Esperado | OK? |
|---|---|---|---|
| 1 | Laragon instalado e rodando | Ícone verde na bandeja do sistema | ☐ |
| 2 | PHP 8.2+ selecionado no Laragon | Versão correta ativa | ☐ |
| 3 | Composer instalado | composer --version funciona | ☐ |
| 4 | Pasta oxini em C:\laragon\www\ | Arquivos do projeto presentes | ☐ |
| 5 | composer install executado | Pasta vendor/ criada | ☐ |
| 6 | Arquivo .env configurado | DB e APP_KEY preenchidos | ☐ |
| 7 | php artisan migrate --seed | Tabelas e dados criados | ☐ |
| 8 | php artisan storage:link | Link de storage criado | ☐ |
| 9 | Acesso em http://oxini.test | Tela de login aparece | ☐ |
| 10 | Login com admin@oxini.com.br | Dashboard carrega normalmente | ☐ |
| 11 | Senha do admin alterada | Senha padrão substituída | ☐ |
| 12 | Dados da empresa preenchidos | Logo e informações no PDF | ☐ |
Sistema pronto para uso!
Se todos os itens estão marcados, o OXINI Acabamentos está instalado e operacional. Em caso de dúvidas ou erros durante a instalação, entre em contato com o suporte técnico.