Fix script paths and move assets to public/ folder for Vite build compatibility
This commit is contained in:
223
public/docs/README.md
Normal file
223
public/docs/README.md
Normal file
@@ -0,0 +1,223 @@
|
||||
# 🏗️ AÇO CALC PRO v7.5
|
||||
|
||||
Plataforma profissional de cálculos de engenharia estrutural com base de dados de materiais brasileiros.
|
||||
|
||||
## ⚠️ IMPORTANTE: Servidor Web Necessário
|
||||
|
||||
**NÃO** abra `index.html` diretamente no navegador!
|
||||
|
||||
Você **PRECISA** usar um servidor web local devido à política CORS.
|
||||
|
||||
### 🚀 Iniciar Servidor Local
|
||||
|
||||
**Opção 1: Python (Mais Fácil)**
|
||||
```bash
|
||||
# Windows: Duplo clique em server.bat
|
||||
# Ou execute:
|
||||
python server.py
|
||||
```
|
||||
|
||||
**Opção 2: Python Simples**
|
||||
```bash
|
||||
python -m http.server 8000
|
||||
```
|
||||
|
||||
**Opção 3: Node.js**
|
||||
```bash
|
||||
npx http-server -p 8000
|
||||
```
|
||||
|
||||
Depois acesse: **http://localhost:8000**
|
||||
|
||||
📖 **Guia completo**: Veja `INICIAR-SERVIDOR.md`
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Deploy
|
||||
|
||||
### Vercel (Recomendado)
|
||||
|
||||
1. Instale o Vercel CLI:
|
||||
```bash
|
||||
npm install -g vercel
|
||||
```
|
||||
|
||||
2. Faça login:
|
||||
```bash
|
||||
vercel login
|
||||
```
|
||||
|
||||
3. Deploy:
|
||||
```bash
|
||||
vercel
|
||||
```
|
||||
|
||||
4. Para produção:
|
||||
```bash
|
||||
vercel --prod
|
||||
```
|
||||
|
||||
### Netlify
|
||||
|
||||
1. Instale o Netlify CLI:
|
||||
```bash
|
||||
npm install -g netlify-cli
|
||||
```
|
||||
|
||||
2. Faça login:
|
||||
```bash
|
||||
netlify login
|
||||
```
|
||||
|
||||
3. Deploy:
|
||||
```bash
|
||||
netlify deploy
|
||||
```
|
||||
|
||||
4. Para produção:
|
||||
```bash
|
||||
netlify deploy --prod
|
||||
```
|
||||
|
||||
### Deploy Manual
|
||||
|
||||
#### Via Interface Web:
|
||||
|
||||
**Vercel:**
|
||||
1. Acesse [vercel.com](https://vercel.com)
|
||||
2. Clique em "New Project"
|
||||
3. Importe este repositório
|
||||
4. Deploy automático!
|
||||
|
||||
**Netlify:**
|
||||
1. Acesse [netlify.com](https://netlify.com)
|
||||
2. Arraste a pasta do projeto para o site
|
||||
3. Deploy automático!
|
||||
|
||||
## 📁 Estrutura do Projeto
|
||||
|
||||
```
|
||||
/
|
||||
├── index.html # Página principal
|
||||
├── style.css # Estilos
|
||||
├── app.js # Lógica principal
|
||||
├── calculations.js # Cálculos de engenharia
|
||||
├── js/ # Módulos JavaScript
|
||||
│ ├── database/ # Sistema de cache
|
||||
│ ├── sections/ # Seções do app
|
||||
│ ├── ui/ # Componentes UI
|
||||
│ └── utils/ # Utilitários
|
||||
├── BD/ # Base de dados (CSVs)
|
||||
│ └── perfis/ # Perfis estruturais
|
||||
├── vercel.json # Config Vercel
|
||||
└── netlify.toml # Config Netlify
|
||||
```
|
||||
|
||||
## 🔧 Tecnologias
|
||||
|
||||
- **HTML5** - Estrutura
|
||||
- **CSS3** - Estilos (design system próprio)
|
||||
- **JavaScript ES6+** - Lógica (vanilla, sem frameworks)
|
||||
- **Chart.js** - Gráficos
|
||||
- **CSV** - Base de dados
|
||||
|
||||
## ✨ Funcionalidades
|
||||
|
||||
### Materiais
|
||||
- ✅ Cálculo de CEV (Carbon Equivalent Value)
|
||||
- ✅ Seletor de aços
|
||||
- ✅ Equivalências internacionais
|
||||
- ✅ Comparativo de materiais
|
||||
- ✅ **Catálogo de Perfis** (39 cantoneiras + outros)
|
||||
|
||||
### Conexões
|
||||
- ✅ Parafusos em cisalhamento
|
||||
- ✅ Layout de furação
|
||||
- ✅ Parafuso vs Solda
|
||||
|
||||
### Soldagem
|
||||
- ✅ Pré-aquecimento
|
||||
- ✅ Solda de filete
|
||||
- ✅ Aporte térmico
|
||||
- ✅ Consumo de eletrodos
|
||||
|
||||
### Ensaios
|
||||
- ✅ Conversão de dureza
|
||||
- ✅ Curvas de Charpy
|
||||
- ✅ Checklist de certificados
|
||||
- ✅ Ultrassom
|
||||
|
||||
### Pintura
|
||||
- ✅ Cálculo de área
|
||||
- ✅ Consumo de tinta
|
||||
- ✅ Galvanização
|
||||
- ✅ Custos
|
||||
|
||||
### Orçamento
|
||||
- ✅ Orçamento detalhado
|
||||
- ✅ Peso e içamento
|
||||
- ✅ Referências técnicas
|
||||
|
||||
## 🗄️ Sistema de Cache
|
||||
|
||||
O aplicativo usa um sistema de cache inteligente para os dados dos perfis:
|
||||
|
||||
- **localStorage** para cache local
|
||||
- **TTL de 24 horas** para atualização automática
|
||||
- **Versionamento** para detectar mudanças
|
||||
- **Painel administrativo** para gerenciar dados
|
||||
|
||||
### Acessar Painel Admin:
|
||||
|
||||
- Botão 🗄️ Dados no header
|
||||
- Atalho: `Ctrl + Shift + D`
|
||||
- Console: `abrirPainelDados()`
|
||||
|
||||
## 🐛 Troubleshooting
|
||||
|
||||
### Dados não aparecem?
|
||||
|
||||
1. Clique no botão "🔄 Carregar Dados" na tabela
|
||||
2. Ou abra o console (F12) e execute:
|
||||
```javascript
|
||||
forcarCarregamentoCantoneiras()
|
||||
```
|
||||
|
||||
### Limpar cache?
|
||||
|
||||
```javascript
|
||||
localStorage.clear()
|
||||
location.reload()
|
||||
```
|
||||
|
||||
### Verificar status?
|
||||
|
||||
```javascript
|
||||
window.dataManager.getCacheStats()
|
||||
```
|
||||
|
||||
## 📊 Performance
|
||||
|
||||
- **Primeira carga**: ~500ms
|
||||
- **Com cache**: ~50ms (10x mais rápido)
|
||||
- **Filtros**: ~10ms (instantâneo)
|
||||
|
||||
## 🌐 Compatibilidade
|
||||
|
||||
- ✅ Chrome 60+
|
||||
- ✅ Firefox 60+
|
||||
- ✅ Safari 12+
|
||||
- ✅ Edge 79+
|
||||
- ✅ Mobile (todos os navegadores modernos)
|
||||
|
||||
## 📝 Licença
|
||||
|
||||
© 2025 AÇO CALC PRO - Professional Edition
|
||||
|
||||
## 🤝 Suporte
|
||||
|
||||
Para suporte técnico ou dúvidas, consulte a documentação completa nos arquivos `.md` do projeto.
|
||||
|
||||
---
|
||||
|
||||
**Desenvolvido com ❤️ para engenheiros estruturais brasileiros**
|
||||
Reference in New Issue
Block a user