[TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS] refactor: Migrate to canonical apps/ structure (ADR-0011)

- backend/ → apps/backend/, frontend/ → apps/frontend-web/
- database/ → apps/database/, mobile/ → apps/frontend-mobile/
- mcp-server/ → apps/mcp-server/, whatsapp-service/ → apps/whatsapp-service/
- Updated .gitmodules, docker-compose.yml, CLAUDE.md v1.0.0
- Added apps/_MAP.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.gitmodules

@@ -1,23 +1,23 @@
 [submodule "backend"]
-	path = backend
+	path = apps/backend
 	url = git@gitea-server:rckrdmrd/michangarrito-backend-v2.git
 
 [submodule "database"]
-	path = database
+	path = apps/database
 	url = git@gitea-server:rckrdmrd/michangarrito-database-v2.git
 
 [submodule "frontend"]
-	path = frontend
+	path = apps/frontend-web
 	url = git@gitea-server:rckrdmrd/michangarrito-frontend-v2.git
 
 [submodule "mcp-server"]
-	path = mcp-server
+	path = apps/mcp-server
 	url = git@gitea-server:rckrdmrd/michangarrito-mcp-server-v2.git
 
 [submodule "mobile"]
-	path = mobile
+	path = apps/frontend-mobile
 	url = git@gitea-server:rckrdmrd/michangarrito-mobile-v2.git
 
 [submodule "whatsapp-service"]
-	path = whatsapp-service
+	path = apps/whatsapp-service
 	url = git@gitea-server:rckrdmrd/michangarrito-whatsapp-service-v2.git

CLAUDE.md

@@ -4,8 +4,9 @@
 **Sistema:** SIMCO v4.3.0 + NEXUS v4.0
 **Proyecto:** michangarrito
 **Tipo:** CONSUMER (de template-saas)
-**Versión:** 0.9.5
+**Versión:** 1.0.0
-**Actualizado:** 2026-01-24
+**Actualizado:** 2026-02-06
+**ADR Vinculante:** ADR-0011 (Estructura Canonica apps/)
 
 ---
 
@@ -55,21 +56,26 @@ Redis Port: 6389
 
 ---
 
-## ESTRUCTURA DEL MONOREPO
+## ESTRUCTURA CANONICA (ADR-0011)
 
 ```
 michangarrito/
-├── apps/
+├── apps/                          # Contenedor canonico de aplicaciones
-│   ├── backend/          → NestJS API (23 módulos)
+│   ├── backend/                   # NestJS API (submodule, 23 modulos)
-│   ├── frontend/         → React Web App
+│   ├── frontend-web/              # React Web App (submodule)
-│   ├── mobile/           → React Native (Expo)
+│   ├── frontend-mobile/           # React Native Expo (submodule)
-│   ├── mcp-server/       → Gateway LLM (15 herramientas)
+│   ├── mcp-server/                # Gateway LLM (submodule, 15 herramientas)
-│   ├── whatsapp-service/ → Meta Cloud API
+│   ├── whatsapp-service/          # Meta Cloud API (submodule)
-│   └── database/         → DDL (11 schemas)
+│   ├── database/                  # DDL PostgreSQL (submodule, 11 schemas)
-├── orchestration/        → Sistema SIMCO
+│   └── _MAP.md                    # Indice de aplicaciones
-└── docs/                 → Documentación
+├── orchestration/                 # Sistema SIMCO local
+├── docs/                          # Documentacion
+├── .claude/                       # Instrucciones Claude Code
+└── .gitmodules                    # 6 submodules en apps/
 ```
 
+**IMPORTANTE:** Todo desarrollo nuevo DEBE ir dentro de `apps/`. No crear archivos en raiz.
+
 ---
 
 ## MODULOS BACKEND (23)
@@ -166,12 +172,12 @@ Además de las validaciones del workspace:
 
 2. **Frontend:**
    ```bash
-   cd apps/frontend && npm run build && npm run lint
+   cd apps/frontend-web && npm run build && npm run lint
    ```
 
 3. **Mobile:**
    ```bash
-   cd apps/mobile && npx expo doctor
+   cd apps/frontend-mobile && npx expo doctor
    ```
 
 ---
@@ -179,8 +185,8 @@ Además de las validaciones del workspace:
 ## ALIASES LOCALES
 
 - `@BACKEND` → apps/backend/src/modules/
-- `@FRONTEND` → apps/frontend/src/
+- `@FRONTEND` → apps/frontend-web/src/
-- `@MOBILE` → apps/mobile/src/
+- `@MOBILE` → apps/frontend-mobile/src/
 - `@WHATSAPP` → apps/whatsapp-service/
 - `@MCP` → apps/mcp-server/
 - `@DDL` → apps/database/
@@ -221,4 +227,9 @@ Bloqueadores para Producción:
 
 ---
 
-*MiChangarrito v0.9.5 - Sistema SIMCO v4.3.0*
+- `@APPS-MAP` → apps/_MAP.md
+
+---
+
+*MiChangarrito v1.0.0 - Sistema SIMCO v4.0.0*
+*Estructura migrada a apps/ canonico: 2026-02-06*

apps/_MAP.md

@@ -0,0 +1,31 @@
+# _MAP: Aplicaciones de michangarrito
+
+**Carpeta:** apps/
+**Proposito:** Contenedor canonico de todas las aplicaciones del proyecto (ADR-0011)
+**Estado:** Activo
+**Ultima actualizacion:** 2026-02-06
+
+---
+
+## Aplicaciones
+
+| App | Ruta | Tipo | Stack | Estado | Git |
+|-----|------|------|-------|--------|-----|
+| **Backend API** | `apps/backend/` | API REST | NestJS 10 + TypeScript | Activo | Submodule (michangarrito-backend-v2) |
+| **Frontend Web** | `apps/frontend-web/` | SPA | React 19 + Vite | Activo | Submodule (michangarrito-frontend-v2) |
+| **Frontend Mobile** | `apps/frontend-mobile/` | Mobile App | React Native Expo SDK 51 | Activo | Submodule (michangarrito-mobile-v2) |
+| **MCP Server** | `apps/mcp-server/` | LLM Gateway | Node.js + 15 tools | Activo | Submodule (michangarrito-mcp-server-v2) |
+| **WhatsApp Service** | `apps/whatsapp-service/` | Messaging | Meta Cloud API | Activo | Submodule (michangarrito-whatsapp-service-v2) |
+| **Database** | `apps/database/` | DDL | PostgreSQL 16+ | Activo | Submodule (michangarrito-database-v2) |
+
+---
+
+## Notas
+
+- Migrado a estructura apps/ canonica (ADR-0011) 2026-02-06
+- 6 submodulos git separados (POLYREPO)
+- Proyecto con mayor cantidad de submodulos en el workspace
+
+---
+
+*Generado por TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS (Sprint 4)*

docker-compose.yml

@@ -28,9 +28,9 @@ services:
       PGDATA: /var/lib/postgresql/data/pgdata
     volumes:
       - postgres_data:/var/lib/postgresql/data
-      - ./database/schemas:/docker-entrypoint-initdb.d/schemas:ro
+      - ./apps/database/schemas:/docker-entrypoint-initdb.d/schemas:ro
-      - ./database/seeds:/docker-entrypoint-initdb.d/seeds:ro
+      - ./apps/database/seeds:/docker-entrypoint-initdb.d/seeds:ro
-      - ./database/init:/docker-entrypoint-initdb.d:ro
+      - ./apps/database/init:/docker-entrypoint-initdb.d:ro
     ports:
       - "${DB_PORT:-5432}:5432"
     healthcheck: