docs: criar README.md principal com changelog integrado
This commit is contained in:
114
README.md
Normal file
114
README.md
Normal file
@@ -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
|
||||||
Reference in New Issue
Block a user