# Proyecto: Sistema de Gestión — Club de Amigos Taladro

## Identidad del Club
- **Nombre:** Club de Amigos Taladro (CAT)
- **Fundación:** 2006
- **Colores:** Verde Inglés, Blanco, Dorado, Negro
- **Usuario principal:** Pablo (pablosaracha@gmail.com)
- **Carpeta del proyecto:** `/Users/valentinamarti/Club_Amigos_Taladro/Sistema Gestion Taladro/`

---

## Archivos del proyecto

| Archivo | Descripción |
|---|---|
| `club_app.html` | App web principal (single-file, ~307KB) |
| `gestion_club.xlsx` | Planilla Excel con 7 hojas resumen |

---

## Stack técnico (club_app.html)

- **HTML/JS/CSS** vanilla — single file, sin frameworks
- **Persistencia:** `localStorage` con prefijo `taladro_`
- **Sesión:** `sessionStorage` (se limpia al cerrar el navegador)
- **Contraseñas:** SHA-256 via Web Crypto API (`crypto.subtle.digest`)
- **Logo:** escudo original del club, embebido en base64
- **Tema:** CSS variables, soporte dark/light mode

---

## Secciones de la app

| Sección | Función | Tabs |
|---|---|---|
| 🗂️ Administración | Socios, documentos, tareas | Padrón · Pagos MP · Deudores · Docs · Tareas · Config |
| 💰 Contabilidad | Ingresos, egresos, resumen | Ingresos · Egresos · Resumen · Tareas |
| 🔧 Mantenimiento | Tareas, proveedores | Tareas · Proveedores · Accionables |
| ⚽ Inferiores | Plantel, cuerpo técnico, torneos | Plantel · Técnicos · Torneos · Accionables |
| 🍔 Cantina | Stock, turnos | Stock · Turnos · Accionables |
| 📅 Eventos | Eventos del club | Lista · Accionables |
| 📢 Comunicaciones | Comunicados | Lista · Accionables |
| 🏟️ Instalaciones | Canchas, quincho, uso interno | Alquiler Canchas · Alquiler Quincho · Uso Interno · Accionables |

---

## Sistema de autenticación

- **Usuario admin por defecto:** `admin@taladro.com` / `taladro2006`
- Hash SHA-256 almacenado en localStorage (`taladro_users`)
- Sesión en sessionStorage (se cierra al cerrar el tab)
- Gestión de usuarios: página `pgUsers()` (solo admin/presidente)

---

## Roles y dashboards

| Rol | Dashboard por defecto | Acceso |
|---|---|---|
| presidente | general | Todo |
| tesorero | financiero | Finanzas + socios |
| secretaria | socios | Socios + comunicaciones |
| coord_inf | inferiores | Solo inferiores |
| encarg_mant | mantenimiento | Solo mantenimiento |
| encarg_cant | general | Cantina |
| encarg_inst | instalaciones | Instalaciones |

Dashboards disponibles: general, financiero, socios, inferiores, instalaciones, tareas, mantenimiento

---

## Integración Mercado Pago

- **Endpoint suscripciones:** `GET https://api.mercadopago.com/preapproval/search`
- **Endpoint pagos:** `GET https://api.mercadopago.com/v1/payments/search`
- **Cruce:** por email (email del socio en GForms = email pagador en MP)
- **Access Token:** guardado en `localStorage` clave `taladro_config` → `mp_token`
- **⚠️ CORS:** la app debe correr desde servidor local para que funcione MP
  - Comando: `python3 -m http.server 8080` → abrir `http://localhost:8080/club_app.html`
- Soporta tanto Suscripciones (preapproval) como Links de Pago (payments search)

---

## Integración Google Sheets

- **Planilla:** `1ICkxQZmUYfiM45revAdZXBf3vXhVwwvW22lfPQe1gB0`
- **GID (tab respuestas):** `1214400122`
- **URL CSV:** `https://docs.google.com/spreadsheets/d/{SID}/gviz/tq?tqx=out:csv&gid={GID}`
- **Requisito:** planilla compartida como "cualquier persona con el enlace puede ver"
- Sin API key — usa endpoint público de CSV de Google
- Función: `syncGSheets()` en `club_app.html`

---

## Historial de cambios principales

| Fecha | Cambio |
|---|---|
| Jun 2026 | Planilla Excel inicial (7 hojas) |
| Jun 2026 | App HTML single-file con todas las secciones |
| Jun 2026 | Logo original embebido (PDF → PNG → base64, flood-fill para transparencia) |
| Jun 2026 | Alquiler canchas y quincho en Instalaciones |
| Jun 2026 | 7 dashboards por rol configurables |
| Jun 2026 | Sistema de login con SHA-256, gestión de usuarios |
| Jun 2026 | Sync Google Forms + Mercado Pago, tab Deudores, tab Config |