Saltar al contenido principal
Versión: Tryton 7.0 (LTS)

project

Tryton 7.0 · Referencia generada desde el código oficial

Esta página combina orientación editorial con evidencia extraída de la rama oficial indicada. Pruebe siempre el flujo con sus permisos y configuración.

Propósito

El módulo project incorpora o amplía funciones relacionadas con project. Su alcance real se determina por los modelos, acciones y dependencias documentados a continuación; no debe activarse únicamente por su nombre.

Descripción oficial de la rama (idioma original)

The Project Module contains the basic concepts that are needed for managing simple projects.

El análisis encontró 8 archivos Python, 12 archivos XML, 8 vistas, 24 acciones, 9 menús y 0 informes.

Guía funcional para el usuario

A quién le sirve

Este módulo interesa a las personas responsables de los procesos relacionados con project, a quienes configuran la compañía y a quienes revisan sus resultados. Los administradores deben participar cuando se activen dependencias, permisos o secuencias.

Qué podrá hacer

Al finalizar la configuración podrá reconocer los registros que aporta project, ejecutar sus acciones con el estado correcto y comprender qué información termina compartiendo con otros módulos.

Requisitos y preparación

Antes de activarlo confirme la compañía, moneda, usuarios y grupos aplicables. Instale y configure primero sus dependencias obligatorias. Si existen datos reales, ensaye la activación y actualización sobre una copia restaurada.

Active primero las dependencias, revise la configuración de la compañía y ensaye el flujo completo antes de usarlo en producción.

Dependencias obligatorias

  • company — debe estar instalado y configurado antes de probar este módulo.
  • company_work_time — debe estar instalado y configurado antes de probar este módulo.
  • ir — debe estar instalado y configurado antes de probar este módulo.
  • party — debe estar instalado y configurado antes de probar este módulo.
  • timesheet — debe estar instalado y configurado antes de probar este módulo.

Integraciones opcionales

Configuración inicial recomendada

  • Active el módulo y vuelva a iniciar la sesión para cargar menús y permisos.
  • Revise las nuevas opciones de configuración de compañía y los valores por defecto.
  • Asigne grupos a usuarios de prueba aplicando mínimo privilegio.
  • Cree datos maestros pequeños y verificables antes de importar información masiva.
  • Ejecute un caso completo desde borrador hasta su estado final y revise los registros relacionados.

Objetos y conceptos del módulo

  • ir.action: agrupa 1 modelo(s), entre ellos ir.action.act_window. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • party.erase: agrupa 1 modelo(s), entre ellos party.erase. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • party.replace: agrupa 1 modelo(s), entre ellos party.replace. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • project.work: agrupa 2 modelo(s), entre ellos project.work, project.work.status. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • timesheet.line: agrupa 1 modelo(s), entre ellos timesheet.line. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • timesheet.work: agrupa 1 modelo(s), entre ellos timesheet.work. Estos registros forman la información que el usuario consulta o modifica durante el proceso.

Flujo de trabajo habitual

  1. Seleccione la compañía y fecha correctas antes de crear el documento.
  2. Complete primero los datos maestros y luego las líneas o detalles.
  3. Guarde y revise el registro antes de utilizarlo desde otro proceso.
  4. Revise advertencias, totales, documentos relacionados y trazabilidad.
  5. Compruebe el efecto en los módulos dependientes antes de cerrar el proceso.

Acciones, estados y asistentes

  • No se detectaron botones o asistentes propios; el módulo actúa mediante campos, reglas o extensiones de procesos existentes.

Controles antes de producción

  • Defina quién crea, revisa, confirma, cancela y consulta.
  • Pruebe períodos cerrados, usuarios sin permisos y datos incompletos.
  • Verifique numeración, moneda, redondeo y zona horaria cuando correspondan.
  • Documente cómo corregir un error sin editar directamente la base de datos.
  • Incluya sus tablas y archivos en el procedimiento de copia y restauración.

