Los oficios

Un oficio es la descripción de un trabajo, escrita con el detalle suficiente para que quien lo ocupe sepa qué hace, qué necesita, qué no puede hacer solo y a quién entrega su trabajo. No es un empleado: es la plantilla. El empleado es el puesto, que nace de un oficio y luego se ajusta a esta empresa.

La vista se llama Oficios en el menú de la izquierda (la dirección de la página es perfiles). Su título es «Oficios listos para usar».

La cabecera

Elemento	Qué muestra
Título	«Oficios listos para usar».
Resumen	«N oficios · M áreas de trabajo». N cuenta todos los oficios del catálogo; M, las áreas distintas que aparecen en ellos.

De fábrica vienen 54 oficios. El número real es el que marque la cabecera: el catálogo puede crecer sin tocar la aplicación.

Los filtros

Elemento	Qué hace
Buscador	«Buscar un oficio…». Busca en el título, en la misión y en el área del oficio. No busca en las habilidades.
«Todos»	Quita el filtro. Es el que está marcado al entrar.
«De la empresa»	Enseña los oficios de la línea de mando y esconde los de tu equipo de control.
«Tu equipo de control»	Enseña solo los oficios cuyo ámbito es «control».
Un botón por área	Un filtro por cada área que aparece en los oficios de la empresa. Al pulsarlo, solo se ven los de esa área.

El filtro es excluyente: al elegir un área se deja de ver «Todos». Si la búsqueda no encuentra nada, aparece «Ningún oficio coincide con esa búsqueda».

La ficha de cada oficio en la lista

Parte	Qué muestra
Título	El nombre del oficio, por ejemplo «Abogado mercantil».
Etiqueta	El área, o «control» si es de tu equipo de control.
Misión	La frase que resume para qué existe ese oficio.
Pie	Sus habilidades, separadas por puntos, y «· N fuentes» si trae direcciones de consulta.
Botón «Ver»	Abre el oficio completo.
Botón «Añadir»	Abre el formulario para contratarlo.

Qué trae un oficio por dentro

Estos son todos los campos que guarda un oficio. Unos se ven en la pantalla y otros se arrastran al puesto al contratarlo.

Campo	Qué es	Dónde se ve
`codigo`	El identificador interno, en minúsculas y con guiones (por ejemplo `abogado-mercantil`).	No se muestra; sirve para enlazar y para saber de qué oficio nació un puesto.
`titulo`	El nombre del oficio y el cargo por defecto del puesto.	En la lista y en la cabecera del diálogo.
`area`	El área de trabajo.	En la etiqueta de la ficha y en los filtros.
`mision`	Para qué existe el oficio, en una o dos frases.	Primera línea del diálogo «Ver».
`directrices`	El texto largo con lo que hace, sus reglas, cuándo escala y qué entrega.	En el diálogo «Ver», por secciones.
`contexto`	El terreno donde trabaja: normativa, sector y convenciones.	Sección «El terreno donde trabaja», si el oficio lo trae.
`habilidades`	Lo que sabrá hacer el puesto: leer, recordar, escribir, ejecutar, delegar o navegar.	En el pie de la tarjeta y en «Lo que se le da al contratarlo».
`reporta_a`	De quién depende por defecto: `ceo` o `propietario`.	En «Lo que se le da al contratarlo», como «depende de ti» o «depende de Adrián».
`urls`	Direcciones web de consulta, cada una con título y valor.	Sección «De dónde se informa» y el contador de fuentes.
`documentos`	Documentos de consulta, con el mismo formato que las URLs.	No se ven en el diálogo, pero se copian al puesto como fuentes de tipo «Documento».
`origen`	De dónde salió la inspiración del oficio.	Al final de «Lo que se le da al contratarlo».
`ambito`	`empresa` o `control`. Decide en qué rama del organigrama cae y qué filtro lo enseña.	En la etiqueta «control» y en el subtítulo del diálogo.

Las áreas que usa el catálogo son estas:

