@bricks2k/governance 1.0.0

package/LICENSE

@@ -0,0 +1,51 @@
+Licença MIT / MIT License
+
+Copyright (c) 2026 bricks2k 🇧🇷
+
+---
+
+## [PT-BR] Português do Brasil
+
+É concedida permissão, gratuitamente, a qualquer pessoa que obtenha uma cópia
+deste software e dos arquivos de documentação associados (o "Software"), para
+lidar com o Software sem restrições, incluindo, sem limitação, os direitos de
+usar, copiar, modificar, mesclar, publicar, distribuir, sublicenciar e/ou vender
+cópias do Software, e para permitir que as pessoas a quem o Software é fornecido
+o façam, sob as seguintes condições:
+
+O aviso de copyright acima e este aviso de permissão devem ser incluídos em todas
+as cópias ou partes substanciais do Software.
+
+O SOFTWARE É FORNECIDO "COMO ESTÁ", SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU
+IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS DE COMERCIALIZAÇÃO,
+ADEQUAÇÃO A UM PROPÓSITO ESPECÍFICO E NÃO VIOLAÇÃO. EM NENHUM CASO OS AUTORES OU
+TITULARES DOS DIREITOS AUTORAIS SERÃO RESPONSÁVEIS POR QUALQUER RECLAMAÇÃO, DANOS
+OU OUTRA RESPONSABILIDADE, SEJA EM AÇÃO DE CONTRATO, ATO ILÍCITO OU DE OUTRA FORMA,
+DECORRENTE DE, FORA DE OU EM CONEXÃO COM O SOFTWARE OU O USO OU OUTRAS NEGOCIAÇÕES
+NO SOFTWARE.
+
+---
+
+## [EN] English
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+🇧🇷 Feito com orgulho no Brasil | Made with pride in Brazil 🇧🇷

package/README.md

