205 lines
6.5 KiB
Markdown
205 lines
6.5 KiB
Markdown
# 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](https://github.com/itecnologys-tech/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
|
||
|
||
1. Personalizar o **Apps Menu** fullscreen do `web_responsive` com branding CONTIX+.
|
||
2. Abrir essa tela **automaticamente após o login**.
|
||
3. Branding da **página de login**.
|
||
4. Atalhos na Home para menus Financeiro / Contabilidade (ícones cortados das artes Roger).
|
||
|
||
---
|
||
|
||
## Layout Home Menu (aprovado Roger — não alterar sem OK)
|
||
|
||
### 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.
|
||
|
||
---
|
||
|
||
## Atalhos Home Menu (definitivos)
|
||
|
||
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
|
||
|
||
1. Após montar `AppsMenu`, `setOpenState(true, false)`.
|
||
2. ~**1.5s** bloqueia o 1º `ACTION_MANAGER:UI-UPDATED`.
|
||
3. 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
|
||
|
||
```bash
|
||
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
|
||
1. Logout / login · `Ctrl+Shift+R`
|
||
2. Home CONTIX+ abre; 8 atalhos visíveis com ícones custom
|
||
3. 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`.
|