Uso operativo PtD. La base de conocimiento es el repositorio editorial para criterios reutilizables: stack tecnologico, metodologia, dependencias, integraciones y uso de la herramienta.
Caso de uso
Un nuevo integrante necesita entender como trabajar APIs, seguridad, tareas, evidencia y dependencias sin depender de explicaciones informales o mensajes perdidos.
Estructura recomendada
- Pilares tecnologicos: Python, FastAPI, OpenAPI, seguridad, datos, frontend, reportes, backups y servicios transversales.
- Hitos y tareas: articulos que conectan hito, tareas, checklist, dependencias e integraciones.
- Dependencias: articulos por institucion o condicion que explican impacto, alcance y tareas afectadas.
- Integraciones: articulos por sistema con forma esperada de integracion, contrato, seguridad, pruebas y certificacion.
- Uso del CRM y Plugins PtD: articulos de operacion diaria y adopcion de la herramienta.
Como buscar
- Buscar por codigo PtD, nombre de tecnologia, dependencia, integracion, hito o tema operativo.
- Usar el Asistente PtD para preguntas rapidas; el chatbot devuelve articulos y fuentes relacionadas.
- Si la respuesta no existe, crear o ajustar un articulo en lugar de resolver el mismo tema por chats externos.
Mantenimiento
- Actualizar articulos cuando cambie contrato, criterio de aceptacion, flujo, dependencia, integracion o decision tecnica.
- No mezclar evidencia puntual de una tarea con criterio reutilizable; la evidencia vive en tarea o repositorio autorizado.
- Revisar que no existan credenciales, tokens, datos personales o informacion no aprobada.
Buenas practicas
- Escribir como guia operativa, no como propaganda: contexto, decision, pasos, riesgos y resultado esperado.
- Mantener titulos buscables y consistentes con codigos PtD.
- Usar ejemplos anonimizados y orientados a implementacion real.
Resultado esperado
La KB se vuelve una fuente confiable para operar, capacitar y auditar el proyecto sin perder criterio tecnico.