Proyectos Interzone
Sistemas internos o propios: arquitectura, configuración, despliegue, operación, seguridad y roadmap.
KnowledgeBase Interzone
Esta base reúne la documentación técnica y operativa que Interzone necesita para mantener proyectos, webs de clientes, despliegues y decisiones pendientes sin depender de memoria, correos sueltos o manuales incompletos.
La usan principalmente el equipo Interzone y jefatura técnica. Por eso la documentación debe ser corta, directa y útil para operar.
Clientes
Webs, portales, APIs y activos digitales documentados por cliente.
Guías técnicas
Procedimientos reutilizables para Cloudflare, despliegue, migración e infraestructura.
Backlog
Ideas, modelos de negocio, decisiones pendientes y próximos pasos antes de convertirlos en proyecto.
Cómo se debe documentar
Sección titulada «Cómo se debe documentar»Todo activo relevante debe responder lo mínimo:
| Pregunta | Debe quedar claro |
|---|---|
| Qué es | Proyecto, web, API, servicio o integración. |
| Dónde está | URL, servidor, carpeta, repositorio o proveedor. |
| Con qué está hecho | Framework, lenguaje, base de datos, runtime y servicios externos. |
| Cómo se despliega | Pasos reales para publicar o actualizar. |
| Cómo se opera | Validaciones, logs, backups, rollback y responsables. |
| Qué falta | Pendientes, riesgos o datos por confirmar. |
Reglas mínimas
Sección titulada «Reglas mínimas»- No copiar manuales largos si se pueden resumir.
- No publicar contraseñas, tokens, usuarios reales sensibles ni cadenas de conexión productivas.
- Usar placeholders cuando haya secretos:
[PASSWORD],[USUARIO],[IP_INTERNA],[SECRET]. - Documentar lo que existe y marcar como Pendiente lo que no esté confirmado.
- Priorizar información útil para despliegue, soporte y migración.
Ubicación sugerida
Sección titulada «Ubicación sugerida»| Tipo | Carpeta |
|---|---|
| Proyecto Interzone | proyectos/<proyecto>/ |
| Cliente | clientes/<cliente>/ |
| Web o activo de cliente | clientes/<cliente>/<activo>.md |
| Guía reusable | guias/<tema>.md |
| Idea, propuesta o pendiente | backlog/ |
Criterio de cierre
Sección titulada «Criterio de cierre»Una página está lista cuando otra persona puede entender qué es el activo, dónde vive, cómo se publica y qué revisar si se migra o falla.