feat: estructura del repositorio para reportes por tipo
- 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
This commit is contained in:
@@ -1,2 +1,42 @@
|
||||
# reports
|
||||
# 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.
|
||||
|
||||
Reference in New Issue
Block a user