Crear modelo con detail screen

Checklist paso a paso para crear un nuevo modelo Django y su pantalla de detalle Android en Abior.

Esta tarea es recurrente y los agentes AI solemos olvidar pasos (cablear DELETE en MainScreen, agregar permisos, etc). Este manual consolida el flujo completo end-to-end verificado contra varios casos reales. Cada capitulo es un paso atomico; seguirlos en orden garantiza que las 4 operaciones crear / leer / editar / eliminar funcionen.

1. Django: modelo y migracion

Crear modelo con las FK obligatorias de permisos y campos de auditoria.

1.1 Campos obligatorios

Todo modelo Django nuevo en Abior DEBE tener estos campos:

id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
created_at = models.DateTimeField(auto_now_add=True, blank=True, null=True)
updated = models.DateTimeField(auto_now=True, blank=True, null=True)
created_by = models.ForeignKey(
    'perms.Gafete', on_delete=models.SET_NULL, blank=True, null=True,
    related_name='<app>_<modelos>_created',
)
user_admin = models.ForeignKey(
    'perms.Gafete', on_delete=models.SET_NULL, blank=True, null=True,
    default=None, related_name='<app>_<modelos>_admin',
)
emprendimiento = models.ForeignKey(
    Emprendimiento, on_delete=models.SET_NULL, blank=True, null=True,
)
alias = models.CharField(max_length=255)
desc_breve = models.CharField(max_length=300, blank=True, default='')
desc = models.TextField(blank=True, null=True)

NO uses created solo (sin _at) — AbiorCursorPagination ordena por -created_at y genera FieldError 500 al agregar filtros.

Si el modelo cuelga de un padre (ej. linea de una orden), el padre debe tener emprendimiento para que _resolve_emprendimiento_from_data resuelva el gafete correcto.

1.2 Migracion y autorizacion

Antes de python manage.py makemigrations pedir autorizacion al usuario (regla del proyecto en Abior-webapp/CLAUDE.md). Ejemplo del mensaje:

Migracion para agregar modelo X con FKs Y/Z (todos nullable, sin cambios destructivos). Aplico?

Despues de aprobar, ejecutar en orden:

python manage.py makemigrations <app>
python manage.py migrate <app>

La DB es compartida con produccion — la migracion aplicada local YA esta en prod. Por eso la autorizacion es importante.

2. Django: ViewSet y filtros

Extender AbiorBaseViewSet con filterset y registrar en API_REGISTRY.

2.1 ViewSet minimo

El ViewSet siempre hereda de AbiorBaseViewSet (aplica scoping por emprendimiento + IsOwnerOrAdmin + autollena created_by/user_admin en perform_create).

class <Modelo>ViewSet(AbiorBaseViewSet):
    queryset = <Modelo>.objects.all()
    serializer_class = <Modelo>Serializer
    filterset_fields = ['emprendimiento', 'status', '<FKs principales>']

No sobreescribir permission_classes salvo caso especial. filterset_fields SIEMPRE incluye emprendimiento si aplica y los FKs que el cliente va a usar para listas filtradas.

API_REGISTRY = [
    ('<app>/<modelos>', <Modelo>ViewSet, '<modelo>'),
]

2.2 Endpoint path conocido

Anota el path de tu nuevo endpoint (ej. compras/ordenes) — lo necesitaras al cablear el DELETE en Android. Si no lo agregas al mapa del cliente Android, el DELETE ira a un path inexistente y el usuario vera un Toast engañoso "No tienes permiso".

3. Android: DTO y retrofit

Agregar DTO en Models.kt y endpoints en AbiorApi.kt.

3.1 DTO minimo

En app/src/main/java/art/abior/android/data/model/Models.kt:

data class <Modelo>Dto(
    val id: String,
    val alias: String,
    @SerializedName("desc_breve") val descBreve: String? = "",
    val desc: String? = "",
    val emprendimiento: String? = null,
    @SerializedName("created_at") val createdAt: String? = null,
)

Todos los campos no requeridos con default null / "". Gson los llena con valores vacios si faltan en el response.

3.2 Endpoints retrofit

En AbiorApi.kt:

@GET("<app>/<modelos>/")
suspend fun get<Modelos>(@Query("emprendimiento") empId: String): Response<PaginatedResponse<<Modelo>Dto>>

@GET("<app>/<modelos>/{id}/")
suspend fun get<Modelo>(@Path("id") id: String): Response<Map<String, @JvmSuppressWildcards Any?>>

@POST("<app>/<modelos>/")
suspend fun create<Modelo>(@Body body: Map<String, @JvmSuppressWildcards Any?>): Response<<Modelo>Dto>

Usar Map<String, Any?> para el body + detail evita acoplarse al DTO estricto y permite endpoi

...