# kenjirosato/contracalle architecture

> Architecture diagram of the GitHub repository kenjirosato/contracalle, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kenjirosato/contracalle
- Repository: https://github.com/kenjirosato/contracalle

## Overview

CONTRACALLE es una tienda de ropa con colecciones vinculadas a causas: el cliente explora el catálogo, personaliza prendas, guarda selecciones localmente y, tras iniciar sesión, envía una solicitud de pedido pendiente. La app también ofrece gestión de catálogo para administradores e historias, pasaportes y votaciones de lanzamientos. Servicios validan datos de Supabase; hooks coordinan cargas y las pantallas presentan resultados. Los vínculos se apoyan en el README y las referencias del índice; no se inspeccionó el código no excerptado, así que se omiten relaciones inciertas.

Main entry points: [`src/services/supabaseClient.ts`](https://github.com/kenjirosato/contracalle/blob/main/src/services/supabaseClient.ts) (Cliente Supabase), [`src/navigation/MainTabs.tsx`](https://github.com/kenjirosato/contracalle/blob/main/src/navigation/MainTabs.tsx) (Navegación), [`src/screens/HomeScreen.tsx`](https://github.com/kenjirosato/contracalle/blob/main/src/screens/HomeScreen.tsx) (Catálogo), [`src/services/catalogoService.ts`](https://github.com/kenjirosato/contracalle/blob/main/src/services/catalogoService.ts) (Servicio de catálogo)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Aplicación y acceso"]
  node_app["Composición de app<br/>[App.tsx]"]
  node_navigation["Navegación<br/>[MainTabs.tsx]"]
  node_auth["Sesión y acceso<br/>[AuthContext.tsx]"]
end

subgraph group_store["Tienda y carrito"]
  node_catalog_screen["Catálogo<br/>[HomeScreen.tsx]"]
  node_product_screen["Ficha de producto<br/>[ProductoScreen.tsx]"]
  node_catalog_hook["Carga de catálogo<br/>[useCatalogo.ts]"]
  node_product_details["Ficha y disponibilidad<br/>[ficha.ts]"]
  node_catalog_editor["Editor de prendas<br/>[EditorPrenda.tsx]"]
  node_cart["Carrito local<br/>[CartContext.tsx]"]
  node_cart_model["Cálculo del carrito<br/>[modelo.ts]"]
end

subgraph group_orders["Pedidos"]
  node_checkout["Checkout y entrega<br/>[Checkout.tsx]"]
  node_orders_hook["Carga de pedidos<br/>[usePedidos.ts]"]
  node_orders_ui["Tarjetas de pedido<br/>[TarjetaPedido.tsx]"]
end

subgraph group_identity["Identidad y comunidad"]
  node_identity_screen["Pasaporte"]
  node_launch_card["Lanzamiento y votación"]
end

subgraph group_data["Servicios y modelos"]
  node_catalog_service["Servicio de catálogo<br/>[catalogoService.ts]"]
  node_orders_service["Servicio de pedidos<br/>[pedidosService.ts]"]
  node_identity_service["Servicio de identidad"]
  node_auth_service["Servicio de autenticación<br/>[authService.ts]"]
  node_data_parser["Validación de respuestas<br/>[datos.ts]"]
  node_supabase_client["Cliente Supabase<br/>[supabaseClient.ts]"]
end

node_customer(("Cliente"))
node_device_storage[("Almacenamiento dispositivo")]
node_supabase[("Supabase")]

node_customer -->|"usa"| node_app
node_app -->|"provee sesión"| node_auth
node_app -->|"monta"| node_navigation
node_navigation -->|"navega"| node_catalog_screen
node_navigation -->|"navega"| node_product_screen
node_navigation -->|"navega"| node_identity_screen
node_catalog_screen -->|"carga con"| node_catalog_hook
node_catalog_screen -->|"ofrece edición"| node_catalog_editor
node_catalog_hook -->|"consulta"| node_catalog_service
node_catalog_service -->|"consulta"| node_supabase_client
node_catalog_service -->|"valida con"| node_data_parser
node_catalog_screen -->|"presenta"| node_product_details
node_product_screen -->|"consulta"| node_catalog_service
node_product_screen -->|"agrega selección"| node_cart
node_cart -->|"calcula con"| node_cart_model
node_cart -->|"persiste"| node_device_storage
node_customer -->|"solicita pedido"| node_checkout
node_checkout -->|"registra solicitud"| node_orders_service
node_orders_service -->|"envía consultas"| node_supabase_client
node_orders_service -->|"valida con"| node_data_parser
node_orders_hook -->|"consulta"| node_orders_service
node_orders_ui -.->|"muestra pedidos"| node_orders_hook
node_identity_screen -.->|"presenta"| node_launch_card
node_launch_card -->|"gestiona datos"| node_identity_service
node_identity_service -->|"consulta"| node_supabase_client
node_identity_service -->|"valida con"| node_data_parser
node_auth -->|"gestiona acceso"| node_auth_service
node_auth_service -->|"autentica"| node_supabase_client
node_auth -->|"recupera sesión"| node_supabase_client
node_supabase_client -->|"conecta"| node_supabase

click node_app "https://github.com/kenjirosato/contracalle/blob/main/App.tsx"
click node_navigation "https://github.com/kenjirosato/contracalle/blob/main/src/navigation/MainTabs.tsx"
click node_auth "https://github.com/kenjirosato/contracalle/blob/main/src/context/AuthContext.tsx"
click node_catalog_screen "https://github.com/kenjirosato/contracalle/blob/main/src/screens/HomeScreen.tsx"
click node_product_screen "https://github.com/kenjirosato/contracalle/blob/main/src/screens/ProductoScreen.tsx"
click node_catalog_hook "https://github.com/kenjirosato/contracalle/blob/main/src/hooks/useCatalogo.ts"
click node_catalog_service "https://github.com/kenjirosato/contracalle/blob/main/src/services/catalogoService.ts"
click node_product_details "https://github.com/kenjirosato/contracalle/blob/main/src/features/catalogo/ficha.ts"
click node_catalog_editor "https://github.com/kenjirosato/contracalle/blob/main/src/features/catalogo/EditorPrenda.tsx"
click node_cart "https://github.com/kenjirosato/contracalle/blob/main/src/context/CartContext.tsx"
click node_cart_model "https://github.com/kenjirosato/contracalle/blob/main/src/features/carrito/modelo.ts"
click node_checkout "https://github.com/kenjirosato/contracalle/blob/main/src/features/checkout/Checkout.tsx"
click node_orders_hook "https://github.com/kenjirosato/contracalle/blob/main/src/hooks/usePedidos.ts"
click node_orders_service "https://github.com/kenjirosato/contracalle/blob/main/src/services/pedidosService.ts"
click node_orders_ui "https://github.com/kenjirosato/contracalle/blob/main/src/features/pedidos/TarjetaPedido.tsx"
click node_identity_screen "https://github.com/kenjirosato/contracalle/blob/main/src/screens/PasaporteScreen.tsx"
click node_launch_card "https://github.com/kenjirosato/contracalle/blob/main/src/features/identidad/TarjetaLanzamiento.tsx"
click node_identity_service "https://github.com/kenjirosato/contracalle/blob/main/src/services/identidadService.ts"
click node_auth_service "https://github.com/kenjirosato/contracalle/blob/main/src/services/authService.ts"
click node_data_parser "https://github.com/kenjirosato/contracalle/blob/main/src/services/datos.ts"
click node_supabase_client "https://github.com/kenjirosato/contracalle/blob/main/src/services/supabaseClient.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_navigation,node_auth,node_customer toneBlue
class node_catalog_screen,node_product_screen,node_catalog_hook,node_product_details,node_catalog_editor,node_cart,node_cart_model,node_device_storage,node_supabase toneAmber
class node_checkout,node_orders_hook,node_orders_ui toneMint
class node_identity_screen,node_launch_card toneRose
class node_catalog_service,node_orders_service,node_identity_service,node_auth_service,node_data_parser,node_supabase_client toneIndigo
```

## Components

### Aplicación y acceso

- [Composición de app](https://github.com/kenjirosato/contracalle/blob/main/App.tsx): `App.tsx`
- [Navegación](https://github.com/kenjirosato/contracalle/blob/main/src/navigation/MainTabs.tsx): `src/navigation/MainTabs.tsx`
- [Sesión y acceso](https://github.com/kenjirosato/contracalle/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`

### Tienda y carrito

- [Catálogo](https://github.com/kenjirosato/contracalle/blob/main/src/screens/HomeScreen.tsx): `src/screens/HomeScreen.tsx`
- [Ficha de producto](https://github.com/kenjirosato/contracalle/blob/main/src/screens/ProductoScreen.tsx): `src/screens/ProductoScreen.tsx`
- [Carga de catálogo](https://github.com/kenjirosato/contracalle/blob/main/src/hooks/useCatalogo.ts): `src/hooks/useCatalogo.ts`
- [Ficha y disponibilidad](https://github.com/kenjirosato/contracalle/blob/main/src/features/catalogo/ficha.ts): `src/features/catalogo/ficha.ts`
- [Editor de prendas](https://github.com/kenjirosato/contracalle/blob/main/src/features/catalogo/EditorPrenda.tsx): `src/features/catalogo/EditorPrenda.tsx`
- [Carrito local](https://github.com/kenjirosato/contracalle/blob/main/src/context/CartContext.tsx): `src/context/CartContext.tsx`
- [Cálculo del carrito](https://github.com/kenjirosato/contracalle/blob/main/src/features/carrito/modelo.ts): `src/features/carrito/modelo.ts`

### Pedidos

- [Checkout y entrega](https://github.com/kenjirosato/contracalle/blob/main/src/features/checkout/Checkout.tsx): `src/features/checkout/Checkout.tsx`
- [Carga de pedidos](https://github.com/kenjirosato/contracalle/blob/main/src/hooks/usePedidos.ts): `src/hooks/usePedidos.ts`
- [Tarjetas de pedido](https://github.com/kenjirosato/contracalle/blob/main/src/features/pedidos/TarjetaPedido.tsx): `src/features/pedidos/TarjetaPedido.tsx`

### Identidad y comunidad

- [Pasaporte](https://github.com/kenjirosato/contracalle/blob/main/src/screens/PasaporteScreen.tsx): `src/screens/PasaporteScreen.tsx`
- [Lanzamiento y votación](https://github.com/kenjirosato/contracalle/blob/main/src/features/identidad/TarjetaLanzamiento.tsx): `src/features/identidad/TarjetaLanzamiento.tsx`

### Servicios y modelos

- [Servicio de catálogo](https://github.com/kenjirosato/contracalle/blob/main/src/services/catalogoService.ts): `src/services/catalogoService.ts`
- [Servicio de pedidos](https://github.com/kenjirosato/contracalle/blob/main/src/services/pedidosService.ts): `src/services/pedidosService.ts`
- [Servicio de identidad](https://github.com/kenjirosato/contracalle/blob/main/src/services/identidadService.ts): `src/services/identidadService.ts`
- [Servicio de autenticación](https://github.com/kenjirosato/contracalle/blob/main/src/services/authService.ts): `src/services/authService.ts`
- [Validación de respuestas](https://github.com/kenjirosato/contracalle/blob/main/src/services/datos.ts): `src/services/datos.ts`
- [Cliente Supabase](https://github.com/kenjirosato/contracalle/blob/main/src/services/supabaseClient.ts): `src/services/supabaseClient.ts`

### Other components

- **Cliente**
- **Almacenamiento dispositivo**
- **Supabase**

## Connections

- Cliente → Composición de app: usa (evidence: `README.md`)
- Composición de app → Sesión y acceso: provee sesión (evidence: `App.tsx`)
- Composición de app → Navegación: monta (evidence: `App.tsx`)
- Navegación → Catálogo: navega (evidence: `src/navigation/MainTabs.tsx`)
- Navegación → Ficha de producto: navega (evidence: `App.tsx`)
- Navegación → Pasaporte: navega (evidence: `App.tsx`)
- Catálogo → Carga de catálogo: carga con (evidence: `src/screens/HomeScreen.tsx`)
- Catálogo → Editor de prendas: ofrece edición (evidence: `src/screens/HomeScreen.tsx`)
- Carga de catálogo → Servicio de catálogo: consulta (evidence: `src/hooks/useCatalogo.ts`)
- Servicio de catálogo → Cliente Supabase: consulta (evidence: `src/services/catalogoService.ts`)
- Servicio de catálogo → Validación de respuestas: valida con (evidence: `src/services/catalogoService.ts`)
- Catálogo → Ficha y disponibilidad: presenta (evidence: `src/screens/HomeScreen.tsx`)
- Ficha de producto → Servicio de catálogo: consulta (evidence: `src/screens/ProductoScreen.tsx`)
- Ficha de producto → Carrito local: agrega selección (evidence: `src/screens/ProductoScreen.tsx`)
- Carrito local → Cálculo del carrito: calcula con (evidence: `src/context/CartContext.tsx`)
- Carrito local → Almacenamiento dispositivo: persiste (evidence: `src/context/CartContext.tsx`)
- Cliente → Checkout y entrega: solicita pedido (evidence: `README.md`)
- Checkout y entrega → Servicio de pedidos: registra solicitud (evidence: `src/features/checkout/Checkout.tsx`)
- Servicio de pedidos → Cliente Supabase: envía consultas (evidence: `src/services/pedidosService.ts`)
- Servicio de pedidos → Validación de respuestas: valida con (evidence: `src/services/pedidosService.ts`)
- Carga de pedidos → Servicio de pedidos: consulta (evidence: `src/hooks/usePedidos.ts`)
- Tarjetas de pedido → Carga de pedidos: muestra pedidos
- Pasaporte → Lanzamiento y votación: presenta
- Lanzamiento y votación → Servicio de identidad: gestiona datos (evidence: `src/features/identidad/TarjetaLanzamiento.tsx`)
- Servicio de identidad → Cliente Supabase: consulta (evidence: `src/services/identidadService.ts`)
- Servicio de identidad → Validación de respuestas: valida con (evidence: `src/services/identidadService.ts`)
- Sesión y acceso → Servicio de autenticación: gestiona acceso (evidence: `src/context/AuthContext.tsx`)
- Servicio de autenticación → Cliente Supabase: autentica (evidence: `src/services/authService.ts`)
- Sesión y acceso → Cliente Supabase: recupera sesión (evidence: `src/context/AuthContext.tsx`)
- Cliente Supabase → Supabase: conecta (evidence: `README.md`)
