coin-plan

Metodología de Planificación de Colecciones de Monedas

Cuándo usar

• El usuario sube una exportación CSV de Numista y desea un análisis de brechas
• El usuario pregunta "¿qué me falta de [serie]?"
• El usuario quiere iniciar una nueva serie y necesita la lista completa
• El usuario solicita una lista de compras para feria numismática o prioridades de compra
• El usuario pide sugerencias de series basadas en patrones de su colección existente

Paso 1: Analizar la exportación de Numista

Las columnas del CSV que importan:

País, Emisor, Autoridad gobernante, Título, Tipo, Valor facial,
Referencia, Número N#, Año gregoriano, Marca de ceca, Composición,
Grado, Colección, Comentario

Patrones clave de análisis:

Extracción del nombre del diseño — los nombres están entre paréntesis después de la información del retrato:

import re
m = re.search(r'\((.*?)\)', titulo)
nombre_diseno = m.group(1) if m else titulo

Para series con múltiples retratos (Reino Unido) — eliminar el prefijo del retrato:

m = re.search(r'retrato;\s*(.+?)\)', titulo)

Filtrar monedas no circulantes (si el coleccionista excluye pruebas de plata/oro):

if 'plata' in comp.lower() and 'chapado' not in comp.lower():
    continue  # omitir plata pura

Eliminar duplicados por (diseño, año, ceca) — mismo diseño+año+ceca = una entrada, contar la cantidad.

Paso 2: Construir la lista maestra de la serie

Fuentes de investigación (en orden de confiabilidad):

1. Páginas del catálogo de Numista — autoridad para KM#, fechas, composiciones
2. Búsqueda web para descripciones generales de series (artículos de PCGS, NGC, Baidu Baike para China)
3. Referencia cruzada de los números N# de la exportación del usuario contra series conocidas

Identificación de series a partir de patrones de colección:

• Examinar el campo Tipo: "Conmemorativa circulante" vs "Circulación estándar"
• Agrupar por denominación + composición para identificar series
• Verificar rangos de años para secuencias continuas (brechas = monedas faltantes)

Estructuras comunes de series:

País	Serie	Denominación	Formato	Años
EE.UU.	50 State Quarters	25¢	Revestimiento Cu-Ni	1999-2008
EE.UU.	DC & Territories	25¢	Revestimiento Cu-Ni	2009
EE.UU.	America the Beautiful	25¢	Revestimiento Cu-Ni	2010-2021
EE.UU.	American Women	25¢	Revestimiento Cu-Ni	2022-2025
Reino Unido	Round Pound Emblems	£1	Ni-Latón	1983-2015
Reino Unido	12-Sided Pound	£1	Bimetálica	2016-presente
China	Zodiaco Lunar	10 Yuan	Bimetálica	2015-2026
China	Patrimonio Cultural Mundial	5 Yuan	Latón	2002-2006
China	Montañas Patrimonio Mundial	5 Yuan	Latón (cuadrada)	2019-presente
China	Ópera de Pekín	5 Yuan	Latón	2023-2027
China	Parques Nacionales	10 Yuan	Bimetálica	2023-presente
China	Caligrafía "He"	5 Yuan	Latón	2013-2022
China	Lugares Famosos de Taiwán	5 Yuan	Latón	2003-2005
China	Animales del Libro Rojo	5 Yuan	Cobre	1995-1998
India	Estados principescos	Varias	Varias	Varias

Paso 3: Análisis de brechas

Construir conjunto de monedas poseídas:

coleccionado = {}  # (nombre_diseno, año) -> conjunto de cecas o cantidad

Cruzar referencias contra la lista maestra:

for año, nombre in lista_maestra:
    if (nombre, año) in coleccionado:
        estado = "TENGO"
    else:
        estado = "FALTA"

Para series con variantes de ceca (cuartos de EE.UU.):

Hacer seguimiento de P y D por separado. Mostrar ambos como columnas — en negrita si se posee, en gris claro si no.

Para series de una sola variante (libras del Reino Unido, China):

Casilla de verificación simple sí/no.

Paso 4: Sugerir nuevas series

Cuando el usuario pregunte "¿qué más debería coleccionar?", aplicar estos filtros:

Criterios de compatibilidad:

1. Misma denominación/formato que la colección existente (si el usuario colecciona monedas de 5 Yuan de latón, sugerir otras series de 5 Yuan de latón)
2. Mismo rango de precios — conmemorativas circulantes, no pruebas/bullion
3. Completable — series finitas con un número total conocido
4. Disponible — monedas aún obtenibles de distribuidores a precios razonables
5. Coincidencia temática — los intereses declarados del coleccionista (ver perfil del coleccionista debajo)

Ranking de prioridad para sugerencias:

• Alta: Mismo formato, mismo país, <20 monedas, baratas, disponibles
• Media: Mismo país, formato diferente pero asequible
• Baja: País diferente pero coincidencia temática

Paso 5: Lista de compras

Para ferias numismáticas:

• Priorizar por geografía (las ferias locales tienen mejor existencia de monedas locales y regionales; por ejemplo, una feria en el sur de India es el mejor lugar para estados principescos del sur de India)
• Agrupar por prioridad: ALTA (probablemente presente), MEDIA (preguntar a distribuidores), ESPECIALISTA (solo distribuidores dedicados)
• Incluir nombres de denominación específicos que los distribuidores reconozcan
• Agregar casillas de verificación vacías para marcar en la feria

Para compras en línea:

• Anotar qué monedas son de circulación común (baratas) vs conmemorativas (con prima)
• Marcar cualquier moneda que sea escasa o tenga alta demanda de coleccionistas

Paso 6: Salida

Generar salida usando el skill a5-coin para PDFs listos para carpeta de anillas, o Excel con openpyxl para seguimiento digital.

Columnas de salida de Excel:

N.°, Nombre oficial, Año, Denominación, Estado/País actual, Región, Era británica (para India), ¿En colección?, Monedas poseídas, Prioridad

Salida PDF:

Usar el skill a5-coin — fuente Carlito, escala de grises, perforación de 6 agujeros, diseño de flujo continuo.

Perfil del coleccionista (completar con tus datos)

Mantener esta sección breve y actualizarla a medida que la colección cambie. El skill la usa para sugerencias y listas de compras.

• Nombre de usuario de Numista:
• Tamaño aproximado de la colección: <número>
• Subcolecciones activas: <ej. Libras redondas británicas, Zodiaco lunar chino, Cuartos de EE.UU.>
• Impresión: <color / escala de grises>, carpeta: <A5 Filofax / otra>
• Ciudad de residencia (para listas de ferias):
• Exclusiones: <ej. sin pruebas de plata/oro>

Brechas conocidas (fecha)

• : /, faltan