Spec 001 — CONTIX+ Odoo Apps Home Menu Branding + Auto-Open + Atalhos Financeiros
Criado: 2026-07-26
Atualizado: 2026-07-26 (atalhos Home img 6/7 + login + ligit sync)
Solicitado por: Roger
Status: ✅ Definitivo em erp.myvexx.com e erp.ligit.com.br
Projeto: erp-odoo-ligit-myvexx
Módulo Odoo: myvexx_apps_branding 16.0.1.4.3
Dependências: web, OCA web_responsive, account, account_financial_report
Sistemas
| Instância |
Host |
Acesso |
DB |
| erp.myvexx.com |
VM 111 erp-myvexx (Big) |
10.10.10.111:22248 |
ligit |
| erp.ligit.com.br |
lig315 |
200.187.190.30:22248 |
ligit |
Path do módulo: /opt/odoo/custom/addons/myvexx_apps_branding
Objectivo
- Personalizar o Apps Menu fullscreen do
web_responsive com branding CONTIX+.
- Abrir essa tela automaticamente após o login.
- Branding da página de login.
- Atalhos na Home para menus Financeiro / Contabilidade (ícones cortados das artes Roger).
Composição
- Esquerda: logo CONTIX+ (transparente)
- Direita: busca + grid compacto de ícones
- Sem caixas/bordas/retângulos decorativos
Medidas aprovadas
| Elemento |
Valor |
Nota |
| Painel logo |
~560px (min-width 420px) |
.o_myvexx_apps_brand |
| Logo max-width |
~520px |
.o_myvexx_logo |
| Ícone app |
5.5rem |
.o-app-icon — NÃO ALTERAR |
| Célula app |
~118px |
.o_app |
| Títulos |
~1.2rem / weight 500 |
|
| Row-gap |
~1.15rem |
|
| Grid max-width |
~780px |
|
Assets Home
| Ficheiro |
Uso |
static/src/img/logo-contix-home.png |
Logo canónica Home |
static/src/img/logo-contabilidade_5.png |
Backup / origem |
Login (definitivo Roger)
| Elemento |
Valor |
| Logo |
static/src/img/logo-contix-login.png (otimizado ~200KB) ou home PNG se login específico ausente |
| max-height logo |
340px |
| Card max-width |
580px |
| Gap logo→form |
margin-bottom: -2.5rem (aprovado) |
| Views |
views/login_layout.xml + static/src/scss/login.scss |
Nota performance: logo original ~2.3MB deixava o login lento; versão otimizada é a canónica.
XML: views/home_finance_menus.xml + views/home_accounting_menus.xml
Arte origem: logo-contabilidade_6.png e logo-contabilidade_7.png (Documents Roger) → ícones 256×256 em static/src/img/icon_*.png.
Imagem 6 — Financeiro
| Menu Home |
Action Odoo |
Ícone |
| Contas a Receber |
account.action_move_out_invoice_type |
icon_contas_receber.png |
| Recebimentos |
account.action_account_payments |
icon_recebimentos.png |
| Contas a Pagar |
account.action_move_in_invoice_type |
icon_contas_pagar.png |
| Pagamentos |
account.action_account_payments_payable |
icon_pagamentos.png |
Imagem 7 — Contabilidade
| Menu Home |
Action Odoo |
Ícone |
| Contabilidade |
account.open_account_journal_dashboard_kanban |
icon_contabilidade.png |
| Extratos Bancarios |
account.action_bank_statement_tree |
icon_extratos_bancarios.png |
| Relatorios Contabeis |
account_financial_report.action_trial_balance_wizard |
icon_relatorios_contabeis.png |
| Diarios |
account.action_move_journal_line |
icon_diarios.png |
Sequences: 46–49 (finance) · 50–53 (accounting).
Groups: account.group_account_invoice / account.group_account_user (relatórios).
Arquitectura técnica
web_responsive.AppsMenu (OCA)
│
├─ XML inherit → apps_menu.xml
├─ SCSS → apps_menu.scss
└─ JS patch → open_home_on_login.esm.js
+ login_layout.xml / login.scss
+ home_finance_menus.xml
+ home_accounting_menus.xml
Árvore do módulo
myvexx_apps_branding/
├── __init__.py
├── __manifest__.py # 16.0.1.4.3
├── LAYOUT_DEFINITIVO.txt
├── PREFERENCIAS_ROGER.txt
├── views/
│ ├── login_layout.xml
│ ├── home_finance_menus.xml
│ └── home_accounting_menus.xml
└── static/src/
├── js/open_home_on_login.esm.js
├── scss/login.scss
├── img/
│ ├── logo-contix-home.png
│ ├── logo-contix-login.png # se presente
│ ├── logo-contabilidade_5.png
│ └── icon_*.png # 8 ícones Home
└── components/apps_menu/
├── apps_menu.xml
└── apps_menu.scss
Auto-open no login
- Após montar
AppsMenu, setOpenState(true, false).
- ~1.5s bloqueia o 1º
ACTION_MANAGER:UI-UPDATED.
- Depois libera o fecho normal.
import {patch} from "web.utils"
- Patch:
myvexx_apps_branding.OpenHomeOnLogin
Performance / operações (notas 2026-07-26)
| Tema |
Decisão |
workers > 0 no ligit |
NÃO usar — race MRO com l10n-brazil / spec_driven_model (TypeError: SpecModel, nfe.40.comb) → Internal Server Error |
dbfilter |
^ligit$ + list_db = False (estável single-DB) |
| Logo login |
Manter PNG otimizado (~200KB), não o 2.3MB |
| Upgrade módulo |
Preferir XML-RPC button_immediate_upgrade ou CLI -u com systemctl start odoo sempre no fim |
Deploy / upgrade
systemctl stop odoo
sudo -u odoo /opt/odoo/venv/bin/python3 /opt/odoo/server/odoo-bin \
-c /etc/odoo.conf -d ligit -u myvexx_apps_branding --stop-after-init
systemctl start odoo # OBRIGATÓRIO — nunca deixar parado
Sync entre instâncias: empacotar /opt/odoo/custom/addons/myvexx_apps_branding e -u na outra VM.
Teste
- Logout / login ·
Ctrl+Shift+R
- Home CONTIX+ abre; 8 atalhos visíveis com ícones custom
- Login com logo grande e gap
-2.5rem
Preferências travadas (Roger)
- Ícones Home 5.5rem
- Gap login logo→form
-2.5rem
- Logo transparente CONTIX+
- Auto-open no login
- 8 atalhos + ícones das imagens 6 e 7
Paths Spec Hub / Obsidian (VM130 / CT130)
| Onde |
Path |
| Acesso |
Big → ssh -p 4422 root@100.116.138.100 → pct exec 130 |
| Repo Git |
/opt/ligbox-spec-hub/repos/erp-odoo-ligit-myvexx |
| Specs |
.../specs/001-contix-apps-home-branding/ |
| Obsidian |
/opt/ligbox-spec-hub/obsidian-vault/ERP-Odoo-Ligit-Myvexx/ |
Changelog
Ver CHANGELOG.md.