Tk Redline

Proyecto Django con Tailwind CSS v4 y DaisyUI v5.

Desarrollo local

# 1. Crear y activar entorno virtual
python3 -m venv .venv
source .venv/bin/activate

# 2. Instalar dependencias Python
pip install -r requirements/dev.txt

# 3. Aplicar migraciones
python manage.py migrate

# 4. Correr servidor Django (terminal 1)
python manage.py runserver

# 5. Compilar CSS con watch (terminal 2)
cd static_src
npm install
npm run dev

• App en http://localhost:8000
• SQLite por defecto
• Recarga automática del navegador con django-browser-reload
• Tailwind reconstruye el CSS al cambiar templates

Producción con Docker

# Copiar y editar variables de entorno
cp .env.sample .env

docker compose up -d --build

• App en http://localhost:8008
• Gunicorn + PostgreSQL
• El CSS se compila durante el build

# Crear superusuario
docker compose exec django python manage.py createsuperuser --settings=core.settings.prod

# Migraciones
docker compose exec django python manage.py migrate --settings=core.settings.prod

Backup y restore de la base de datos

Crear backup:

./backup-db.sh

El script pregunta qué base de datos usar:

• 1) SQLite (local) — genera dumpdata_<timestamp>.json (formato portable para PostgreSQL)
• 2) PostgreSQL (Docker) — usa pg_dump, guarda en backups/dump_<nombre_db>_<timestamp>.sql

Migrar de SQLite local a PostgreSQL (producción):

# 1. En local: backup desde SQLite
./backup-db.sh   # elige 1
# → crea backups/dumpdata_20260226_123456.json

# 2. Sube el archivo .json al servidor (git, scp, etc.)

# 3. En producción: restaurar a PostgreSQL
./restore-db.sh backups/dumpdata_20260226_123456.json
# Aplica migraciones y carga los datos

Restaurar (usa el backup más reciente):

./restore-db.sh

Detecta el tipo por extensión: .json → loaddata en PostgreSQL, .sql → PostgreSQL, .sqlite3 → SQLite.

PostgreSQL: borrar datos y restaurar desde cero:

./restore-db.sh --drop backups/dump_base_20260226.sql
./restore-db.sh --drop backups/dumpdata_20260226.json   # flush + loaddata

Desarrollo con MariaDB

# Instalar dependencias para MySQL/MariaDB
pip install -r requirements/mysql.txt

# Variables de entorno (o en .env)
export DATABASE_ENGINE=mysql
export DATABASE_NAME=tekonmaps
export DATABASE_USER=tekonmaps
export DATABASE_PASSWORD=tu-password
export DATABASE_HOST=localhost  # o 'db' si usas Docker
export DATABASE_PORT=3306

# Migraciones
python manage.py migrate

Error 1071 "Specified key was too long; max key length is 767 bytes":

• Usa MariaDB 10.2+ o MySQL 5.7.7+ (soporte nativo para índices largos).
• Si usas MariaDB < 10.2, añade a my.cnf:

  innodb_large_prefix=1
  innodb_file_format=barracuda
  innodb_file_per_table=1
  

Con Docker:

docker compose -f docker-compose.mariadb.yml up --build

APIs

Externas (webhooks n8n)

API	URL	Uso
nc-tekon	https://n8npozos.magoreal.com/webhook/nc-tekon	Lista items (carpetas/archivos) de Nextcloud. Parámetro: ?path=/ruta
nc-tekon-deep	https://n8npozos.magoreal.com/webhook/nc-tekon-deep	Conteo de archivos por subcarpeta. Parámetro: ?path=/ruta

Los webhooks usan internamente la API de Nextcloud (nodo n8n nextCloud).

Internas (Django)

Endpoint	Método	Uso
/docs/api/sitios/	GET	Lista sitios (carpetas raíz) por empresa
/docs/api/carpetas/	GET	Carpetas con estructura o con archivos
/docs/api/carpetas/archivos/	GET	Subcarpetas con conteo de archivos por sitio

Flujo: Django → requests → webhooks n8n → API Nextcloud → JSON.

Estructura

• core/ — Configuración Django (settings, urls, views)
• templates/ — Plantillas HTML
• static/ — Archivos estáticos (CSS compilado, imágenes)
• static_src/ — Fuentes Tailwind (input.css, package.json)
• docs/ — App de documentación