PlatformSistemas

Sistema de gestão integrada desenvolvido em React + TypeScript + Vite.

🚀 Repositório

• Remote: https://git.itguys.com.br/itguys_dev/Workspace
• Branch: frontend_React

📋 Índice

• Início Rápido
• Scripts Disponíveis
• Git Auto-Sync
• Estrutura do Projeto
• Tecnologias
• Desenvolvimento

🎯 Início Rápido

Pré-requisitos

• Node.js (v18 ou superior)
• npm ou yarn
• Git

Instalação

# Clone o repositório
git clone https://git.itguys.com.br/itguys_dev/Workspace.git
cd PlatformSistemas

# Instale as dependências
npm install

# Configure as variáveis de ambiente
cp .env.example .env
# Edite o arquivo .env com suas configurações

# Inicie o servidor de desenvolvimento
npm run dev

📜 Scripts Disponíveis

# Desenvolvimento
npm run dev              # Inicia o servidor de desenvolvimento

# Build
npm run build            # Gera build de produção
npm run preview          # Preview do build de produção

# Qualidade de Código
npm run lint             # Executa ESLint

# Git Auto-Sync
npm run git:sync         # Inicia monitoramento Git com build automático
npm run git:sync:nobuild # Inicia monitoramento Git sem build automático

# Agentes de Automação
npm run agent:git:commit      # Commit automático por dia
npm run agent:git:commit:dry  # Dry-run do commit automático
npm run agent:docs:update     # Atualização automática de documentação
npm run agent:check           # Verificação do orchestrator

🔄 Git Auto-Sync

O Git Auto-Sync é um sistema de automação que monitora alterações no projeto e realiza commits/push automáticos.

Como Usar

# Com build automático (recomendado para produção)
npm run git:sync

# Sem build automático (mais rápido para desenvolvimento)
npm run git:sync:nobuild

Características

• ✅ Monitoramento em tempo real de alterações
• ✅ Debounce de 10 segundos (agrupa alterações)
• ✅ Build automático antes de cada commit
• ✅ Filtragem inteligente de arquivos
• ✅ Mensagens de commit descritivas

Documentação Completa

Para mais detalhes, consulte GIT-AUTO-SYNC.md

📁 Estrutura do Projeto

PlatformSistemas/
├── src/
│   ├── components/      # Componentes reutilizáveis
│   │   ├── shared/      # Componentes compartilhados
│   │   └── ui/          # Componentes Shadcn UI
│   ├── features/        # Features do sistema (Domain-Driven)
│   │   ├── auth/        # Autenticação
│   │   ├── financeiro-cnab/  # CNAB - Remessas e Pagamentos
│   │   ├── financeiro-v2/    # Financeiro V2 - Contas a Receber/Pagar
│   │   ├── fleet-v2/    # Gestão de Frota V2
│   │   ├── gr/          # Gestão de Registros (GR)
│   │   ├── rh/          # Recursos Humanos
│   │   ├── workspace/   # Workspace Financeiro
│   │   ├── autolab/     # AutoLab - Gestão de Laboratório
│   │   ├── dev-tools/   # Ferramentas de Desenvolvimento
│   │   └── portal/      # Portal Principal
│   ├── services/        # Serviços e APIs
│   ├── hooks/           # Custom hooks globais
│   ├── utils/           # Utilitários
│   └── index.css        # Estilos globais
├── docs/                # Documentação do projeto
├── .agent/              # Agentes de automação
├── public/              # Arquivos públicos
├── .env                 # Variáveis de ambiente
├── git-auto-sync.ps1    # Script de automação Git
└── package.json         # Dependências e scripts

🎯 Módulos e Features

💰 Financeiro

• financeiro-cnab: Sistema completo de CNAB para geração de remessas, gestão de favorecidos e pagamentos
• financeiro-v2: Módulo avançado de contas a receber/pagar, conciliação e fluxo de caixa
• workspace: Workspace financeiro com gestão de receitas, despesas e conciliação

🚛 Frota

• fleet-v2: Gestão completa de frota com dashboard, manutenções, abastecimentos e monitoramento

👥 Recursos Humanos

• rh: Sistema de RH com ponto eletrônico, gestão de funcionários, benefícios e cálculos

📋 Gestão de Registros

• gr: Sistema de gestão de registros com Kanban, cadastro de motoristas e contratos

🔬 AutoLab

• autolab: Gestão de laboratório com estoque, vendas e configurações

🛠️ Desenvolvimento

• dev-tools: Playground para testes de componentes e debug

🛠️ Tecnologias

Core

• React 19 - Biblioteca UI
• TypeScript - Superset JavaScript
• Vite - Build tool e dev server

UI/UX

• TailwindCSS - Framework CSS
• Radix UI - Componentes acessíveis
• Framer Motion - Animações
• Lucide React - Ícones

Estado e Formulários

• Zustand - Gerenciamento de estado
• React Hook Form - Formulários
• Zod - Validação de schemas

Roteamento e Requisições

• React Router DOM - Roteamento
• Axios - Cliente HTTP

Gráficos

• Recharts - Biblioteca de gráficos

💻 Desenvolvimento

Variáveis de Ambiente

Copie .env.example para .env e configure:

VITE_API_URL=https://dev.workspace.itguys.com.br/api
VITE_APP_NAME=PlatformSistemas

Padrões de Código

• Componentes: Use componentes funcionais com hooks
• Tipagem: Sempre utilize TypeScript
• Estilos: Prefira TailwindCSS
• Estado: Use Zustand para estado global
• Formulários: Use React Hook Form + Zod

ESLint

O projeto usa ESLint para garantir qualidade de código:

npm run lint

Estrutura de Componentes

// Exemplo de componente
import { useState } from 'react'
import { Button } from '@/components/ui/button'

interface MyComponentProps {
  title: string
  onAction?: () => void
}

export function MyComponent({ title, onAction }: MyComponentProps) {
  const [state, setState] = useState(false)
  
  return (
    <div className="p-4">
      <h2 className="text-xl font-bold">{title}</h2>
      <Button onClick={onAction}>Ação</Button>
    </div>
  )
}

🔐 Segurança

• Nunca commite arquivos .env (já está no .gitignore)
• Use variáveis de ambiente para dados sensíveis
• Mantenha dependências atualizadas

📝 Documentação Adicional

• Git Auto-Sync - Documentação completa do sistema de automação
• API Report - Relatório de APIs utilizadas
• Regras de Desenvolvimento - Padrões e regras do projeto
• AI Rules - Debug Components - Regras para componentes versionados
• Teste Formulário GR - Documentação de testes do módulo GR

🤝 Contribuindo

1. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
2. Faça commit das suas alterações (git commit -m 'Adiciona MinhaFeature')
3. Push para a branch (git push origin feature/MinhaFeature)
4. Abra um Pull Request

Ou simplesmente use o Git Auto-Sync para automação completa! 🚀

📄 Licença

Este projeto é propriedade da ITGuys.

---

Desenvolvido com ❤️ pela equipe ITGuys