- README principal en español con guía de uso
- .gitignore para SO, editores, Python/Node y salidas
- plantillas/plantilla-reporte.md con frontmatter
- reportes/{semanal,mensual,hito,final} con README simple
- assets/ para imágenes embebidas
43 lines
1.6 KiB
Markdown
43 lines
1.6 KiB
Markdown
# Reportes
|
|
|
|
Repositorio central de reportes del equipo. Cada reporte se genera a partir de una
|
|
plantilla y se archiva según su tipo, de modo que el historial quede ordenado y sea
|
|
fácil encontrar versiones anteriores.
|
|
|
|
## Estructura
|
|
|
|
```text
|
|
.
|
|
├── README.md # esta guía
|
|
├── .gitignore # archivos ignorados por Git
|
|
├── plantillas/ # plantillas para crear nuevos reportes
|
|
│ └── plantilla-reporte.md
|
|
├── reportes/ # reportes archivados, uno por carpeta
|
|
│ ├── semanal/
|
|
│ ├── mensual/
|
|
│ ├── hito/
|
|
│ └── final/
|
|
└── assets/ # imágenes y binarios embebidos en los reportes
|
|
```
|
|
|
|
## Tipos de reporte
|
|
|
|
| Tipo | Carpeta | Descripción |
|
|
| --- | --- | --- |
|
|
| Semanal | `reportes/semanal/` | Avance de la semana: tareas, bloqueos, próximos pasos. |
|
|
| Mensual | `reportes/mensual/` | Resumen del mes con métricas y estado general. |
|
|
| Hito | `reportes/hito/` | Cierre de un hito o entregable del proyecto. |
|
|
| Final | `reportes/final/` | Informe final del proyecto. |
|
|
|
|
## Cómo agregar un reporte
|
|
|
|
1. Copia `plantillas/plantilla-reporte.md` a la carpeta de su tipo.
|
|
2. Nombra el archivo `AAAA-MM-DD-<slug>.md`, por ejemplo `2026-10-28-semana-44.md`.
|
|
3. Completa la tabla de metadatos (frontmatter) y el contenido.
|
|
4. Guarda las imágenes en `assets/` y referéncialas desde el reporte.
|
|
|
|
## Agregar un nuevo tipo de reporte
|
|
|
|
Crea una carpeta en `reportes/<nuevo-tipo>/` con su propio `README.md` describiendo
|
|
el formato, y copia la carpeta de un tipo existente como base.
|