163 lines
5.1 KiB
Markdown
163 lines
5.1 KiB
Markdown
# 📁 ORGANIZAÇÃO DO PROJETO
|
|
|
|
## 🎯 Estrutura Limpa e Organizada
|
|
|
|
O repositório foi reorganizado para manter apenas os documentos **atuais e relevantes** na raiz, movendo todo o histórico para uma pasta dedicada.
|
|
|
|
---
|
|
|
|
## 📋 Documentos na Raiz (Atuais)
|
|
|
|
### 📖 Documentação Principal:
|
|
- **`README.md`** - Documentação principal do projeto
|
|
- **`ORGANIZACAO-PROJETO.md`** - Este documento (organização)
|
|
|
|
### 🔧 Implementações Atuais:
|
|
- **`ABAS-INTERNAS-IMPLEMENTADAS.md`** - Implementação das 5 abas dos 4 perfis restantes
|
|
- **`CORRECAO-DEFINITIVA-ACCORDION.md`** - Correção do accordion do sidebar
|
|
|
|
---
|
|
|
|
## 📦 Documentos Históricos
|
|
|
|
### 📂 Pasta: `docs-historicos/`
|
|
|
|
Contém **45+ documentos** históricos organizados por categoria:
|
|
|
|
- 🔧 **Implementações e Correções** (8 docs)
|
|
- 🐛 **Debug e Correções** (8 docs)
|
|
- 📊 **Análises e Melhorias** (3 docs)
|
|
- 🚀 **Deploy e Testes** (8 docs)
|
|
- 🏗️ **Sistemas e Arquitetura** (8 docs)
|
|
- 🔧 **Soluções Específicas** (7 docs)
|
|
- 📋 **Resumos e Checklists** (4 docs)
|
|
- 🎯 **Funcionalidades Específicas** (4 docs)
|
|
|
|
**Ver:** `docs-historicos/README-DOCS-HISTORICOS.md` para índice completo.
|
|
|
|
---
|
|
|
|
## 🗂️ Estrutura do Projeto
|
|
|
|
```
|
|
AÇO CALC PRO/
|
|
├── 📖 README.md # Documentação principal
|
|
├── 📁 ORGANIZACAO-PROJETO.md # Este documento
|
|
├── 🔧 ABAS-INTERNAS-IMPLEMENTADAS.md # Implementação atual
|
|
├── 🔧 CORRECAO-DEFINITIVA-ACCORDION.md # Correção atual
|
|
├── 📂 docs-historicos/ # Documentos históricos (45+ arquivos)
|
|
│ └── 📖 README-DOCS-HISTORICOS.md # Índice dos históricos
|
|
├── 🌐 index.html # Interface principal
|
|
├── ⚙️ app.js # Aplicação principal
|
|
├── 🎨 style.css # Estilos
|
|
├── 🧮 calculations.js # Cálculos
|
|
├── 📊 BD/ # Base de dados CSV
|
|
├── 🔧 js/ # Scripts JavaScript
|
|
├── 🎨 css/ # Estilos adicionais
|
|
├── 📁 assets/ # Recursos
|
|
├── 🔧 ORIGINAL/ # Backup original
|
|
├── 🐍 converter-csv-auto.py # Conversor CSV
|
|
├── 🐍 server.py # Servidor Python
|
|
├── 🚀 INICIAR.bat # Script de inicialização
|
|
└── ⚙️ Arquivos de configuração # package.json, vercel.json, etc.
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 Benefícios da Organização
|
|
|
|
### ✅ **Raiz Limpa:**
|
|
- Apenas 4 documentos markdown na raiz
|
|
- Foco nos documentos atuais e relevantes
|
|
- Navegação mais fácil
|
|
|
|
### ✅ **Histórico Preservado:**
|
|
- 45+ documentos históricos preservados
|
|
- Organizados por categoria
|
|
- Fácil consulta quando necessário
|
|
|
|
### ✅ **Manutenção Simplificada:**
|
|
- Documentos ultrapassados não confundem
|
|
- Atualizações focadas nos arquivos relevantes
|
|
- Estrutura escalável
|
|
|
|
---
|
|
|
|
## 📚 Como Usar
|
|
|
|
### 🔍 **Para Informações Atuais:**
|
|
- Consulte os documentos na **raiz**
|
|
- `README.md` para visão geral
|
|
- `ABAS-INTERNAS-IMPLEMENTADAS.md` para implementações recentes
|
|
|
|
### 🔍 **Para Histórico/Referência:**
|
|
- Acesse `docs-historicos/`
|
|
- Consulte `docs-historicos/README-DOCS-HISTORICOS.md` para índice
|
|
- Busque por tópico específico
|
|
|
|
### 🔍 **Para Desenvolvimento:**
|
|
- Foque nos arquivos de código: `app.js`, `index.html`, `style.css`
|
|
- Use documentos da raiz para contexto atual
|
|
- Consulte históricos apenas se necessário
|
|
|
|
---
|
|
|
|
## 🔄 Manutenção Futura
|
|
|
|
### ✅ **Novos Documentos:**
|
|
- Documentos **atuais e relevantes** → **Raiz**
|
|
- Documentos **históricos/ultrapassados** → **`docs-historicos/`**
|
|
|
|
### ✅ **Atualização de Documentos:**
|
|
- Ao atualizar um documento da raiz, mova a versão antiga para `docs-historicos/`
|
|
- Mantenha apenas a versão mais atual na raiz
|
|
|
|
### ✅ **Limpeza Periódica:**
|
|
- Revise documentos da raiz mensalmente
|
|
- Mova documentos ultrapassados para históricos
|
|
- Mantenha máximo 5-10 documentos na raiz
|
|
|
|
---
|
|
|
|
## 📊 Estatísticas da Organização
|
|
|
|
- **📂 Documentos movidos:** 45+ arquivos
|
|
- **📁 Pasta criada:** `docs-historicos/`
|
|
- **📋 Documentos na raiz:** 4 arquivos
|
|
- **🎯 Redução na raiz:** ~90%
|
|
- **📚 Histórico preservado:** 100%
|
|
|
|
---
|
|
|
|
## ✅ Resultado
|
|
|
|
### **Antes:**
|
|
```
|
|
/ (raiz com 50+ arquivos markdown)
|
|
├── README.md
|
|
├── ACCORDION-REFATORADO.md
|
|
├── ADICIONAR-BOTAO-ADMIN.md
|
|
├── AJUDA-DINAMICA-ABAS.md
|
|
├── ... (45+ outros documentos)
|
|
└── app.js
|
|
```
|
|
|
|
### **Depois:**
|
|
```
|
|
/ (raiz limpa com 4 documentos)
|
|
├── README.md
|
|
├── ORGANIZACAO-PROJETO.md
|
|
├── ABAS-INTERNAS-IMPLEMENTADAS.md
|
|
├── CORRECAO-DEFINITIVA-ACCORDION.md
|
|
├── docs-historicos/ (45+ documentos organizados)
|
|
│ ├── README-DOCS-HISTORICOS.md
|
|
│ ├── ACCORDION-REFATORADO.md
|
|
│ └── ... (todos os históricos)
|
|
└── app.js
|
|
```
|
|
|
|
---
|
|
|
|
**Data de Organização:** 09/11/2025
|
|
**Status:** ✅ **PROJETO ORGANIZADO**
|
|
**Benefício:** Raiz limpa, histórico preservado, navegação simplificada |