[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/
- Updated .gitmodules, CLAUDE.md v2.0.0
- Added apps/_MAP.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-02-06 10:30:14 -06:00
parent 49afd7ff52
commit 04c2db7bbc
24 changed files with 57 additions and 23 deletions

6
.gitmodules vendored
View File

@ -1,9 +1,9 @@
[submodule "backend"]
path = backend
path = apps/backend
url = git@gitea-server:rckrdmrd/erp-transportistas-backend-v2.git
[submodule "frontend"]
path = frontend
path = apps/frontend-web
url = git@gitea-server:rckrdmrd/erp-transportistas-frontend-v2.git
[submodule "database"]
path = database
path = apps/database
url = git@gitea-server:rckrdmrd/erp-transportistas-database-v2.git

View File

@ -4,8 +4,9 @@
**Sistema:** SIMCO v4.0.0 + NEXUS v4.0
**Proyecto:** erp-transportistas
**Tipo:** CONSUMER (Vertical ERP)
**Version:** 1.0.0
**Actualizado:** 2026-01-25
**Version:** 2.0.0
**Actualizado:** 2026-02-06
**ADR Vinculante:** ADR-0011 (Estructura Canonica apps/)
---
@ -61,25 +62,26 @@ Host: localhost
---
## ESTRUCTURA DEL PROYECTO
## ESTRUCTURA CANONICA (ADR-0011)
```
erp-transportistas/
├── CLAUDE.md <- ESTE ARCHIVO
├── PROJECT-STATUS.md <- Estado actual
├── INVENTARIO.yml <- Inventario SIMCO
├── backend/ <- Backend NestJS
│ └── src/modules/ <- Modulos implementados
├── frontend/ <- Frontend React
├── database/
│ └── ddl/ <- DDL PostgreSQL
├── docs/ <- Documentacion funcional
│ ├── 00-vision-general/
│ └── 02-definicion-modulos/
├── orchestration/ <- Sistema SIMCO local
└── .claude/ <- Instrucciones Claude Code
├── apps/ # Contenedor canonico de aplicaciones
│ ├── backend/ # NestJS API (submodule → erp-transportistas-backend-v2)
│ │ └── src/modules/ # Modulos implementados
│ ├── frontend-web/ # React SPA (submodule → erp-transportistas-frontend-v2)
│ ├── frontend-mobile/ # React Native (submodule)
│ ├── database/ # DDL PostgreSQL + PostGIS (submodule → erp-transportistas-database-v2)
│ │ └── ddl/ # Archivos DDL
│ └── _MAP.md # Indice de aplicaciones
├── orchestration/ # Sistema SIMCO local
├── docs/ # Documentacion funcional
├── .claude/ # Instrucciones Claude Code
└── .gitmodules # 4 submodules (backend, frontend-web, database, frontend-mobile)
```
**IMPORTANTE:** Todo desarrollo nuevo DEBE ir dentro de `apps/`. No crear archivos en raiz.
---
## SCHEMAS DE BASE DE DATOS
@ -226,9 +228,11 @@ Ademas de las validaciones de erp-core:
## ALIASES LOCALES
- `@BACKEND` → backend/src/
- `@FRONTEND` → frontend/src/
- `@DDL` → database/ddl/
- `@BACKEND` → apps/backend/src/
- `@FRONTEND` → apps/frontend-web/src/
- `@DDL` → apps/database/ddl/
- `@MOBILE` → apps/frontend-mobile/
- `@APPS-MAP` → apps/_MAP.md
- `@DOCS` → docs/
- `@MODULOS` → docs/02-definicion-modulos/
- `@ORCHESTRATION` → orchestration/
@ -280,4 +284,5 @@ Ademas de las validaciones de erp-core:
---
*ERP Transportistas v1.0.0 - Sistema SIMCO v4.0.0*
*ERP Transportistas v2.0.0 - Sistema SIMCO v4.0.0*
*Estructura migrada a apps/ canonico: 2026-02-06*

29
apps/_MAP.md Normal file
View File

@ -0,0 +1,29 @@
# _MAP: Aplicaciones de erp-transportistas
**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 5 | Planificado | Submodule (erp-transportistas-backend-v2) |
| **Frontend Web** | `apps/frontend-web/` | SPA | React 18 | Planificado | Submodule (erp-transportistas-frontend-v2) |
| **Database** | `apps/database/` | DDL | PostgreSQL 15+ + PostGIS | Planificado | Submodule (erp-transportistas-database-v2) |
| **Frontend Mobile** | `apps/frontend-mobile/` | Mobile App | React Native/Expo | Planificado | Submodule (erp-transportistas-frontend-mobile) |
---
## Notas
- Migrado a estructura apps/ canonica (ADR-0011) 2026-02-06
- Unico proyecto ERP vertical con componente mobile
- Backend, Frontend Web, Database y Frontend Mobile son submodulos git separados (POLYREPO)
---
*Generado por TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS (Sprint 3)*