Diagnóstico y resolución de problemas

  • Si no aparece el menú, compruebe activación, actualización de la lista de módulos, grupos y nueva sesión.
  • Si un campo no acepta un valor, revise su dominio, compañía, estado y dependencias configuradas.
  • Si un botón está oculto o deshabilitado, revise permisos y transición válida; no modifique el estado con SQL.
  • Si los resultados no coinciden, reproduzca un caso mínimo y compare registros relacionados antes y después.
  • Conserve el traceback completo, versión, módulos activos y datos mínimos para diagnosticar un error.

Guía para desarrolladores

Arquitectura y puntos de extensión

El paquete contiene 8 clases Python y declara o extiende 7 modelos. Utiliza Boolean, Char, Date, Float, Function, Many2One, MultiSelection, One2Many, Selection, Text, TimeDelta. Los desarrolladores deben localizar primero si una clase crea un modelo nuevo o usa PoolMeta para extender uno existente, conservar las llamadas a super() y no duplicar reglas disponibles en las dependencias.

Modelos registrados o extendidos

  • ir.action.act_window
  • party.erase
  • party.replace
  • project.work
  • project.work.status
  • timesheet.line
  • timesheet.work

Tipos de campos utilizados

  • Boolean
  • Char
  • Date
  • Float
  • Function
  • Many2One
  • MultiSelection
  • One2Many
  • Selection
  • Text
  • TimeDelta

Clases y métodos públicos detectados

Clases: ActWindow, Erase, Line, Replace, Work, WorkProgressValidationError, WorkStatus, WorkValidationError

Métodos: check_erase_company(), check_work_progress(), copy(), create(), default_company(), default_status(), default_timesheet_available(), default_type(), default_work(), delete(), effort_hours(), fields_to_replace(), get_default_status(), get_domains(), get_timesheet_available(), get_timesheet_date(), get_total(), get_types(), get_window_domains(), index_set_field(), on_change_status(), on_change_type(), search_global(), set_timesheet_available(), set_timesheet_date(), timesheet_duration_hours(), total_effort_hours(), validate(), write()

Mapa del código

Se detectaron 8 archivos Python, 12 XML y 0 archivos explícitos de acceso. Los XML conectan modelos con vistas, menús, acciones e informes; los CSV de acceso establecen permisos iniciales.

  • __init__.py
  • doc/conf.py
  • exceptions.py
  • ir.py
  • message.xml
  • party.py
  • project.xml
  • setup.py
  • timesheet.py
  • timesheet.xml
  • view/work_form.xml
  • view/work_list.xml
  • view/work_list_children.xml
  • view/work_list_simple.xml
  • view/work_status_form.xml
  • view/work_status_list.xml
  • view/work_tree.xml
  • view/work_tree_simple.xml
  • work.py
  • work.xml

Plan de pruebas

  • Activación en una base vacía y actualización desde la revisión anterior.
  • Creación, modificación, copia y eliminación según estado y permisos.
  • Cada botón, transición y asistente con casos válidos e inválidos.
  • Reglas multicompañía, traducciones, zonas horarias y monedas aplicables.
  • Instalación conjunta con dependencias obligatorias e integraciones opcionales.
  • Copia y restauración de registros, adjuntos e informes producidos.

Compatibilidad y actualización

Mantenga servidor y módulos en la serie 7.0. Antes de actualizar compare tryton.cfg, migraciones de __register__, cambios de estados, XML IDs y permisos. Una compilación exitosa no reemplaza una migración ensayada ni la conciliación funcional de datos.

Evidencia documental oficial

Temas encontrados: Design · Work Effort · Project · Task · Work Status · Project Module · Usage · Setting up projects and tasks

    • doc/design.rst: The Project Module introduces some new concepts and extends some existing concepts:
    • doc/index.rst: The Project Module contains the basic concepts that are needed for managing simple projects.
    • doc/usage.rst: You can find things related to projects under the [Projects] main menu item.

Ver código fuente