Código	Nombre en pantalla
`legal`	Legal
`fiscal`	Fiscal
`pagos`	Pagos
`redes`	Redes sociales
`calidad`	Calidad
`seguridad`	Seguridad
`plataformas`	Plataformas
`finanzas`	Finanzas
`datos`	Datos
`personas`	Personas
`ventas`	Ventas
`marketing`	Marketing
`soporte`	Soporte
`producto`	Producto
`operaciones`	Operaciones
`documentacion`	Documentación
`estrategia`	Estrategia
`tecnologia`	Tecnología
`control`	Control
`general`	General

El diálogo «Ver»

Se abre con el botón «Ver» de una tarjeta. Lleva el título del oficio y, debajo, el área y «del equipo de Adrián» o «de tu equipo de control».

El contenido se lee en este orden:

La misión, como entradilla.
El terreno donde trabaja, si el oficio trae contexto.
Las directrices, por secciones. El texto se parte por líneas: una línea normal es un encabezado y las líneas que empiezan por «- » son viñetas de esa sección. Si el texto empieza directamente por viñetas, la sección se titula «Qué hace». En los oficios de fábrica verás, por ejemplo, «Qué haces», «Reglas», «Cuándo escalas» y «Entregas».
De dónde se informa, si trae fuentes: cada una con su título, su dirección y un enlace que se abre en otra pestaña.
Lo que se le da al contratarlo: las habilidades, de quién depende y el origen.

Abajo hay dos botones: «Cerrar» y «Contratar este oficio», que lleva al mismo formulario que el botón «Añadir».

Si abres la dirección con ?oficio=codigo, el diálogo de ese oficio se abre solo. Sirve para enlazarlo o para enseñarlo sin buscarlo.

El diálogo «Añadir»

Es el paso de oficio a puesto. Lleva el título «Añadir: nombre del oficio» y esta explicación: «Entra con el oficio ya escrito. Después puedes cambiarle lo que quieras».

Campo	Qué es	Cómo viene
Nombre de la persona	El nombre propio del puesto.	Vacío y opcional. Sin nombre, se le llama por su cargo.
Cargo	El título del puesto.	Relleno con el título del oficio; se puede cambiar.
Depende de	De quién cuelga.	«Adrián (CEO)» si el oficio es de la empresa; «Tú (equipo de control)» si es de control.
Misión	Un recordatorio de la misión del oficio.	Solo se muestra; se cambia después, en la ficha.
Aviso de fuentes	«Trae N fuentes de consulta ya puestas».	Solo aparece si el oficio trae URLs.

Al confirmar, el puesto se crea ya activo y con todo lo del oficio: misión, directrices, contexto, habilidades y fuentes. La pantalla avisa con ««Cargo» está dentro» y la lista se recarga.

El código interno del puesto se genera solo: se usa el nombre si es válido o el código del oficio, y si ya existe se le añade un número detrás (_2, _3…). No hay que decidirlo.

Desde esta pantalla el puesto nace siempre activo. Un puesto que esté pendiente (estado «solicitado») aparece en el organigrama con la marca «pendiente» y hay que firmarlo desde su ficha. El botón «Firmar» está en esa ficha, no aquí.

Cómo se crea y se edita un oficio

Conviene ser exacto, porque es lo que más se malinterpreta:

Crear un puesto a partir de un oficio es lo que hace esta pantalla, con «Añadir» o «Contratar este oficio». Es la vía normal.
Crear un oficio nuevo no se hace desde la aplicación: no hay formulario ni botón. El catálogo vive en el código de la instalación (app/organtia/perfiles.py), y se siembra en la base al arrancar. Añadir un oficio es añadir su definición ahí y reiniciar. Al arrancar, los oficios que ya existen no se sobrescriben: solo se insertan los que faltan.
Editar un oficio tampoco se hace desde esta pantalla: no hay botón de editar ni ruta que lo guarde. Lo que se edita es el puesto ya contratado, en su ficha: ahí se cambian cargo, misión, reglas, contexto, habilidades, fuentes y jefe sin tocar el oficio de origen. El puesto conserva la referencia «perfil: código» para saber de dónde salió.

Dicho de otro modo: el oficio es el molde y no se toca desde la interfaz; el puesto es la persona y se ajusta todo lo que haga falta.