From 0b645a3ffa6b908aa641a2bea985bbcf8bcdcfbd Mon Sep 17 00:00:00 2001 From: Erik Date: Thu, 27 Nov 2025 19:29:09 -0300 Subject: [PATCH] docs: criar README.md principal com changelog integrado --- README.md | 114 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 114 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..5912489 --- /dev/null +++ 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