@@ -0,0 +1,357 @@
+# @bricks2k/governance
+
+> Sistema de governança para projetos React com gestão de débitos técnicos, backlog e logs de desenvolvimento.
+
+## 📋 Funcionalidades
+
+- ✅ **Dashboard de Governança** - Visão unificada do projeto
+- 📊 **Tech Debt Management** - Rastreamento de débitos técnicos
+- 📦 **Backlog Management** - Gestão de features e melhorias
+- 📝 **Logs System** - Histórico de arquitetura e decisões
+- 🏗️ **Architecture View** - Visualização da arquitetura
+- 🔧 **Supabase Integration** - Status e configuração do Supabase
+- 🤖 **AI Assistant** - Assistente de desenvolvimento
+
+## 🚀 Instalação
+
+```bash
+npm install @bricks2k/governance
+```
+
+### Peer Dependencies
+
+```bash
+npm install react react-dom
+```
+
+## 📦 Uso Básico
+
+### Sem Provider (Standalone)
+
+```jsx
+import { GovernanceDashboard } from '@bricks2k/governance';
+
+function App() {
+  return (
+    <GovernanceDashboard />
+  );
+}
+```
+
+### Com Provider (Recomendado)
+
+O `GovernanceProvider` permite injetar dependências e configurações customizadas:
+
+```jsx
+import { GovernanceProvider, GovernanceDashboard } from '@bricks2k/governance';
+import { copyToClipboard, maskCredential } from './lib/credentialUtils';
+import { supabase } from './lib/supabase';
+import { SUPABASE_CONFIG } from './lib/constants/supabaseConfig';
+import { supabaseHealthCheck } from './lib/supabaseHealthCheck';
+
+function App() {
+  return (
+    <GovernanceProvider
+      utils={{ copyToClipboard, maskCredential }}
+      client={supabase}
+      config={{ supabase: SUPABASE_CONFIG }}
+      healthCheck={supabaseHealthCheck}
+    >
+      <GovernanceDashboard />
+    </GovernanceProvider>
+  );
+}
+```
+
+### Uso Avançado com Chat AI
+
+```jsx
+import { GovernanceProvider } from '@bricks2k/governance';
+import { DevAssistantTab } from '@bricks2k/governance';
+import ChatInterface from './components/ai/ChatInterface';
+
+function App() {
+  return (
+    <GovernanceProvider
+      utils={{ copyToClipboard, maskCredential }}
+      ChatInterface={ChatInterface}
+      chatConfig={{
+        endpoint: '/api/openrouter-ai-service',
+        context: 'development',
+        systemContext: 'React development project'
+      }}
+    >
+      <DevAssistantTab />
+    </GovernanceProvider>
+  );
+}
+```
+
+## 🎨 Estilização
+
+O pacote requer **Tailwind CSS** configurado no projeto host.
+
+### Tailwind Config
+
+Adicione o caminho do pacote no `tailwind.config.js`:
+
+```javascript
+module.exports = {
+  content: [
+    './src/**/*.{js,jsx,ts,tsx}',
+    './node_modules/@bricks2k/governance/dist/**/*.{js,jsx}' // ← Adicionar
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+}
+```
+
+## 📄 Estrutura de Dados
+
+### Tech Debt Registry
+
+Esperado em: `public/docs/TECHNICAL_DEBT_REGISTRY.md`
+
+```markdown
+| TD-001 | Descrição | 🔴 Crítico | Trigger | Location | Owner | ⏳ Pendente | 2026-01-01 |
+```
+
+### Backlog Registry
+
+Esperado em: `public/docs/BACKLOG_REGISTRY.md`
+
+```markdown
+| BL-001 | Título | ✨ Feature | 📋 Backlog | Owner | M | 2026-01-01 |
+```
+
+### Logs
+
+Esperados em: `public/.logs/`
+- `architecture.log.md`
+- `decisions.log.md`
+
+## 🔧 API Completa
+
+### GovernanceProvider
+
+Provider para injeção de dependências e configuração.
+
+**Props:**
+
+| Prop | Tipo | Required | Descrição |
+|------|------|----------|-----------|
+| `children` | `ReactNode` | ✅ | Componentes filhos |
+| `utils` | `Object` | ❌ | Utilitários customizados |
+| `utils.copyToClipboard` | `Function` | ❌ | Função para copiar texto |
+| `utils.maskCredential` | `Function` | ❌ | Função para mascarar credenciais |
+| `client` | `Object` | ❌ | Cliente de banco (ex: Supabase) |
+| `config` | `Object` | ❌ | Configurações gerais |
+| `config.supabase` | `Object` | ❌ | Configuração Supabase |
+| `healthCheck` | `Function` | ❌ | Função de health check |
+| `ChatInterface` | `Component` | ❌ | Componente de chat AI |
+| `chatConfig` | `Object` | ❌ | Configuração do chat |
+
+**Exemplo Completo:**
+
+```jsx
+import { GovernanceProvider } from '@bricks2k/governance';
+
+<GovernanceProvider
+  // Utilitários customizados
+  utils={{
+    copyToClipboard: async (text) => {
+      await navigator.clipboard.writeText(text);
+      toast.success('Copiado!');
+    },
+    maskCredential: (value) => '•'.repeat(value.length)
+  }}
+  
+  // Cliente de banco de dados
+  client={supabase}
+  
+  // Configurações
+  config={{
+    supabase: {
+      url: process.env.VITE_SUPABASE_URL,
+      anonKey: process.env.VITE_SUPABASE_ANON_KEY
+    }
+  }}
+  
+  // Health check customizado
+  healthCheck={async () => {
+    const { data, error } = await supabase.from('_health').select('*');
+    return { healthy: !error, services: [...] };
+  }}
+  
+  // Chat AI (opcional)
+  ChatInterface={ChatInterface}
+  chatConfig={{
+    endpoint: '/api/chat',
+    context: 'development'
+  }}
+>
+  <YourApp />
+</GovernanceProvider>
+```
+
+### useGovernance Hook
+
+Hook para acessar o contexto do Provider.
+
+```jsx
+import { useGovernance } from '@bricks2k/governance';
+
+function MyComponent({ onCopy }) {
+  const context = useGovernance();
+  
+  // Prioridade: props > context > default
+  const copyFn = onCopy || context?.utils?.copyToClipboard || defaultCopy;
+  
+  return <button onClick={() => copyFn('text')}>Copy</button>;
+}
+```
+
+### Componentes Principais
+
+#### `<GovernanceDashboard />`
+Dashboard completo com todas as abas.
+
+```jsx
+import { GovernanceDashboard } from '@bricks2k/governance';
+
+<GovernanceDashboard />
+```
+
+#### `<TechDebtTab />`
+Aba de débitos técnicos standalone.
+
+```jsx
+import { TechDebtTab } from '@bricks2k/governance';
+
+<TechDebtTab />
+```
+
+#### `<BacklogTab />`
+Aba de backlog standalone.
+
+```jsx
+import { BacklogTab } from '@bricks2k/governance';
+
+<BacklogTab />
+```
+
+#### `<SupabaseTab />`
+Aba de integração Supabase (requer Provider com `client` e `config`).
+
+```jsx
+import { GovernanceProvider, SupabaseTab } from '@bricks2k/governance';
+
+<GovernanceProvider client={supabase} config={{ supabase: {...} }}>
+  <SupabaseTab />
+</GovernanceProvider>
+```
+
+#### `<DevAssistantTab />`
+Assistente de desenvolvimento com AI (requer Provider com `ChatInterface`).
+
+```jsx
+import { GovernanceProvider, DevAssistantTab } from '@bricks2k/governance';
+import ChatInterface from './components/ai/ChatInterface';
+
+<GovernanceProvider
+  ChatInterface={ChatInterface}
+  chatConfig={{ endpoint: '/api/chat' }}
+>
+  <DevAssistantTab />
+</GovernanceProvider>
+```
+
+### Utilitários
+
+```javascript
+import {
+  parseTechDebtRegistry,
+  parseBacklogRegistry,
+  calculateHealthScore
+} from '@bricks2k/governance';
+
+// Parse de arquivos Markdown
+const { debts, stats } = parseTechDebtRegistry(markdownContent);
+
+// Cálculo de health score do projeto
+const score = calculateHealthScore(techDebtStats, backlogStats);
+```
+
+## 🧪 Desenvolvimento
+
+```bash
+# Instalar dependências
+npm install
+
+# Desenvolvimento
+npm run dev
+
+# Build
+npm run build
+
+# Testes
+npm test
+
+# Lint
+npm run lint
+```
+
+## 📁 Estrutura do Projeto
+
+```
+governance/
+├── src/
+│   ├── components/       # Componentes React
+│   │   ├── dashboard/    # Componentes de dashboard
+│   │   ├── backlog/      # Módulo de backlog
+│   │   ├── logs/         # Módulo de logs
+│   │   ├── supabase/     # Módulo Supabase
+│   │   ├── techdebt/     # Módulo tech debt
+│   │   └── widgets/      # Widgets reutilizáveis
+│   ├── utils/            # Utilitários (parsers, helpers)
+│   └── index.js          # Entry point
+├── tests/                # Testes
+├── docs/                 # Documentação
+└── package.json
+```
+
+## 🤝 Contribuindo
+
+Este é um repositório privado mantido por @bricks2k.
+
+### Workflow
+
+1. Criar branch para mudanças
+2. Testar localmente
+3. Criar PR
+4. Review e testes
+5. Merge para main
+
+## 📝 Changelog
+
+### v1.0.0 (2026-01-17)
+- ✨ Versão inicial com sistema completo
+- 📦 35 componentes React organizados
+- 🎯 GovernanceProvider para injeção de dependências
+- 🛠️ 3 utilitários principais (parsers e health check)
+- 📚 Documentação completa com exemplos
+- ✅ Testes unitários com Vitest
+- 🔧 ESLint configurado para qualidade de código
+- 📋 Suporte a 7 abas: Overview, Tech Debt, Backlog, Logs, Architecture, Supabase, AI Assistant
+
+## 📄 Licença
+
+MIT © bricks2k
+
+---
+
+**Última Atualização:** 2026-01-17  
+**Autor:** Nexus Team  
+**Status:** Em Desenvolvimento