🔮 GOD-MOD
🌐 Contexto do Sistema
MABUS Analytics é um sistema de inteligência para licitações públicas que integra dados do Nextcloud Deck para análise estratégica de oportunidades B2G (Business-to-Government).
📊 Fluxo de Dados
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ Nextcloud Deck │────▶│ JSON Export │────▶│ MABUS Import │
│ (Kanban Board) │ │ (Manual/API) │ │ (DeckImporter) │
└──────────────────┘ └──────────────────┘ └────────┬─────────┘
│
┌──────────────────────────────────────┼──────────────────────────────────────┐
│ ▼ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────────┐ ┌──────────┐ │
│ │ Boards │──▶│ Stacks │──▶│ Cards │──▶│ Card Labels │ │Custom Tags│ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────────┘ └──────────┘ │
│ │ │
│ POSTGRESQL DATABASE │ ASSIGNED USERS │
└──────────────────────────────────────┼──────────────────────────────────────┘
│
┌────────────────────────────────────────────┼────────────────────────────────────────────┐
│ ▼ │
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │
│ │ Dashboard │ │ Cards CRUD │ │ Analytics │ │ GOD-MOD │ │
│ │ (Stats/KPI) │ │ (List/Edit) │ │ (Graphs) │ │ (You Are Here)│ │
│ └────────────────┘ └────────────────┘ └────────────────┘ └────────────────┘ │
│ LARAVEL APPLICATION LAYER │
└─────────────────────────────────────────────────────────────────────────────────────────┘
🎯 Objetivos do Sistema
- Sincronizar: Importar cards do Nextcloud Deck preservando hierarquia e metadados
- Analisar: Calcular métricas IPM (Viabilidade, Complexidade, Lucratividade, Chance, Risco)
- Rastrear: Acompanhar status de licitações (Pendente → Acompanhando → Ganho/Perdido)
- Reportar: Gerar análises de win rate, volume por portal, tendências
📊 Diagrama de Relacionamento (ER)
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────────────────────────┐
│ BOARDS │────▶│ STACKS │────▶│ CARDS │
├─────────────────┤ ├─────────────────┤ ├─────────────────────────────────────────┤
│ id │ │ id │ │ id (PK) │
│ deck_board_id │ │ board_id (FK) │ │ deck_card_id (UK) │
│ title │ │ deck_stack_id │ │ title, description │
│ owner │ │ title │ │ analyst, user_status, defeat_reason │
│ color │ │ stack_order │ │ viabilidade_tatica, complexidade... │
│ archived │ └─────────────────┘ │ portal, orgao, valor_estimado │
└─────────────────┘ └───────────┬───────────┬─────────────────┘
│ │
┌────────────▼──┐ ┌─────▼─────────────┐
│ ASSIGNED_USERS│ │ CARD_LABELS │
├───────────────┤ ├───────────────────┤
│ card_id (FK) │ │ card_id (FK) │
│ uid │ │ category, value │
│ displayname │ │ raw_label, color │
└───────────────┘ └───────────────────┘
│
┌────────────▼──┐
│ CUSTOM_TAGS │
├───────────────┤
│ card_id (FK) │
│ tag_name │
│ tag_value │
└───────────────┘
📐 Cardinalidades
boards→stacks: 1:N (Um board tem várias colunas)stacks→cards: 1:N (Uma coluna tem vários cards)cards→assigned_users: 1:N (Card pode ter múltiplos responsáveis)cards→card_labels: 1:N (Card pode ter múltiplas labels)cards→custom_tags: 1:N (Tags personalizadas)
🔄 Ciclo de Vida do Card
┌─────────────┐
│ IMPORT │
│ (via JSON) │
└──────┬──────┘
│
▼
┌─────────────┐
┌───────▶│ PENDING │◀──────── Status inicial
│ └──────┬──────┘
│ │
│ Análise │ Analista avalia
│ necessária │ viabilidade
│ ▼
│ ┌─────────────┐
│ │ TRACKING │◀──────── Acompanhando licitação
│ └──────┬──────┘
│ │
│ │ Resultado do pregão
│ │
┌──────┴──────┐ ┌────▼────┐
│ │ │ │
▼ ▼ ▼ ▼
┌─────────────┐ ┌─────────────┐
│ WON │ │ LOST │
│ ✅ Ganho │ │ ❌ Perdido │
└─────────────┘ └──────┬──────┘
│
▼
┌─────────────┐
│defeat_reason│ ◀──── Motivo registrado
│ (obrigatório)│
└─────────────┘
📊 Métricas IPM (Índice de Priorização MABUS)
Viabilidade Tática
Capacidade de atender os requisitos técnicos
Complexidade Operacional
Dificuldade de execução/entrega
Lucratividade Potencial
Margem esperada do contrato
Chance de Vitória
Probabilidade de ganhar a licitação
Risco Operacional
Riscos associados à execução
📥 Fluxo de Importação
┌─────────────────────────────────────────────────────────────────────────┐
│ DECK IMPORTER SERVICE │
└────────────────────────────────────┬────────────────────────────────────┘
│
┌───────────────────────────┼───────────────────────────┐
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Parse JSON │ │ Upsert Board │ │ Process Stacks │
│ - Validate │────────▶│ - deck_board_id│────────▶│ - Per board │
│ - Extract data │ │ - Title/Owner │ │ - Order │
└─────────────────┘ └─────────────────┘ └────────┬────────┘
│
┌────────────────────────────────────────────────────────┘
▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Process Cards │ │ Parse Labels │ │ Extract IPM │
│ - deck_card_id │────────▶│ - Normalize │────────▶│ - 5 métricas │
│ - All fields │ │ - Category │ │ - Score final │
└─────────────────┘ └─────────────────┘ └────────┬────────┘
│
┌────────────────────────────┘
▼
┌─────────────────┐
│ Assign Users │
│ - Multi-assign │
│ - Displayname │
└─────────────────┘
🔑 Estratégia de Deduplicação
O sistema usa deck_card_id como chave única para evitar duplicatas:
Card::updateOrCreate(
['deck_card_id' => $cardData['deck_card_id']],
[...$allCardFields]
);
📖 Dicionário de Dados
📋 cards Principal
| Campo | Tipo | Descrição | Uso em IA/Gráficos |
|---|---|---|---|
id |
bigint | Chave primária | Identificador único |
deck_card_id |
bigint | ID original do Nextcloud Deck | Deduplicação na sincronização |
title |
varchar(500) | Título da licitação | Busca textual, NLP |
description |
longText | Descrição completa (markdown) | Extração de contexto por IA |
analyst |
varchar(100) | Analista responsável | 📊 GROUP BY analyst |
user_status |
enum | pending / tracking / won / lost | 📊 GROUP BY user_status |
defeat_reason |
text | Motivo da derrota | Análise de padrões de perda |
valor_estimado |
decimal(15,2) | Valor do pregão | 📊 SUM(), AVG() por período |
viabilidade_tatica |
varchar(20) | Alta / Média / Baixa | Score IPM estratégico |
complexidade_operacional |
varchar(20) | Alta / Média / Baixa | Score IPM operacional |
lucratividade_potencial |
varchar(20) | Alta / Média / Baixa | Score IPM financeiro |
chance_vitoria |
varchar(20) | Alta / Média / Baixa | Score IPM probabilidade |
risco_operacional |
varchar(20) | Alta / Média / Baixa | Score IPM risco |
ipm_score |
varchar(20) | Score final IPM | Decisão estratégica final |
portal |
varchar(100) | Portal de origem | 📊 GROUP BY portal |
orgao |
varchar(255) | Órgão público | Filtro geográfico/institucional |
extracted_date |
date | Data de extração | 📊 Timeline, tendências |
due_date |
date | Prazo limite | Alertas de vencimento |
board_name |
varchar(255) | Nome do board original | Segmentação por board |
🏢 boards
| Campo | Tipo | Descrição |
|---|---|---|
id |
bigint | PK |
deck_board_id |
bigint | ID único do Deck |
title |
varchar | Nome do board |
owner |
varchar | Proprietário |
archived |
boolean | Status de arquivamento |
📚 stacks
| Campo | Tipo | Descrição |
|---|---|---|
id |
bigint | PK |
board_id |
bigint | FK → boards |
deck_stack_id |
bigint | ID único do Deck |
title |
varchar | Nome da coluna |
stack_order |
int | Ordem de exibição |
👥 assigned_users
| Campo | Tipo | Descrição |
|---|---|---|
id |
bigint | PK |
card_id |
bigint | FK → cards |
uid |
varchar | ID do usuário |
displayname |
varchar | Nome de exibição |
🏷️ card_labels
| Campo | Tipo | Descrição |
|---|---|---|
id |
bigint | PK |
card_id |
bigint | FK → cards |
category |
varchar | Categoria normalizada |
value |
varchar | Valor normalizado |
raw_label |
varchar | Label original |
🔖 custom_tags
| Campo | Tipo | Descrição |
|---|---|---|
id |
bigint | PK |
card_id |
bigint | FK → cards |
tag_name |
varchar | Nome da tag |
tag_value |
varchar | Valor da tag |
🎯 Receitas de Cruzamento
Copie e use para gerar gráficos! Clique no código para copiar.
📊 Cards por Status
Distribuição do funil de vendas
SELECT user_status, COUNT(*) as total
FROM cards
GROUP BY user_status
ORDER BY total DESC;
Eloquent:
Card::groupBy('user_status')->selectRaw('user_status, COUNT(*) as total')->get()
📊 Win Rate por Analista
Performance individual
SELECT
analyst,
SUM(CASE WHEN user_status='won' THEN 1 ELSE 0 END) as won,
SUM(CASE WHEN user_status='lost' THEN 1 ELSE 0 END) as lost,
ROUND(SUM(CASE WHEN user_status='won' THEN 1 ELSE 0 END) * 100.0 /
NULLIF(SUM(CASE WHEN user_status IN ('won','lost') THEN 1 ELSE 0 END), 0), 2) as win_rate
FROM cards
WHERE analyst IS NOT NULL
GROUP BY analyst;
📊 Valor por Portal
Volume financeiro por origem
SELECT
portal,
COUNT(*) as total_cards,
SUM(valor_estimado) as valor_total,
AVG(valor_estimado) as valor_medio
FROM cards
WHERE portal IS NOT NULL
GROUP BY portal
ORDER BY valor_total DESC;
📊 Tendência Mensal
Volume ao longo do tempo
SELECT
DATE_FORMAT(extracted_date, '%Y-%m') as mes,
COUNT(*) as total,
SUM(CASE WHEN user_status='won' THEN 1 ELSE 0 END) as ganhos,
SUM(CASE WHEN user_status='lost' THEN 1 ELSE 0 END) as perdidos
FROM cards
WHERE extracted_date IS NOT NULL
GROUP BY mes
ORDER BY mes DESC
LIMIT 12;
📊 Distribuição IPM
Score estratégico
SELECT
viabilidade_tatica,
COUNT(*) as total,
ROUND(COUNT(*) * 100.0 / (SELECT COUNT(*) FROM cards WHERE viabilidade_tatica IS NOT NULL), 2) as percentual
FROM cards
WHERE viabilidade_tatica IS NOT NULL
GROUP BY viabilidade_tatica;
📊 Motivos de Derrota
Análise de padrões de perda
SELECT
defeat_reason,
COUNT(*) as ocorrencias
FROM cards
WHERE user_status = 'lost'
AND defeat_reason IS NOT NULL
AND defeat_reason != ''
GROUP BY defeat_reason
ORDER BY ocorrencias DESC
LIMIT 10;
⚡ Eloquent Quick Reference
Card::with(['labels', 'customTags'])->get()
Carregar com relacionamentos
Card::where('user_status', 'won')->count()
Contar ganhos
Card::whereNotNull('analyst')->distinct('analyst')->pluck('analyst')
Lista de analistas únicos
Card::whereBetween('extracted_date', [$start, $end])->get()
Filtrar por período
Card::where('valor_estimado', '>', 100000)->sum('valor_estimado')
Soma de valores altos
$card->labels()->where('category', 'status')->first()
Label específica de um card
Card::selectRaw('analyst, COUNT(*) as total')->groupBy('analyst')->orderByDesc('total')->get()
Top analistas por volume
Board::with(['stacks.cards'])->get()
Hierarquia completa
🔗 Endpoints da API
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /cards |
Listar cards com filtros |
| GET | /cards/create |
Form de criação |
| POST | /cards |
Criar novo card |
| GET | /cards/{id}/edit |
Form de edição |
| PUT | /cards/{id} |
Atualizar card |
| DELETE | /cards/{id} |
Excluir card |
| GET | /api/cards/{id} |
Detalhes JSON |
| PATCH | /api/cards/{id} |
Update parcial (inline edit) |
| GET | /api/cards/{id}/tags |
Listar tags |
| POST | /api/cards/{id}/tags |
Adicionar tag |
| DELETE | /api/tags/{id} |
Remover tag |