docs(spec-001): atalhos Home img6/7, login definitivo e sync ligit

This commit is contained in:
Roger 2026-07-26 13:23:32 +00:00
parent 3dab1200e1
commit 5e80e02fd8
5 changed files with 329 additions and 92 deletions

View file

@ -4,20 +4,26 @@ Projeto dedicado ao ERP Odoo **CONTIX+** nas instâncias:
| Instância | URL | Host |
|-----------|-----|------|
| MyVexx | https://erp.myvexx.com | Big VM 111 (`10.10.10.111`) |
| MyVexx | https://erp.myvexx.com | Big VM 111 (`10.10.10.111:22248`) |
| Ligit | https://erp.ligit.com.br | lig315 (`200.187.190.30:22248`) |
## Conteúdo
- `specs/` — especificações do projeto (SPEC-001+)
- `docs/` — notas Obsidian / operação
- `modules/` — referência dos addons custom (ex.: `myvexx_apps_branding`)
## Specs
| Spec | Título |
|------|--------|
| [001](specs/001-contix-apps-home-branding/) | Home Menu CONTIX+ + auto-open no login |
| Spec | Título | Versão módulo |
|------|--------|----------------|
| [001](specs/001-contix-apps-home-branding/) | Home Menu CONTIX+ + login + auto-open + 8 atalhos financeiros/contábeis | `myvexx_apps_branding` **16.0.1.4.3** |
## Estado definitivo (2026-07-26)
- Home Menu branding + auto-open: ✅ myvexx + ligit
- Login CONTIX+: ✅
- Atalhos img6/img7: ✅ myvexx + ligit
- Spec Hub / Obsidian CT130: ✅
## Não misturar

View file

@ -4,18 +4,20 @@ Projeto **dedicado** (não Ligbox Ops).
## Links
- Repo: https://github.com/itecnologys-tech/erp-odoo-ligit-myvexx
- Spec 001: [[SPEC-001-CONTIX-APPS-HOME-BRANDING]] — Home Menu + auto-open
- Spec 001: [[SPEC-001-CONTIX-APPS-HOME-BRANDING]] — Home + login + atalhos
## Instâncias
| | URL |
|--|-----|
| MyVexx | https://erp.myvexx.com |
| Ligit | https://erp.ligit.com.br |
| | URL | Módulo |
|--|-----|--------|
| MyVexx | https://erp.myvexx.com | `myvexx_apps_branding` 16.0.1.4.3 |
| Ligit | https://erp.ligit.com.br | idem (sync 2026-07-26) |
## Estado
- Branding Home Menu: ✅ definitivo
## Estado definitivo
- Branding Home Menu: ✅
- Auto-open login: ✅
- Sync módulos/dados Ligit→MyVexx: feito em sessão 2026-07-26
- Login layout (-2.5rem): ✅
- 8 atalhos (img 6 + 7): ✅ myvexx + ligit
- Workers Odoo no ligit: ❌ não usar (MRO l10n-brazil)
## Não misturar
SPECs deste ERP **não** vão para `ligbox-ops-platform`.

View file

@ -1,20 +1,205 @@
# SPEC-001 — CONTIX+ Apps Home Branding + Auto-Open
# Spec 001 — CONTIX+ Odoo Apps Home Menu Branding + Auto-Open + Atalhos Financeiros
**Status:** ✅ Implementado
**Módulo:** `myvexx_apps_branding` 16.0.1.2.1
**Repo:** https://github.com/itecnologys-tech/erp-odoo-ligit-myvexx
**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`
## Resumo
Home Menu roxo (`web_responsive`) com logo CONTIX+ à esquerda + grid compacto à direita. Abre sozinho no login.
## Sistemas
## Travas (Roger)
- Ícones `.o-app-icon` = **5.5rem**
- Logo transparente `logo-contix-home.png`
- Painel logo ~560px / logo max ~520px
| 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` |
## Paths
- Módulo: `/opt/odoo/custom/addons/myvexx_apps_branding`
- Spec completa: `specs/001-contix-apps-home-branding/` no repo
**Path do módulo:** `/opt/odoo/custom/addons/myvexx_apps_branding`
## Relacionado
- [[ERP-Odoo-Ligit-Myvexx]]
---
## 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: 4649 (finance) · 5053 (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`.

View file

@ -1,7 +1,14 @@
# Changelog — Spec 001 (CONTIX Apps Home)
## 2026-07-26
- Projecto dedicado criado: `itecnologys-tech/erp-odoo-ligit-myvexx` (saiu do ligbox-ops-platform).
- Layout CONTIX+ + auto-open implementados em erp.myvexx.com e replicados em erp.ligit.com.br.
- Módulo `myvexx_apps_branding` 16.0.1.2.1.
- Documentados riscos de upgrade e medidas travadas (ícones 5.5rem).
## 2026-07-26 (tarde) — Atalhos Home + sync Ligit + SPEC
- Ícones custom cortados de `logo-contabilidade_6.png` (Financeiro) e `_7.png` (Contabilidade).
- 8 menuitems root na Home Menu (`home_finance_menus.xml` + `home_accounting_menus.xml`).
- Módulo bump para **16.0.1.4.3** (`depends`: account + account_financial_report).
- Replicado definitivo **myvexx → ligit** (mesmo tarball + upgrade).
- Login: logo otimizado + layout definitivo (340px / 580px / margin-bottom -2.5rem).
- Nota operacional: **não** ativar `workers` no ligit (MRO l10n-brazil).
## 2026-07-26 (manhã)
- Projeto dedicado: `itecnologys-tech/erp-odoo-ligit-myvexx`.
- Layout CONTIX+ + auto-open em myvexx e ligit.
- Medidas travadas (ícones 5.5rem).

