docs: criar README.md principal com changelog integrado

2025-11-27 19:29:09 -03:00
parent 841bf061aa
commit 0b645a3ffa
1 changed files with 114 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,114 @@
+# CMS OCCTO Engenharia v1.1
+
+Sistema de gerenciamento de conteúdo (CMS) desenvolvido para a OCCTO Engenharia.
+
+## 📋 Visão Geral
+
+CMS completo para gerenciamento do site institucional da OCCTO Engenharia, empresa especializada em engenharia veicular, mecânica e segurança do trabalho.
+
+## 🚀 Tecnologias
+
+- **Frontend**: Next.js 15 (App Router)
+- **Estilização**: Tailwind CSS 4
+- **Banco de Dados**: PostgreSQL 16 + Prisma ORM
+- **Storage**: MinIO (S3-compatible)
+- **Autenticação**: JWT com bcryptjs
+- **Deploy**: Docker Compose + Dokploy
+
+## 📁 Estrutura do Projeto
+
+```
+├── frontend/                 # Aplicação Next.js
+│   ├── src/
+│   │   ├── app/
+│   │   │   ├── admin/       # Painel administrativo
+│   │   │   ├── api/         # API Routes
+│   │   │   ├── (public)/    # Páginas públicas
+│   │   │   └── [locale]/    # Páginas com i18n
+│   │   ├── components/      # Componentes reutilizáveis
+│   │   ├── contexts/        # Contexts React
+│   │   └── lib/             # Utilitários
+│   └── prisma/              # Schema e migrations
+├── docs/                     # Documentação
+└── docker-compose.yml        # Configuração Docker
+```
+
+---
+
+## 📦 Changelog
+
+### [CMS 1.1] - 27/11/2025
+
+#### 🔧 Correções
+- Tipagem de `params` para Next.js 15 nas API routes
+
+#### 📊 Dashboard Admin
+- Dados dinâmicos em tempo real (Projetos, Mensagens, Serviços)
+- Últimas 5 mensagens com indicador de não lida
+- Últimos 5 projetos com imagem e status
+- Cards clicáveis com navegação
+
+#### 🛠️ Módulo de Serviços (CRUD Completo)
+
+| Página | Funcionalidades |
+|--------|-----------------|
+| Lista | Filtros, busca, editar/excluir |
+| Novo | Seletor visual de 70+ ícones |
+| Editar | Carrega e atualiza dados |
+| Público | Dados dinâmicos com fallback |
+
+#### 📁 Módulo de Projetos (Melhorias)
+
+| Página | Funcionalidades |
+|--------|-----------------|
+| Lista | Filtros por categoria/status, busca |
+| Editar | Upload de capa e galeria (até 8) |
+
+#### 🎨 UX/UI
+- Seletor de ícones em galeria com busca
+- Loading states e toasts
+- Modal de confirmação para exclusões
+
+---
+
+### [CMS 1.0] - 25/11/2025
+
+#### ✨ Funcionalidades Iniciais
+- Sistema de autenticação com JWT
+- CRUD de Projetos com upload de imagens
+- CRUD de Contatos/Mensagens
+- Gerenciamento de conteúdo de páginas
+- Sistema de leads
+- Suporte a múltiplos idiomas (PT, EN, ES)
+- Tema claro/escuro
+- Upload de arquivos via MinIO
+
+---
+
+## 🔧 Instalação
+
+```bash
+# Clonar repositório
+git clone https://git.stackbyte.cloud/erik/octto-engenharia.git
+
+# Instalar dependências
+cd frontend && npm install
+
+# Configurar variáveis de ambiente
+cp .env.example .env
+
+# Executar migrations
+npx prisma migrate dev
+
+# Iniciar desenvolvimento
+npm run dev
+```
+
+## 🌐 Deploy
+
+Consulte o arquivo [README-DEPLOY.md](./README-DEPLOY.md) para instruções de deploy.
+
+---
+
+**Branch Atual**: `cms-1.1`  
+**Status**: ✅ Produção