JohannVelazquez
93 lines
3.7 KiB
Markdown
93 lines
3.7 KiB
Markdown
# Bitácora — cómo registrar
|
|
|
|
Esta carpeta es el **registro vivo** del proyecto Balam. Cada vez que pase algo relevante —una llamada, un correo, un mensaje de WhatsApp, una decisión— se anota aquí. Así el proyecto siempre tiene una sola fuente de la verdad de "qué se dijo, cuándo y qué quedó pendiente".
|
|
|
|
## Archivos
|
|
|
|
| Archivo | Para qué |
|
|
|---|---|
|
|
| [REGISTRO.md](REGISTRO.md) | **Log cronológico** de toda comunicación (correos, llamadas, mensajes). Entradas numeradas, más antigua arriba. |
|
|
| [PENDIENTES.md](PENDIENTES.md) | **Acciones abiertas** (checklist). Lo que hay que hacer y quién. |
|
|
| [`../planeacion/Seguimiento-horas.md`](../planeacion/Seguimiento-horas.md) | Reglas, resumen y reconstrucción pendiente de horas efectivamente trabajadas. |
|
|
| [`../planeacion/Seguimiento-horas.csv`](../planeacion/Seguimiento-horas.csv) | Fuente tabular para conciliación con Jira y facturación. |
|
|
| `../fuentes/` | **Material crudo**: transcripciones, archivos `.eml`, PRD. No se edita; es evidencia. |
|
|
| `../README.md` | **Estado del proyecto** (resumen ejecutivo, datos clave, decisiones). Se actualiza cuando algo cambia el rumbo. |
|
|
|
|
## Flujo cuando pasa algo
|
|
|
|
1. **Pasa algo** (llamada / correo / mensaje / decisión).
|
|
2. **Guarda la evidencia** en `../fuentes/` si existe (transcripción, `.eml`, captura). Nómbrala con fecha: `2026-06-04 - Transcript - <tema>.txt`.
|
|
3. **Registra la entrada** en [REGISTRO.md](REGISTRO.md) con la plantilla que corresponda (ver abajo). Usa el siguiente número consecutivo.
|
|
4. **Mueve los pendientes** que surjan a [PENDIENTES.md](PENDIENTES.md).
|
|
5. Si cambió el **alcance, precio, plazo o una decisión clave**, actualiza también `../README.md`.
|
|
6. Si hubo trabajo facturable, registra el tiempo real el mismo día en `../planeacion/Seguimiento-horas.csv`; no infieras horas desde el porcentaje de avance.
|
|
|
|
> Regla de oro: si no está en la bitácora, no pasó. Registrar toma 2 minutos y evita malentendidos caros.
|
|
|
|
---
|
|
|
|
## Plantillas
|
|
|
|
Copia el bloque, pégalo en REGISTRO.md y rellena. La fecha en formato `AAAA-MM-DD`.
|
|
|
|
### 📞 Llamada / reunión
|
|
|
|
```markdown
|
|
## N · AAAA-MM-DD HH:MM · Llamada · <tema>
|
|
|
|
> Participan: <nombres>. Canal: Teams / tel / presencial. Evidencia: `../fuentes/<archivo>` (si hay).
|
|
|
|
**Resumen:** <2-4 líneas de qué se trató.>
|
|
|
|
**Acuerdos / decisiones:**
|
|
- <decisión 1>
|
|
- <decisión 2>
|
|
|
|
**Pendientes que surgieron:**
|
|
- [ ] <responsable> — <acción> — <fecha objetivo>
|
|
|
|
**Citas relevantes:** *"<frase textual importante>"*
|
|
```
|
|
|
|
### ✉️ Correo
|
|
|
|
```markdown
|
|
## N · AAAA-MM-DD HH:MM · Correo · <De> → <Para> · <asunto>
|
|
|
|
> Dirección: enviado / recibido. Evidencia: `../fuentes/<archivo>.eml` (si se guardó).
|
|
|
|
**Resumen:** <qué dice.>
|
|
**Acción derivada:** <qué hay que hacer, si aplica.>
|
|
**Adjuntos:** <nombre del adjunto, si hay.>
|
|
```
|
|
|
|
### 💬 Mensaje (WhatsApp / Teams chat)
|
|
|
|
```markdown
|
|
## N · AAAA-MM-DD · Mensaje (WhatsApp) · <De> → <Para>
|
|
|
|
**Resumen:** <qué se dijo.>
|
|
**Acción:** <si aplica.>
|
|
```
|
|
|
|
### ⚖️ Decisión
|
|
|
|
```markdown
|
|
## N · AAAA-MM-DD · Decisión · <título>
|
|
|
|
**Contexto:** <por qué se decide.>
|
|
**Decisión:** <qué se decidió.>
|
|
**Aprobada por:** <quién.>
|
|
**Impacto:** alcance / precio / tiempo — <detalle.>
|
|
```
|
|
|
|
---
|
|
|
|
## Convenciones
|
|
|
|
- **Una entrada por evento**, numeradas y en orden cronológico (más reciente al final, igual que el hilo actual).
|
|
- **Evidencia cruda en `../fuentes/`**, nunca editada; el resumen interpretado va en REGISTRO.md.
|
|
- **Pendientes** siempre con responsable y fecha; al cerrarse se marcan `[x]` en PENDIENTES.md (no se borran, dejan rastro).
|
|
- **Fechas absolutas** (`2026-06-04`), nunca "ayer" o "la próxima semana".
|
|
- Citas textuales entre comillas y en *cursiva* para distinguir lo dicho de la interpretación.
|