View file

@ -1,11 +1,12 @@
# Spec 001 — CONTIX+ Odoo Apps Home Menu Branding + Auto-Open
# 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:** ✅ Implementado (myvexx + ligit)
**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.2.1**
**Dependência:** OCA `web_responsive` (Odoo 16)
**Módulo Odoo:** `myvexx_apps_branding` **16.0.1.4.3**
**Dependências:** `web`, OCA `web_responsive`, `account`, `account_financial_report`
## Sistemas
@ -20,19 +21,19 @@
## Objectivo
Personalizar o **Apps Menu** fullscreen do `web_responsive` (tela roxa de apps) com branding CONTIX+ e abrir essa tela **automaticamente após o login**.
Não é a “Ação inicial” do utilizador Odoo (isso abre um app). É o **Home Menu de aplicativos**.
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 definitivo (aprovado Roger — não alterar sem OK)
## 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
- Sem slogan HTML (logo PNG já contém a arte)
### Medidas aprovadas
@ -43,15 +44,57 @@ Não é a “Ação inicial” do utilizador Odoo (isso abre um app). É o **Hom
| Í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 | entre linhas de apps |
| Grid max-width | ~780px | ao lado da logo |
| Row-gap | ~1.15rem | |
| Grid max-width | ~780px | |
### Assets visuais
### Assets Home
| Ficheiro | Uso |
|----------|-----|
| `static/src/img/logo-contix-home.png` | Logo canónica no XML |
| `static/src/img/logo-contabilidade_5.png` | Origem / backup da mesma arte |
| `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: 4649 (finance) · 5053 (accounting).
Groups: `account.group_account_invoice` / `account.group_account_user` (relatórios).
---
@ -60,68 +103,61 @@ Não é a “Ação inicial” do utilizador Odoo (isso abre um app). É o **Hom
```
web_responsive.AppsMenu (OCA)
├─ XML inherit → apps_menu.xml (shell esquerda/direita)
├─ SCSS → apps_menu.scss (medidas definitivas)
└─ JS patch → open_home_on_login.esm.js (auto-open)
├─ 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
```
### Ficheiros do módulo
### Árvore do módulo
```
myvexx_apps_branding/
├── __init__.py
├── __manifest__.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
├── img/logo-contix-home.png
├── img/logo-contabilidade_5.png
├── 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
```
### Manifest (assets)
```python
"depends": ["web_responsive"],
"assets": {
"web.assets_backend": [
"myvexx_apps_branding/static/src/js/open_home_on_login.esm.js",
"myvexx_apps_branding/static/src/components/apps_menu/apps_menu.xml",
"myvexx_apps_branding/static/src/components/apps_menu/apps_menu.scss",
],
},
```
---
## Auto-open no login
1. Após montar `AppsMenu`, chama `setOpenState(true, false)`.
2. Durante ~**1.5s** bloqueia o 1º `ACTION_MANAGER:UI-UPDATED` que normalmente fecha o menu.
1. Após montar `AppsMenu`, `setOpenState(true, false)`.
2. ~**1.5s** bloqueia o 1º `ACTION_MANAGER:UI-UPDATED`.
3. Depois libera o fecho normal.
Implementação Odoo 16 / estilo OCA:
- `import {patch} from "web.utils"`
- Patch: `myvexx_apps_branding.OpenHomeOnLogin`
- `this._super(...)` + `owl.onMounted`
Alvo: `@web_responsive/components/apps_menu/apps_menu.esm``AppsMenu`
---
## Riscos em actualizações
## Performance / operações (notas 2026-07-26)
| Actualização | Risco | Acção |
|--------------|-------|-------|
| Só dados / módulos de negócio | Baixo | Nenhuma |
| Update `web_responsive` OCA | Médio | Rever `AppsMenu` / `setOpenState` |
| Odoo 16 → 17+ | Alto | Reescrever patch (API sem `_super`) |
| Cloudflare / browser cache | Baixo | Hard refresh |
O módulo é **custom** (fora do path OCA) → pull do OCA não apaga o branding.
| 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 |
---
@ -129,34 +165,35 @@ O módulo é **custom** (fora do path OCA) → pull do OCA não apaga o branding
```bash
systemctl stop odoo
sudo -u odoo psql -d ligit -c "DELETE FROM ir_attachment WHERE name ILIKE '%web.assets_backend%' OR url ILIKE '%web.assets_backend%';"
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
systemctl start odoo # OBRIGATÓRIO — nunca deixar parado
```
Conf: `/etc/odoo.conf` · `addons_path` deve incluir `/opt/odoo/custom/addons`.
Sync entre instâncias: empacotar `/opt/odoo/custom/addons/myvexx_apps_branding` e `-u` na outra VM.
### Teste
1. Logout / login em `/web`
2. `Ctrl+Shift+R`
3. Home Menu CONTIX+ abre sozinho
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 **5.5rem**
- Proporção logo/grid actual
- Logo transparente
- Í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)
## 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/` |