Compare commits

...

2 Commits

4 changed files with 24 additions and 11 deletions
+2 -1
View File
@@ -2,7 +2,7 @@
> **Fuente de la verdad del proyecto.** Este repositorio concentra todo: propuesta, comunicaciones, fuentes y prototipos. Si pasa algo (llamada, correo, mensaje, decisión), se registra en la [bitácora](bitacora/). Empieza por aquí.
**Estado:** 🟢 **Discovery en marcha (Etapa 0)** — contrato firmado (26-jun), kickoff realizado (1-jul), **primera sesión de Discovery realizada (6-jul: proceso de facturación mapeado end-to-end con Ara y Arturo)**. Cambios de reglas del 6-jul: **lista blanca eliminada** (recordatorios a todos) y **cotización BIND obligatoria**. Johann trabaja el **prototipo** con el flujo real. Bloqueadores: (1) **token BIND** — ya en gestión por Erika (6-jul; entrega esperada lun 6mar 7 jul, por correo), además de repo y Azure; (2) confirmación de Balam a la propuesta v1.2 (enviada 2-jul) para emitir la **factura de 30 h**.
**Estado:** 🟢 **Discovery en marcha (Etapa 0)** — contrato firmado (26-jun), kickoff realizado (1-jul), **primera sesión de Discovery realizada (6-jul: proceso de facturación mapeado end-to-end con Ara y Arturo)**. Cambios de reglas del 6-jul: **lista blanca eliminada** (recordatorios a todos) y **cotización BIND obligatoria**. Johann trabaja el **prototipo** con el flujo real. Bloqueadores: (1) **token BIND** — ya **generado** (6-jul, 12:10 pm); Erika lo envía por correo — quedan repo y Azure; (2) confirmación de Balam a la propuesta v1.2 (enviada 2-jul) para emitir la **factura de 30 h**.
_Última actualización: 2026-07-06._
---
@@ -23,6 +23,7 @@ Plataforma web para centralizar y automatizar **facturación y cobranza** de Bal
| [`.claude/skills/proposal-pdf/`](.claude/skills/proposal-pdf/) | **Skill** que genera el PDF de la propuesta/cotización con diseño editorial (portada full-bleed, TOC con páginas reales, footers "Confidential"). Pipeline Chromium + 2 pasos. Setup y uso en su [SKILL.md](.claude/skills/proposal-pdf/SKILL.md) (incluye nota de Windows). |
| [`planeacion/`](planeacion/) | **Plan de ejecución:** [Plan-actividades.xlsx](planeacion/Plan-actividades.xlsx) (+ [`.md`](planeacion/Plan-actividades.md)) — actividades por etapa (03) con fechas, responsables y sesiones, para el seguimiento con Erika (Jira/Gantt). |
| [`marca/`](marca/) | **Tokens de marca** ([Marca-Balam.md](marca/Marca-Balam.md)) destilados del manual de imagen corporativa: color (Amarillo `#F7BD0C`, Café `#331F0E`), tipografía (Poppins) y uso del logo, para el prototipo y la UI. Manual crudo en [`fuentes/`](fuentes/). |
| [`prototipo/`](prototipo/) | **Prototipo visual navegable (Etapa 0):** [Prototipo-Etapa0.html](prototipo/Prototipo-Etapa0.html) — HTML autocontenido (doble clic) con el flujo real del Discovery 6-jul: Jira → cotización BIND → prefactura → validación humana → CFDI → envío por cliente + cobranza y bitácora. Marca Balam (café/amarillo, Poppins), datos ficticios. Para validar con Ara, Arturo y Pedro. |
## 3. Datos clave
+2 -2
View File
@@ -9,7 +9,7 @@ _Última actualización: 2026-07-06 (Discovery realizado: proceso mapeado, lista
- [x] ~~**Asistir al kickoff con Noé (mié 1-jul, 7:00 am)**~~**Hecho (1-jul).** Ver [REGISTRO #22](REGISTRO.md).
- [x] ~~📅 **Asistir a la sesión "Proceso actual de facturación y cobranza" (lun 6-jul, 7:00 am)**~~**Hecha (6-jul).** Proceso mapeado end-to-end; lista blanca eliminada; cotización BIND obligatoria. Ver [REGISTRO #27](REGISTRO.md).
- [ ] 🎨 **Trabajar el prototipo (Etapa 0)** reflejando el flujo real levantado el 6-jul: Jira (disparador) → cotización BIND → prefactura → validación humana → CFDI → envío. Incluir las validaciones de oro: **PPD default** (PUE consciente — ya les costó un requerimiento del SAT), **IVA 16% MXN / 0% extranjero** (BIND no lo automatiza), prefactura siempre antes de timbrar, alta de cliente como flujo aparte. Ver [REGISTRO #27](REGISTRO.md).
- [ ] Confirmar con Erika si la sesión del **martes 7-jul** sigue en pie — probablemente ya no es necesaria (las dudas quedaron resueltas el lunes). Ver [REGISTRO #27](REGISTRO.md).
- [ ] 📅 **Proponer a Erika usar la sesión del martes 7-jul para COBRANZA** — la sesión del lunes solo cubrió facturación (Jira → BIND → envío); el proceso de cobranza quedó sin mapear: cómo dan seguimiento hoy a los pagos, quién persigue morosos, cómo concilian cuentas por cobrar, de dónde saldría el aging. Ver [REGISTRO #27](REGISTRO.md).
- [ ] ⚠️ **Aclarar expectativa de recordatorios a clientes:** lo que Ara/Arturo describieron el 6-jul son recordatorios automáticos **a clientes**, que están **diferidos al Anexo B** (el MVP trae alertas *internas*). Aclararlo pronto o anticipar que pidan ese módulo al cierre del MVP. Igual con la idea de **agentes observando Jira** (Nivel 3, fase posterior) y el deseo **multi-empresa** (Regiotour, Elmstone). Ver [REGISTRO #27](REGISTRO.md).
- [x] ~~**Ajustar la propuesta** (30 h explícitas, sin "Etapa 0", términos comerciales en una sección)~~**Hecho (1-jul):** propuesta **v1.2** — se agregó el concepto **"Facturación inicial: 30 h / $18,000 + IVA"** (cubre Etapa 0 + inicio de Etapa 1; Etapa 0 se mantiene en 1822 h) y se consolidó **§3.3 Condiciones comerciales**. Fuente MD actualizada; **falta regenerar el PDF** (lo hace el agente de PDF de Johann con el mismo cambio).
- [x] ~~📧 **Enviar el correo** (Noé, CC Pedro, Ara, Erika) con la propuesta v1.2 ajustada, vinculando la **facturación inicial de 30 h** al acuerdo~~**Hecho (2-jul, 5:39 PM):** enviado con `Propuesta-Balam.pdf` adjunto, sin esperar el correo de Erika+Paola. Ver [REGISTRO #26](REGISTRO.md).
@@ -40,7 +40,7 @@ _Última actualización: 2026-07-06 (Discovery realizado: proceso mapeado, lista
- [x] ~~**Noe:** formalizar por correo~~**Hecho:** aclaraciones (8-jun, [#15](REGISTRO.md)) y **luz verde + redacción del documento de firma** (16-jun, [#17](REGISTRO.md)).
- [ ] **Pedro + Erika:** armar el **tablero de seguimiento en Jira** y revisarlo juntos (instruido formalmente por Noe el 16-jun).
- [x] ~~**Pedro:** enviar **manual de marca**~~**Hecho (1-jul):** enviado por correo. Tokens en [`../marca/Marca-Balam.md`](../marca/Marca-Balam.md). Ver [REGISTRO #23](REGISTRO.md).
- [ ] **Erika/Pedro:** entregar el **token de BIND** (del usuario de **Arturo**, cuenta mayor / todos los permisos); dejar el de **Ara** para el Power BI. **SOLICITADO internamente por Erika (6-jul, 10:26 am)** tras confirmar con Johann que solo se necesita el token; entrega esperada **martes 7-jul temprano** para la validación técnica (marmié del plan). Al recibirlo: **confirmar de qué usuario salió** (documentar cuál llave es para qué) y tratarlo como llave de **producción**. Ver [REGISTRO #28](REGISTRO.md).
- [ ] **Erika:** entregar el **token de BIND** **ya GENERADO (6-jul, 12:10 pm)**, lo tienen en un .txt; Erika lo enviará **por correo**. Al recibirlo, Johann debe: **confirmar de qué usuario salió** (el acuerdo fue el de **Arturo** para dev; el de Ara queda para Power BI — documentar cuál llave es para qué), guardarlo en **gestor de secretos** (no dejarlo en correo/txt) y arrancar la **validación técnica de endpoints** (mar 7 mié 8 del plan, sin sesión). Ver [REGISTRO #28](REGISTRO.md).
- [ ] **Pedro:** crear el **repositorio GitHub privado** para backend/frontend (Fase 12).
- [ ] **Pedro:** enseñar a Johann el **flujo de Jira** (reporte de horas como los demás consultores).
- [ ] **Pedro + Noé:** **configurar Azure** y permisos (Noé otorga donde Pedro tiene limitantes).
+7 -6
View File
@@ -504,7 +504,7 @@ Johann envía la **propuesta v1.2** (30 h de facturación inicial explícitas, c
> Participan: **Araceli Sánchez** (comercial/dirección), **Arturo Rosas Hernández** (administración/facturación), Erika Chávez y Johann. Noé era opcional y no asistió. Canal: Microsoft Teams (~1 h 5 min). Evidencia: `../fuentes/2026-07-06 Proceso actual de facturación y cobranz_ Transcript.txt`.
**Resumen:** Primera sesión de Discovery (Etapa 0). Araceli y Arturo muestran en vivo el proceso completo de facturación: entrada por **Jira ITSM** (obligatoria desde hace ~1 mes) → validación de administración → **prefactura en BIND** → emisión de CFDI → **envío por correo con particularidades por cliente**. Se demostró el flujo real en BIND (crearon y cancelaron una prefactura en vivo). Dos reglas de negocio cambiaron en la propia sesión.
**Resumen:** Primera sesión de Discovery (Etapa 0). Araceli y Arturo muestran en vivo el proceso completo de **facturación**: entrada por **Jira ITSM** (obligatoria desde hace ~1 mes) → validación de administración → **prefactura en BIND** → emisión de CFDI → **envío por correo con particularidades por cliente**. Se demostró el flujo real en BIND (crearon y cancelaron una prefactura en vivo). Dos reglas de negocio cambiaron en la propia sesión. **La parte de cobranza NO se cubrió** — solo se tocaron la lista blanca y la idea de recordatorios; el proceso de seguimiento de pagos queda pendiente de mapear (cuando Johann preguntó si después seguía cobranza, Ara redirigió al proceso de envío de factura).
### El proceso actual, paso a paso
@@ -552,7 +552,7 @@ Johann envía la **propuesta v1.2** (30 h de facturación inicial explícitas, c
> - **Jira como disparador del flujo** (agentes observando tickets/botones) se parece al "Nivel 3" (generación desde eventos) que estaba en fase posterior. La integración con la API de Jira no está cotizada en el MVP — vigilar ese límite de alcance cuando se diseñe el prototipo.
> - **Se levantaron reglas de validación de oro para la plataforma:** PPD por default (PUE solo consciente — ya les costó un requerimiento del SAT) · IVA 16% MXN / 0% extranjero-sin efectos fiscales (BIND no lo automatiza) · prefactura SIEMPRE antes de timbrar · OC/cotización como prerequisito · alta de cliente como flujo aparte.
> - **El token de BIND NO se tocó en la sesión** — sigue abierto desde el kickoff y el WhatsApp del 2-jul ([#25](#25--jul-2-2026--418441-pm--whatsapp-erika--johann--agendamateriales-para-la-sesión-del-6-jul)).
> - La sesión del **martes 7-jul** probablemente ya no sea necesaria (Johann cerró diciendo que sus dudas quedaron resueltas) — confirmar con Erika.
> - **La cobranza quedó sin mapear** — la sesión del **martes 7-jul** (que Erika mencionó desde el 1-jul) sería el espacio natural para cubrirla: cómo dan seguimiento hoy a los pagos, quién persigue morosos, cómo concilian cuentas por cobrar, y de dónde saldría el aging. Proponérselo a Erika.
> - **Multi-empresa** (Regiotour, Elmstone) aparece como deseo de futuro de Ara — anotarlo para el roadmap, no para el MVP.
---
@@ -565,12 +565,13 @@ Tras la sesión de Discovery (78 am, [#27](#27--jul-6-2026--700-am--llamada--
- **9:01** — Sobre *"Entrega y validación de accesos (BIND, Azure, manual de marca) · lun 06 → mar 07 jul"*: *"¿solo necesitas el token tal cual?"* **Johann (9:539:54):** *"Sí, para BIND solo necesito el token tal cual. Lo de Azure no me urge hoy y el manual de marca ya lo tengo."*
- **10:26** — Erika: *"okey deja lo solicito"***el token queda formalmente solicitado dentro de Balam.**
- **10:28** — Sobre *"Validación técnica de la API de BIND con la cuenta real · mar 07 → mié 08 jul"*: *"¿se necesita una sesión?"* **Respuesta de Johann:** no — es trabajo propio con el token en mano (probar endpoints y compartir resumen de hallazgos); solo si algo no cuadra (permisos/cobertura) pediría 1520 min con Pedro o Arturo. Pide el token **martes temprano** para cumplir las fechas del plan.
- **10:2810:37** — Sobre *"Validación técnica de la API de BIND con la cuenta real · mar 07 → mié 08 jul"*: *"¿se necesita una sesión?"* **Johann (10:37):** *"No, esa validación la hago yo por mi cuenta ya teniendo el token."*
- **12:1012:19** — **Token GENERADO** dentro de Balam: *"ya solicitaran el token ahorita te lo comparto"*. Erika desconoce si tiene vencimiento (según el kickoff: no caduca), comenta que lo tienen en un **.txt** y pregunta si sirve **por correo**.
> **Lectura estratégica:**
> - **El bloqueador del token por fin tiene tracción:** Erika lo gestiona activamente contra el plan de actividades y ya lo **solicitó internamente** (10:26). Primera respuesta real al seguimiento que Johann venía haciendo desde el 2-jul ([#25](#25--jul-2-2026--418441-pm--whatsapp-erika--johann--agendamateriales-para-la-sesión-del-6-jul)).
> - **El bloqueador del token quedó prácticamente resuelto el mismo día:** solicitado a las 10:26 y generado antes de las 12:10 — un día antes de la fecha del plan (mar 7-jul). Primera respuesta real al seguimiento que Johann venía haciendo desde el 2-jul ([#25](#25--jul-2-2026--418441-pm--whatsapp-erika--johann--agendamateriales-para-la-sesión-del-6-jul)).
> - Que Erika trabaje sobre el plan de actividades confirma que **el Excel de Johann es el instrumento real de seguimiento** — mantenerlo al día paga.
> - Pendiente de higiene: al recibir el token, **confirmar de qué usuario salió** (documentar cuál llave es para qué — acuerdo del kickoff) y tratarlo como **llave de producción** (sin sandbox).
> - Pendiente de higiene al recibirlo: **confirmar de qué usuario salió** (el acuerdo fue el de **Arturo** para desarrollo; documentar cuál llave es para qué) y tratarlo como **llave de producción** (sin sandbox) — guardarlo en gestor de secretos, no dejarlo en el correo/txt.
---
@@ -602,7 +603,7 @@ Tras la sesión de Discovery (78 am, [#27](#27--jul-6-2026--700-am--llamada--
2. **Correo del 25-may**: Noe pide explícitamente que la **propuesta se recorte a "solo ERP BIND" primero**, dejando bancos/conciliación para fase posterior.
### Estado actual (al 6-jul-2026 — Discovery en marcha)
**Contrato FIRMADO (26-jun)**, **kickoff realizado (1-jul)** y **primera sesión de Discovery realizada (6-jul, 7am, con Ara + Arturo — [#27](#27--jul-6-2026--700-am--llamada--discovery-proceso-actual-de-facturación-y-cobranza-)).** El proceso actual quedó mapeado end-to-end: **Jira ITSM (mandatorio) → validación administración → prefactura BIND → CFDI → envío por correo con particularidades por cliente**. Dos reglas cambiaron en la sesión: **lista blanca eliminada** (recordatorios a todos) y **cotización BIND obligatoria** como inicio del flujo. Ara/Arturo deben enviar hoy el **Excel de particularidades de envío**; Johann trabaja el **prototipo** con el flujo real. **Propuesta v1.2 enviada (2-jul)** — en espera de confirmación de Balam para emitir la factura de 30 h. **Token de BIND sigue pendiente** (no se tocó en la sesión).
**Contrato FIRMADO (26-jun)**, **kickoff realizado (1-jul)** y **primera sesión de Discovery realizada (6-jul, 7am, con Ara + Arturo — [#27](#27--jul-6-2026--700-am--llamada--discovery-proceso-actual-de-facturación-y-cobranza-)).** El proceso de **facturación** quedó mapeado end-to-end: **Jira ITSM (mandatorio) → validación administración → prefactura BIND → CFDI → envío por correo con particularidades por cliente**. **La cobranza sigue sin mapear** (candidata para la sesión del martes 7-jul). Dos reglas cambiaron en la sesión: **lista blanca eliminada** (recordatorios a todos) y **cotización BIND obligatoria** como inicio del flujo. Ara/Arturo deben enviar hoy el **Excel de particularidades de envío**; Johann trabaja el **prototipo** con el flujo real. **Propuesta v1.2 enviada (2-jul)** — en espera de confirmación de Balam para emitir la factura de 30 h. **Token de BIND sigue pendiente** (no se tocó en la sesión).
**Definido en el kickoff:** token **de Arturo** para BIND (solo consulta; se prueba primero) · **Balam crea el repo** (GitHub privado) y **gestiona Azure** (Pedro+Noé) · Johann reporta **horas en Jira** (Pedro le enseña; corte de Erika los lunes) · Discovery **con Arturo + Araceli** (Erika agenda). **Dos bloqueadores vivos:** (1) **accesos** (token BIND, Azure, repo) y (2) **emisión de la 1ª factura** — Johann ya envió la propuesta v1.2 ajustada (2-jul); **no factura hasta que Balam confirme por correo**.
@@ -30,9 +30,20 @@ Erika revisa el plan de actividades (línea: **"Entrega y validación de accesos
> **Johann** *(9:53)*: Sii, para BIND solo necesito el token tal cual
> **Johann** *(9:54)*: Lo de azure no me urge hoy y el manual de marca ya lo tengo, gracias:)
## Bloque 4 — 10:2610:28 AM — Erika solicita el token y pregunta por la validación técnica
## Bloque 4 — 10:2610:37 AM — Erika solicita el token y pregunta por la validación técnica
> **Erika** *(10:26, citando a Johann)*: okey deja lo solicito
> **Erika** *(10:28)*: y sobre esto, se necesita una sesion?
> **Johann** *(10:37)*: No, esa validación la hago yo por mi cuenta ya teniendo el token
> **Erika** *(10:37)*: ah okey
La segunda pregunta refiere a la línea del plan: **"Validación técnica de la API de BIND con la cuenta real · 2 días · mar 07/07 → mié 08/07"**. Respuesta de Johann: no se necesita sesión — es trabajo propio con el token en mano (probar endpoints y compartir resumen); solo si algo no cuadra (permisos/cobertura) pediría 1520 min con Pedro o Arturo. Pide el token idealmente el martes temprano para cumplir las fechas del plan.
La pregunta de las 10:28 refiere a la línea del plan: **"Validación técnica de la API de BIND con la cuenta real · 2 días · mar 07/07 → mié 08/07"**.
## Bloque 5 — 12:1012:19 PM — token generado; entrega por correo
> **Erika** *(12:10)*: johan ya solicitaran el token ahorita te lo comparto
> **Erika** *(12:10)*: desconozco si tiene vencimiento
> **Erika** *(12:18)*: me comentan que tienen el txt o que como lo necesitas
> **Erika** *(12:19)*: por correo te sirve?
El token ya fue generado dentro de Balam (lo tienen en un .txt); Erika pregunta el formato y ofrece enviarlo por correo. *(Nota: según el kickoff, los tokens de BIND no caducan — 1 por usuario, no caducable. Queda por confirmar de qué usuario salió — el acuerdo fue el de Arturo para desarrollo.)*