dockergprompt/IMPLEMENTATION_PLAN.md

Plano de Implementação - Sistema de Geração de Prompts

1. Configuração Inicial

• Projeto Laravel 13 criado
• Laravel Boost instalado
• Configurar .env com banco MariaDB
• Instalar Breeze (autenticação)
• Instalar/configurar SbAdmin 2 assets

2. Banco de Dados (Migrations)

• users (Breeze + role: superadmin/user)
• prompt_projects (projetos de criação de prompt)
• prompt_templates (templates/modelos)
• prompt_ai_providers (configurações dos provedores)
• ai_models (modelos disponíveis por provedor)
• prompt_generations (gerações realizadas)

3. Models

• User (com role)
• PromptProject
• PromptTemplate
• AiProvider
• AiModel
• PromptGeneration

4. Autenticação e Autorização

• Middleware de verificação de role
• Policies para CRUD
• Seeders para SuperAdmin e User de teste
• Registro público com aprovação do SuperAdmin

5. Controllers e Services

• AuthController (Breeze customizado)
• DashboardController
• PromptProjectController (CRUD)
• PromptGenerationController
• AiProviderController (apenas SuperAdmin)
• TutorialController (páginas de tutorial)

6. Requests e Validações

• StorePromptProjectRequest
• UpdatePromptProjectRequest
• GeneratePromptRequest
• Captcha nativo Laravel

7. Rotas

• Rotas públicas (login, registro, captcha)
• Rotas autenticadas (dashboard, CRUD)
• Rotas SuperAdmin (usuários, provedores)
• Rotas API para integração com IA

8. Integração com IA

• Service para comunicação com provedores
• Drivers: OpenRouter, StepFun, llama.cpp
• Processamento de respostas
• Armazenamento de gerações

9. Views

• Layout base com SbAdmin 2
• Sidebar responsivo (< >)
• Dashboard
• CRUD PromptProjects
• Formulário de criação de prompts
• Tutorial de Engenharia de Prompt
• Página Welcome
• Breadcrumbs em todas as views

10. Segurança

• CSRF tokens
• XSS protection (Blade escaping)
• SQL Injection (Eloquent/Query Builder)
• Mass Assignment protection
• Password visibility toggle
• Authorization checks

11. Testes e Validação

• Testes unitários
• Testes de feature
• Testes via Playwright
• Validação de fluxos completos

12. Documentação

• README.md
• RULES.md (IA - em inglês)
• LICENCE
• Documentação técnica do sistema