From 1c8638b8d450214f17af0cdc5f73ba01507ca587 Mon Sep 17 00:00:00 2001
From: mono <mono@desarrollo-mono.localhost>
Date: Sat, 7 Mar 2026 16:03:21 -0500
Subject: [PATCH] docs: add AGENTS.md with project conventions for AI agents

---
 AGENTS.md | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..0d20087
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,72 @@
+# Don Confiao - Frontend
+
+## Tech Stack
+- **Framework:** Vue 3 (Composition API)
+- **UI Library:** Vuetify 3
+- **Routing:** Vue Router 4 (auto-routes con `unplugin-vue-router`)
+- **State:** Pinia
+- **HTTP:** Axios
+- **Build:** Vite
+- **Linting:** ESLint
+
+## Project Structure
+```
+src/
+├── assets/          # Imágenes, iconos estáticos
+├── components/      # Componentes Vue reutilizables
+├── layouts/         # Layouts de página
+├── pages/           # Vistas (auto-routed desde文件名)
+├── plugins/         # Configuración de Vuetify, etc.
+├── router/          # Configuración de rutas
+├── services/        # API services (auth.js, etc.)
+├── stores/          # Pinia stores
+└── styles/          # SCSS settings
+```
+
+## Important Conventions
+
+### Auto-imports
+- Componentes en `src/components/` se auto-importan por nombre
+- Los archivos en `src/pages/*.vue` se routing automáticamente via `unplugin-vue-router`
+- Alias `@` = `src/`
+
+### Pages (CRITICAL)
+**Siempre importar componentes en los archivos de página:**
+```vue
+<template>
+  <MiComponente />
+</template>
+
+<script setup>
+import MiComponente from '@/components/MiComponente.vue';
+</script>
+```
+
+### Componentes
+- Usar Composition API (`<script setup>` o `export default { }`)
+- Naming: PascalCase (ej: `LoginDialog.vue`, `CartGrid.vue`)
+- Componentes de página van en `pages/`, componentes reutilizables en `components/`
+
+### Servicios API
+- Ubicación: `src/services/`
+- Usar Axios para HTTP requests
+- JWT tokens en localStorage (`access_token`, `refresh_token`)
+
+### Routing
+- Rutas automáticas basadas en archivos en `src/pages/`
+- No requiere configuración manual en `router/index.js`
+
+## Environment Variables
+- `VITE_DJANGO_BASE_URL` - URL del backend Django
+
+## Commands
+```bash
+npm run dev      # Desarrollo (puerto 3000)
+npm run build    # Producción
+npm run preview  # Preview build
+npm run lint     # ESLint fix
+```
+
+## Common Issues
+1. **Página en blanco:** Verificar que los componentes en `src/pages/*.vue` tengan import explícito
+2. **Errores de lint:** Ejecutar `npm run lint`