Guia rápido: app exemplo de ponta a ponta

Este capítulo conecta modelagem, backend, front-end e operação em um fluxo único de implementação.

Criar app e site

neoc new-app biblioteca
neoc new-site biblioteca.local
neoc --site biblioteca.local install-app biblioteca
neoc set-config -g developer_mode true

Criar DocTypes

Crie:

• Article

• Library Member

• Library Membership

Campos principais:

• Library Membership.library_member como Link;

• Library Membership.full_name como somente leitura;

• Library Membership.status como Select;

• Library Membership como submittable.

Controller de Library Member

from neo.model.document import Document

class LibraryMember(Document):
    def before_save(self):
        self.full_name = " ".join(filter(None, [
            self.first_name,
            self.last_name
        ]))

API de negócio

import neo

@neo.whitelist()
def activate_membership(name):
    doc = neo.get_doc("Library Membership", name)
    doc.status = "Active"
    doc.save()
    return {"name": doc.name, "status": doc.status}

Script cliente do formulário

neo.ui.form.on("Library Membership", {
    refresh(frm) {
        if (!frm.is_new() && frm.doc.docstatus === 0) {
            frm.add_custom_button("Ativar", () => {
                neo.call({
                    method: "biblioteca.membership.api.activate_membership",
                    args: { name: frm.doc.name },
                    callback() {
                        frm.reload_doc();
                        neo.msgprint("Associação ativada.");
                    }
                });
            }, "Ações");
        }
    },

    setup(frm) {
        frm.set_query("library_member", () => ({
            filters: { status: "Active" }
        }));
    }
});

Página operacional

Quando a operação cresce, uma Page pode listar pendências, exibir KPIs, aplicar filtros e disparar ações em lote.

Website ou portal

Também é possível expor ao associado uma área para consultar validade, atualizar contato ou solicitar renovação.

Job para comunicação

import neo

def send_membership_activation_email(membership_name):
    membership = neo.get_doc("Library Membership", membership_name)
    neo.logger().info(f"Enviar comunicação para {membership.name}")

Fluxo completo

1. usuário cria associado;

2. cria associação;

3. o controller valida;

4. o formulário guia a operação;

5. a API executa ativação;

6. um job cuida da comunicação;

7. report e page acompanham o processo.