elordenador/proyecto-final
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

first commit

Browse Source
This commit is contained in:
daniel
2026-02-15 09:23:44 +01:00
commit 5a22d3abae
276 changed files with 231906 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.github/copilot-instructions.md
+90
View File
@@ -0,0 +1,90 @@
# Copilot Instructions - Django Tienda Project
## Project Overview
This is a Django 6.0.1 e-commerce application ("tienda" = store) with a monolithic architecture. The project uses SQLite for development and Bootstrap 5.0.2 for styling.
## Architecture
- **Main project**: `proyecto/` - Django settings, root URL configuration, WSGI/ASGI config
- **Tienda app**: `tienda/` - Core e-commerce functionality (currently minimal, ready for expansion)
- **Database**: SQLite (`db.sqlite3`) for local development
- **Static files**: Bootstrap 5.0.2 bundled in `tienda/static/css/styles.css` (9929 lines), images in `tienda/static/img/`
## URL Routing Pattern
URLs follow a two-tier structure:
1. Root: [proyecto/urls.py](proyecto/urls.py) includes app URLs
2. App level: [tienda/urls.py](tienda/urls.py) defines app-specific routes
- Main store accessible at `/tienda/` (not root `/`)
- Pattern: `path('tienda/', include('tienda.urls'))`
## Template Structure
Templates use Django's inheritance pattern:
- **Base**: [tienda/templates/tienda/base.html](tienda/templates/tienda/base.html) - Contains navigation header with logo, search bar, login/register buttons
- **Pages**: Extend base using `{% extends "tienda/base.html" %}`
- **Static files**: Load with `{% load static %}` at template top
- App templates must be in `tienda/templates/tienda/` (app-namespaced)
## Static Files Configuration
- **Collection directory**: `STATIC_ROOT = BASE_DIR / 'staticfiles'` for production
- **Development dirs**: `STATICFILES_DIRS` includes `tienda/static/`
- **URL prefix**: `STATIC_URL = 'static/'`
- **SCSS compilation**: Styles are authored in [tienda/static/scss/custom.scss](tienda/static/scss/custom.scss) and compiled to [tienda/static/css/custom.css](tienda/static/css/custom.css)
- **IMPORTANT**: Always edit `custom.scss`, never `custom.css` - CSS file is auto-generated
- Compile with Sass compiler (npm sass or similar)
- Bootstrap CSS is vendored in `tienda/static/css/styles.css` - don't add CDN links
## Media Files (User Uploads) Configuration
- **Storage location**: `MEDIA_ROOT = BASE_DIR / 'tienda' / 'static' / 'media'` - all uploads go here
- **URL prefix**: `MEDIA_URL = 'media/'`
- **Image uploads**: Organized in `tienda/static/media/images/` via `upload_to='images/'` in ImageField
- **Access**: Media files served automatically in development via Django's static file handler
- **Image model**: Located in [tienda/models.py](tienda/models.py) with `ImageField(upload_to='images/')`
## Key Conventions
1. **App registration**: Apps use `AppConfig` - see `'tienda.apps.TiendaConfig'` in `INSTALLED_APPS`
2. **View pattern**: Function-based views in [tienda/views.py](tienda/views.py) (e.g., `index` renders template with context dict)
3. **Spanish naming**: UI elements use Spanish (`Iniciar Sesión`, `Registrarse`, `Menú`)
4. **Models**: Located in [tienda/models.py](tienda/models.py) - includes Product, Category, Cart, CartItem, Image
5. **Product caching**: Products are cached in Redis for 5 minutes when visited
- Cache key pattern: `product_{id}` (stored as `:1:product_{id}` in Redis)
- Cache is invalidated automatically when product is edited or deleted
- Improves performance by ~15x for product detail pages
## Development Workflow
- **Python environment**: This project uses venv at `.venv/bin/python`. Always use `/home/daniel/projects/proyecto/proyecto2/proyecto/.venv/bin/python` when running Python commands
- **Redis**: Sessions and product cache are stored in Redis (db 1). Redis must be running on localhost:6379
- Start Redis: `sudo systemctl start redis-server` (Linux) or `brew services start redis` (macOS)
- For Arch Linux: `sudo systemctl start valkey` (uses valkey-cli instead of redis-cli)
- Verify: `redis-cli ping` or `valkey-cli ping` (should return PONG)
- Test product cache: `python test_product_cache.py`
- See [REDIS_SETUP.md](REDIS_SETUP.md) for complete setup instructions
- **Run server**: `/home/daniel/projects/proyecto/proyecto2/proyecto/.venv/bin/python manage.py runserver`
- **Migrations**: `/home/daniel/projects/proyecto/proyecto2/proyecto/.venv/bin/python manage.py makemigrations && /home/daniel/projects/proyecto/proyecto2/proyecto/.venv/bin/python manage.py migrate`
- **IMPORTANT**: If `makemigrations` appears to fail (exit code 130 or similar), ALWAYS check `tienda/migrations/` directory first - the migration file is often created successfully despite the error message
- Before attempting to recreate migrations, verify if the file already exists
- **Static files**: `python manage.py collectstatic` (for production)
- **Admin**: Access at `/admin/` (not `/tienda/admin/`)
- **Main app URL**: http://localhost:8000/tienda/
## Critical Details
- Django 6.0.1 specific - use current Django patterns
- SQLite database committed (`db.sqlite3`) - migrations already applied
- Bootstrap requires JavaScript for modals/toggles (reference data-bs-* attributes in base.html)
- SECRET_KEY is development-only (contains 'insecure' marker)
- DEBUG=True - not production-ready
## When Adding Features
- New models: Add to [tienda/models.py](tienda/models.py), run migrations, register in [tienda/admin.py](tienda/admin.py)
- New views: Add to [tienda/views.py](tienda/views.py), register route in [tienda/urls.py](tienda/urls.py)
- New templates: Create in `tienda/templates/tienda/`, extend `base.html`
- Static assets: Place in `tienda/static/` subdirectories (css/, img/, js/)
## Seller Panel (Panel de Vendedor)
- **URL Base**: `/tienda/venta/` - All seller-related features under this path
- **Main Page**: `/tienda/venta/` - Lists all products created by the authenticated user
- **Create Product**: `/tienda/venta/crear-producto/` - Form to create new products
- **Header Button**: "Panel Vendedor" - Links to the seller main page (mis_productos view)
- **Concept**: Centralized area for sellers to manage their products (list, create, and future: edit, delete, analytics)
## Working Pattern with Developer
- **"Lo recuerdes"**: When the developer says to remember something, document it in this file immediately
- Update this file as the source of truth for project-specific decisions and patterns