hola@amaren.ventures

Docs

Decisiones técnicas, guías internas y borradores legales.

21 archivos·12 tareas

0% completado

¿Qué es esto?

Memoria de largo plazo del proyecto. Decisiones arquitectónicas (ADRs), guías para nuevas incorporaciones y borradores legales (términos, política de privacidad).

No es lo mismo que esta Dev Hub: aquí viven textos estables, en /dev-hub vive la guía operativa del día a día.

Stack técnico

  • Markdown
  • MDX (para algún diagrama)
  • GitHub (versionado)

Estructura de carpetas

docs/
├── adr/                 decisiones arquitectónicas numeradas
├── guides/
│   ├── onboarding.md
│   └── contributing.md
├── legal/
│   ├── terms.md
│   ├── privacy.md
│   └── dpa.md
└── product/
    └── glossary.md

Archivos clave

ArchivoQué hacePrioridad
adr/0001-monorepo.mdPor qué Turborepo.Media
adr/0002-microservicios.mdPor qué 8 servicios y no uno.Media
guides/onboarding.mdCómo empieza alguien nuevo.Alta
legal/privacy.mdPolítica de privacidad (borrador).Alta
legal/terms.mdTérminos de servicio (borrador).Alta
product/glossary.mdGlosario interno: familia, tutor, dispositivo...Baja
architecture/adr-006-byod-control-levels.mdADR que establece los 3 niveles de control (BLANK-Owned / BYOD Full / BYOD Limited).Alta
guides/enrollment-flows.mdFlujos de enrollment paso a paso para cada modo.Alta
legal/byod-disclaimer.mdDisclaimer legal sobre límites del modo BYOD.Alta
architecture/capability-matrix.csvMatriz completa feature × modo (fuente de verdad importable).Media

Cómo ejecutarlo

Abrir los docs en local con preview

pnpm --filter docs dev

Validar links rotos

pnpm --filter docs lint

Qué falta

0 de 12 completados
Alta Media Baja

Dependencias con otros módulos

  • No tiene dependencias técnicas con otros módulos.
  • Los borradores legales necesitan revisión externa antes de publicarse.