ÁREA RESTRINGIDA
Esta documentación NO se comparte con el equipo operativo. Contiene decisiones arquitecturales, scripts internos, credenciales setup, y roadmap técnico. Si un empleado pide acceso, redirigílo a manual.brandacare.com.
Esta documentación NO se comparte con el equipo operativo. Contiene decisiones arquitecturales, scripts internos, credenciales setup, y roadmap técnico. Si un empleado pide acceso, redirigílo a manual.brandacare.com.
Arquitectura y estrategia
| ID | Documento | ES | EN |
|---|---|---|---|
TRN-IT-001 | Arquitectura Híbrida — Google Apps Script (PHI) + Netlify (UX) · cómo separamos HIPAA | ES | EN |
Setup técnico
| ID | Procedimiento | ES | EN |
|---|---|---|---|
SOP-IT-001 | Manual Auth Gate Setup — Google OAuth para los dos manuales | ES | EN |
Cómo se arma un doc nuevo
1 · En cualquier chat de Cowork
Trabajás un problema real y al final pedís:
Dame un resumen SOP en markdown para pasar al Manual BrandaCare. Estructura: título, propósito, tiempo, requisitos, pasos numerados, troubleshooting. Idioma: español.
2 · Pegás el resumen acá (chat del Manual)
Compartís el markdown crudo con Claude del proyecto Manual.
3 · Claude genera 2 HTMLs branded
ES + EN con icon system, sin emojis, mismo branding. Decide si va a manual público o tecnico según el contenido.
4 · Re-inyecta auth gate + index
python docs/inject_auth.py python docs/build_search_index.py
(o lo mismo en docs-tecnico/ si es del tecnico)
5 · Re-deploy a Netlify
Drag-drop la carpeta correspondiente. Live en 30 seg.
Scripts internos del manual
| Script | Función |
|---|---|
docs/inject_auth.py | Inyecta auth.js + manual.js en todos los HTMLs. Idempotente. |
docs/build_search_index.py | Genera search-index.json con todos los docs (titles + content + lang). |
docs/build_pdfs.py | Convierte HTMLs a PDFs en batch (requiere weasyprint). |
docs/parse_pdf_fee_schedule.py | Parsea PDFs de fee schedules de clientes a CSV. |
Brand kit
Logo + CSS + iconos (21 icons custom) + templates viven en brand/ de ambos sites.
Para arrancar el sistema en otro proyecto BrandaCare → leer
brand/BRAND-INSTRUCTIONS.md.
Bajar a PDF
- Una SOP: Chrome → Cmd+P → Save as PDF (activar Background graphics)
- Todas en batch:
pip install weasyprint && python docs/build_pdfs.py
Roadmap técnico
| Iniciativa | Status | Timing |
|---|---|---|
| Manual público estático + auth gate | ✓ Live | Junio 2026 |
| Manual técnico (este) + allowlist | ✓ Live | Junio 2026 |
| Embeber primer Apps Script form en el manual | Pendiente | Q3 2026 |
| Migrar primer form de Jotform a Apps Script | Pendiente | Q3 2026 |
| Migrar todos los forms PHI → cancelar Jotform | Pendiente | Q3-Q4 2026 |
| Migrar Python scripts (audit, AR audit) a Windows server | Pendiente | Q3 2026 |
| OPS Dashboard V1 (shell Netlify + widgets Apps Script) | Pendiente | Q4 2026 |
| Productivity Tracker en portal nuevo | Pendiente | Q4 2026 |
Allowlist actual
Estas son las únicas cuentas que pueden entrar acá. Para agregar/sacar gente, editar
docs-tecnico/brand/auth.js línea con ALLOWED_EMAILS.
| Rol | |
|---|---|
hello@brandacare.com | Yami B. (CEO) |
yami@brandacare.com | Yami B. (alias) |
pablo@brandacare.com | Pablo C. (Director Ops) |
quasar@brandacare.com | Quasar — IT Lead |
robert@brandacare.com | Robert Hazard (alias Quasar) |
santi@brandacare.com | Santi FP — Developer |
manuel@brandacare.com | Manuel VG — Developer |
Confirmar:
Los emails de cada admin son placeholders. Editá la lista en
brand/auth.js con los emails reales de cada uno.