Actualización de documentación con estado real del código y alcance del sprint
This commit is contained in:
38
README.md
38
README.md
@@ -2,7 +2,7 @@
|
||||
|
||||
> SaaS para reformistas en España. El cliente final del reformista deja sus datos en una landing, sube fotos de su cocina o baño, recibe en menos de 2 minutos una llamada de un agente IA desde un número fijo de su provincia, y al colgar recibe por WhatsApp un render IA del espacio reformado + presupuesto orientativo desglosado con el branding del reformista.
|
||||
|
||||
**Estado:** planificación completa, código sin empezar. Equipo de 4 personas, 3 semanas (24-may → 11-jun) hasta demo MVP.
|
||||
**Estado:** planificación completa. Código iniciado — landing B2C en Next.js ([`mvp/b2c/`](mvp/b2c/)) y prototipo estático de la landing B2B ([`mvp/b2b/`](mvp/b2b/)); backend y pipeline IA aún sin empezar. Equipo de 4 personas, 3 semanas (24-may → 11-jun) hasta demo MVP.
|
||||
|
||||
---
|
||||
|
||||
@@ -12,9 +12,19 @@ Si eres una **persona o agente IA nuevo en el proyecto**, lee en este orden:
|
||||
|
||||
1. [`CLAUDE.md`](CLAUDE.md) — Onboarding para agentes IA + comandos + convenciones (también útil para humanos)
|
||||
2. [`specs.md`](specs.md) — Requisitos formales (55 RF + 30 RNF en notación EARS)
|
||||
3. [`docs/dev-strategy.md`](docs/dev-strategy.md) — Cómo se va a construir (orden, equipo, milestones)
|
||||
4. [`devdocs/plan.md`](devdocs/plan.md) — Plan vivo de implementación
|
||||
5. [`devdocs/progress.md`](devdocs/progress.md) — Estado actual
|
||||
3. [`docs/funnel.md`](docs/funnel.md) — Diagrama del funnel punta a punta
|
||||
4. [`mvp/b2c/`](mvp/b2c/) — Código de la landing B2C (Next.js); ver su `README.md` propio
|
||||
|
||||
---
|
||||
|
||||
## Alcance del sprint (qué construimos)
|
||||
|
||||
Este sprint cubre **F1 + F2 de [`specs.md`](specs.md)**. Todo el producto vive en [`mvp/b2c/`](mvp/b2c/).
|
||||
|
||||
- ✅ **Landing B2C** (`mvp/b2c`).
|
||||
- ✅ **Funnel B2C completo end-to-end** (`mvp/b2c`): lead → fotos → llamada del agente de voz → render IA → presupuesto → WhatsApp → panel del reformista. **Demo del 11-jun.**
|
||||
- ✅ **Landing B2B** — solo la landing, puliendo [`mvp/b2b/landing_reformix.html`](mvp/b2b/landing_reformix.html). Sin backend de signup por ahora.
|
||||
- ⏸️ **Definido pero aparcado:** Fase 1.5 (multi-tenant, NL refinement, B/M/P, m² automático), Fase 2 (marketplace + valorador "Precio Justo"), doble nomenclatura.
|
||||
|
||||
---
|
||||
|
||||
@@ -25,7 +35,7 @@ Si eres una **persona o agente IA nuevo en el proyecto**, lee en este orden:
|
||||
| Doc | Para qué |
|
||||
|---|---|
|
||||
| [`specs.md`](specs.md) | Requisitos funcionales y no funcionales en EARS |
|
||||
| [`funnel.md`](funnel.md) | Diagrama del funnel punta a punta (ASCII + Mermaid + descripción Miro) |
|
||||
| [`docs/funnel.md`](docs/funnel.md) | Diagrama del funnel punta a punta (ASCII + Mermaid + descripción Miro) |
|
||||
| [`copy/COPY-GUIDE.md`](copy/COPY-GUIDE.md) | TODO el copy del producto (landings, agente voz, WhatsApp, emails) |
|
||||
| [`design/design-system.md`](design/design-system.md) | Sistema de diseño, identidad visual y verbal |
|
||||
| [`design/design-tokens.css`](design/design-tokens.css) | Tokens CSS custom properties |
|
||||
@@ -44,24 +54,22 @@ Si eres una **persona o agente IA nuevo en el proyecto**, lee en este orden:
|
||||
| [`negocio/roadmap.md`](negocio/roadmap.md) | Hitos por fase (hasta 18 meses) |
|
||||
| [`negocio/riesgos.md`](negocio/riesgos.md) | Matriz de riesgos + contingencias |
|
||||
| [`negocio/datos/`](negocio/datos/) | Costes desglosados, proveedores, KPIs |
|
||||
| [`investigacion-competencia-internacional.md`](investigacion-competencia-internacional.md) | Mapa de competidores + analogías (~5k palabras) |
|
||||
| [`docs/investigacion-competencia-internacional.md`](docs/investigacion-competencia-internacional.md) | Mapa de competidores + analogías (~5k palabras) |
|
||||
|
||||
### Desarrollo (código futuro)
|
||||
### Desarrollo
|
||||
|
||||
| Doc | Para qué |
|
||||
| Doc / dir | Para qué |
|
||||
|---|---|
|
||||
| [`CLAUDE.md`](CLAUDE.md) | Onboarding para agentes IA |
|
||||
| [`docs/dev-strategy.md`](docs/dev-strategy.md) | Estrategia de desarrollo, estructura, milestones |
|
||||
| [`devdocs/plan.md`](devdocs/plan.md) | Plan de implementación vivo |
|
||||
| [`devdocs/progress.md`](devdocs/progress.md) | Estado real |
|
||||
| [`devdocs/decisions.md`](devdocs/decisions.md) | Decisiones arquitectónicas (ADRs ligeros) |
|
||||
| [`CLAUDE.md`](CLAUDE.md) | Onboarding para agentes IA + comandos + convenciones |
|
||||
| [`mvp/b2c/`](mvp/b2c/) | Landing B2C en Next.js 16 (código activo) — tiene su propio `README.md` |
|
||||
| [`mvp/b2b/landing_reformix.html`](mvp/b2b/landing_reformix.html) | Prototipo estático de la landing B2B |
|
||||
|
||||
---
|
||||
|
||||
## Stack técnico (resumen)
|
||||
|
||||
```
|
||||
Frontend + Backend: Next.js 14 (App Router) → Vercel
|
||||
Frontend + Backend: Next.js 16 (App Router) → Vercel
|
||||
UI: Tailwind + shadcn/ui
|
||||
Agente de voz: Retell.ai + ElevenLabs (ES)
|
||||
Telefonía: Zadarma (fijos provinciales)
|
||||
@@ -75,6 +83,8 @@ Analytics: PostHog
|
||||
Testing: Vitest + Playwright
|
||||
```
|
||||
|
||||
> Implementado hoy: solo **Next.js + Tailwind** en [`mvp/b2c/`](mvp/b2c/). El resto es el stack objetivo de la fase F2 (MVP, 11-jun), aún sin integrar.
|
||||
|
||||
---
|
||||
|
||||
## Equipo
|
||||
|
||||
Reference in New Issue
Block a user