From 6e8a6fe890419f49ddffcbc2a27a65db527f24c3 Mon Sep 17 00:00:00 2001 From: rever-tecnologia Date: Tue, 16 Dec 2025 09:45:09 -0300 Subject: [PATCH] feat(checklist): exibe descricao do template e do item no ticket MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Adiciona campo templateDescription ao schema do checklist - Copia descricao do template ao aplicar checklist no ticket - Exibe ambas descricoes na visualizacao do ticket (template em italico) - Adiciona documentacao de desenvolvimento local (docs/LOCAL-DEV.md) - Corrige prisma-client.mjs para usar PostgreSQL em vez de SQLite πŸ€– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- .env.example | 5 +- convex/schema.ts | 1 + convex/ticketChecklist.ts | 3 + docs/LOCAL-DEV.md | 166 ++++++++++++++++++ docs/README.md | 1 + scripts/utils/prisma-client.mjs | 63 ++----- .../tickets/ticket-checklist-card.tsx | 43 +++-- src/lib/schemas/ticket.ts | 1 + 8 files changed, 212 insertions(+), 71 deletions(-) create mode 100644 docs/LOCAL-DEV.md diff --git a/.env.example b/.env.example index 1f0e247..739bb8b 100644 --- a/.env.example +++ b/.env.example @@ -19,8 +19,9 @@ REPORTS_CRON_SECRET=reports-cron-secret # DiretΓ³rio para arquivamento local de tickets (JSONL/backup) ARCHIVE_DIR=./archives -# PostgreSQL database -# Para desenvolvimento local, use Docker: docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=dev -e POSTGRES_DB=sistema_chamados postgres:18 +# PostgreSQL database (versao 18) +# Para desenvolvimento local, use Docker: +# docker run -d --name postgres-chamados -p 5432:5432 -e POSTGRES_PASSWORD=dev -e POSTGRES_DB=sistema_chamados postgres:18 DATABASE_URL=postgresql://postgres:dev@localhost:5432/sistema_chamados # SMTP Configuration (production values in docs/SMTP.md) diff --git a/convex/schema.ts b/convex/schema.ts index 7409d2a..2126fb6 100644 --- a/convex/schema.ts +++ b/convex/schema.ts @@ -322,6 +322,7 @@ export default defineSchema({ required: v.optional(v.boolean()), templateId: v.optional(v.id("ticketChecklistTemplates")), templateItemId: v.optional(v.string()), + templateDescription: v.optional(v.string()), // Descricao do template (copiada ao aplicar) createdAt: v.optional(v.number()), createdBy: v.optional(v.id("users")), doneAt: v.optional(v.number()), diff --git a/convex/ticketChecklist.ts b/convex/ticketChecklist.ts index dd3e14f..31bbb8d 100644 --- a/convex/ticketChecklist.ts +++ b/convex/ticketChecklist.ts @@ -13,6 +13,7 @@ export type TicketChecklistItem = { required?: boolean templateId?: Id<"ticketChecklistTemplates"> templateItemId?: string + templateDescription?: string // Descricao do template (copiada ao aplicar) createdAt?: number createdBy?: Id<"users"> doneAt?: number @@ -30,6 +31,7 @@ export type TicketChecklistTemplateItem = { export type TicketChecklistTemplateLike = { _id: Id<"ticketChecklistTemplates"> + description?: string items: TicketChecklistTemplateItem[] } @@ -79,6 +81,7 @@ export function applyChecklistTemplateToItems( required: typeof tplItem.required === "boolean" ? tplItem.required : true, templateId: template._id, templateItemId, + templateDescription: template.description, createdAt: now, createdBy: options.actorId, }) diff --git a/docs/LOCAL-DEV.md b/docs/LOCAL-DEV.md new file mode 100644 index 0000000..00b4e34 --- /dev/null +++ b/docs/LOCAL-DEV.md @@ -0,0 +1,166 @@ +# Desenvolvimento Local + +Guia para rodar o projeto localmente conectando aos dados de producao. + +## Pre-requisitos + +- [Bun](https://bun.sh/) 1.3+ +- [Docker](https://www.docker.com/) (para PostgreSQL) +- Node.js 20+ (opcional, usado pelo tsx) + +## 1. Subir o PostgreSQL + +O sistema usa PostgreSQL para autenticacao (Better Auth). Os dados de tickets ficam no Convex. + +```bash +docker run -d \ + --name postgres-chamados \ + -p 5432:5432 \ + -e POSTGRES_PASSWORD=dev \ + -e POSTGRES_DB=sistema_chamados \ + postgres:18 +``` + +Para verificar se esta rodando: + +```bash +docker ps | grep postgres-chamados +``` + +Para parar/iniciar posteriormente: + +```bash +docker stop postgres-chamados +docker start postgres-chamados +``` + +## 2. Configurar variaveis de ambiente + +O arquivo `.env.local` ja vem configurado para desenvolvimento local apontando para o Convex de producao: + +```env +NODE_ENV=development + +# URLs locais +NEXT_PUBLIC_APP_URL=http://localhost:3000 +BETTER_AUTH_URL=http://localhost:3000 + +# Convex de producao (dados reais) +NEXT_PUBLIC_CONVEX_URL=https://convex.esdrasrenan.com.br +CONVEX_INTERNAL_URL=https://convex.esdrasrenan.com.br + +# PostgreSQL local (apenas autenticacao) +DATABASE_URL=postgresql://postgres:dev@localhost:5432/sistema_chamados +``` + +## 3. Instalar dependencias + +```bash +bun install +``` + +## 4. Gerar cliente Prisma e aplicar schema + +```bash +bun run prisma:generate +bunx prisma db push +``` + +## 5. Criar usuarios de desenvolvimento + +O seed cria usuarios locais para autenticacao: + +```bash +DATABASE_URL="postgresql://postgres:dev@localhost:5432/sistema_chamados" bun tsx scripts/seed-auth.mjs +``` + +### Credenciais padrao + +| Usuario | Email | Senha | Role | +|---------------|----------------------|------------|-------| +| Administrador | `admin@sistema.dev` | `admin123` | admin | +| Agentes | `*@rever.com.br` | `agent123` | agent | + +## 6. Iniciar o servidor de desenvolvimento + +```bash +bun run dev:bun +``` + +Acesse: http://localhost:3000 + +## Arquitetura Local vs Producao + +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ DESENVOLVIMENTO LOCAL β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ β”‚ +β”‚ localhost:3000 (Next.js) β”‚ +β”‚ β”‚ β”‚ +β”‚ β”œβ”€β”€β–Ί PostgreSQL local (porta 5432) β”‚ +β”‚ β”‚ └── Autenticacao (Better Auth) β”‚ +β”‚ β”‚ └── Usuarios, sessoes, contas β”‚ +β”‚ β”‚ β”‚ +β”‚ └──► convex.esdrasrenan.com.br (remoto) β”‚ +β”‚ └── Dados de producao β”‚ +β”‚ └── Tickets, empresas, filas, etc. β”‚ +β”‚ β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +## Comandos uteis + +| Comando | Descricao | +|---------|-----------| +| `bun run dev:bun` | Inicia servidor de desenvolvimento com Turbopack | +| `bun run build:bun` | Build de producao | +| `bun run lint` | Verificar codigo com ESLint | +| `bun test` | Rodar testes | +| `bunx prisma studio` | Interface visual do banco de dados | + +## Solucao de problemas + +### Erro de conexao com PostgreSQL + +``` +Error: P1001: Can't reach database server at localhost:5432 +``` + +**Solucao:** Verifique se o container Docker esta rodando: + +```bash +docker start postgres-chamados +``` + +### Erro de migracao (tipo DATETIME) + +Se aparecer erro sobre tipo `DATETIME` ao rodar migrations, use `db push` em vez de `migrate`: + +```bash +bunx prisma db push --accept-data-loss +``` + +### Usuario nao consegue logar + +Os usuarios de autenticacao ficam no PostgreSQL local, nao no Convex. Rode o seed novamente: + +```bash +DATABASE_URL="postgresql://postgres:dev@localhost:5432/sistema_chamados" bun tsx scripts/seed-auth.mjs +``` + +### Limpar banco e recriar + +```bash +docker stop postgres-chamados +docker rm postgres-chamados +docker run -d --name postgres-chamados -p 5432:5432 -e POSTGRES_PASSWORD=dev -e POSTGRES_DB=sistema_chamados postgres:18 +bunx prisma db push +DATABASE_URL="postgresql://postgres:dev@localhost:5432/sistema_chamados" bun tsx scripts/seed-auth.mjs +``` + +## Proximos passos + +- Para deploy em producao, consulte `docs/OPERACAO-PRODUCAO.md` +- Para configuracao de SMTP, consulte `docs/SMTP.md` +- Para testes automatizados, consulte `docs/testes-vitest.md` diff --git a/docs/README.md b/docs/README.md index 85c2a80..f9e7433 100644 --- a/docs/README.md +++ b/docs/README.md @@ -3,6 +3,7 @@ Este Γ­ndice consolida a documentação viva e move conteΓΊdos histΓ³ricos para um arquivo. O objetivo Γ© simplificar o onboarding e a operação. ## VisΓ£o Geral +- **Desenvolvimento local**: `docs/LOCAL-DEV.md` (setup rapido para rodar localmente) - Operaçáes (produção): `docs/operations.md` - Guia de desenvolvimento: `docs/DEV.md` - Desktop (Tauri): diff --git a/scripts/utils/prisma-client.mjs b/scripts/utils/prisma-client.mjs index af2fd9b..515356c 100644 --- a/scripts/utils/prisma-client.mjs +++ b/scripts/utils/prisma-client.mjs @@ -1,63 +1,24 @@ -import path from "node:path" +import pg from "pg" // NOTE: This helper imports the generated Prisma client from TypeScript files. // Run scripts that rely on it via a transpiling runner (e.g. `tsx` or Bun). import { PrismaClient } from "../../src/generated/prisma/client.ts" -import { PrismaBetterSqlite3 } from "@prisma/adapter-better-sqlite3" +import { PrismaPg } from "@prisma/adapter-pg" -const PROJECT_ROOT = process.cwd() -const PRISMA_DIR = path.join(PROJECT_ROOT, "prisma") - -function resolveFileUrl(url) { - if (!url.startsWith("file:")) { - return url - } - - const filePath = url.slice("file:".length) - - if (filePath.startsWith("//")) { - return url - } - - if (path.isAbsolute(filePath)) { - return `file:${path.normalize(filePath)}` - } - - const normalized = path.normalize(filePath) - const prismaPrefix = `prisma${path.sep}` - const relativeToPrisma = normalized.startsWith(prismaPrefix) - ? normalized.slice(prismaPrefix.length) - : normalized - - const absolutePath = path.resolve(PRISMA_DIR, relativeToPrisma) - - if (!absolutePath.startsWith(PROJECT_ROOT)) { - throw new Error(`DATABASE_URL path escapes project directory: ${filePath}`) - } - - return `file:${absolutePath}` -} - -function normalizeDatasourceUrl(envUrl) { - const trimmed = envUrl?.trim() - if (trimmed) { - return resolveFileUrl(trimmed) - } - - if (process.env.NODE_ENV === "production") { - return "file:/app/data/db.sqlite" - } - - return resolveFileUrl("file:./db.dev.sqlite") -} +const { Pool } = pg export function createPrismaClient() { - const resolvedDatabaseUrl = normalizeDatasourceUrl(process.env.DATABASE_URL) - process.env.DATABASE_URL = resolvedDatabaseUrl + const databaseUrl = process.env.DATABASE_URL - const adapter = new PrismaBetterSqlite3({ - url: resolvedDatabaseUrl, + if (!databaseUrl) { + throw new Error("DATABASE_URL environment variable is required") + } + + const pool = new Pool({ + connectionString: databaseUrl, }) + const adapter = new PrismaPg(pool) + return new PrismaClient({ adapter }) } diff --git a/src/components/tickets/ticket-checklist-card.tsx b/src/components/tickets/ticket-checklist-card.tsx index 328d728..4c5ddab 100644 --- a/src/components/tickets/ticket-checklist-card.tsx +++ b/src/components/tickets/ticket-checklist-card.tsx @@ -369,24 +369,17 @@ export function TicketChecklistCard({ ) : ( - <> -

{ - if (!canEdit || isResolved) return - setEditingId(item.id) - setEditingText(item.text) - }} - > - {item.text} -

- {item.description && ( -

- {item.description} -

- )} - +

{ + if (!canEdit || isResolved) return + setEditingId(item.id) + setEditingText(item.text) + }} + > + {item.text} +

)} {isQuestion && options.length > 0 && ( @@ -446,6 +439,20 @@ export function TicketChecklistCard({ ) : null} + {(item.templateDescription || item.description) && ( +
+ {item.templateDescription && ( +

+ {item.templateDescription} +

+ )} + {item.description && ( +

+ {item.description} +

+ )} +
+ )} diff --git a/src/lib/schemas/ticket.ts b/src/lib/schemas/ticket.ts index 35df5a6..d294584 100644 --- a/src/lib/schemas/ticket.ts +++ b/src/lib/schemas/ticket.ts @@ -148,6 +148,7 @@ export const ticketChecklistItemSchema = z.object({ required: z.boolean().optional(), templateId: z.string().optional(), templateItemId: z.string().optional(), + templateDescription: z.string().optional(), createdAt: z.number().optional(), createdBy: z.string().optional(), doneAt: z.number().optional(),