retc1/personal-fund-portfolio-analysis

Análisis del Portafolio de Inversión en Fondos

Objetivo y Alcance

Realiza un análisis verificable de la composición y los montos de un portafolio de fondos, generando por defecto un PDF en chino con capacidad de búsqueda. Aplica a fondos de renta variable, mixtos, indexados, bonos, monetarios, commodities, oro, entre otros; los activos fuera de fondos deben especificarse claramente con su tipo y límite estadístico.

El informe solo presenta datos verificados, resultados calculados y comentarios breves necesarios. No se debe generar por defecto "juicios clave", "acciones ahora", "prioridad de estudio", "sugerencias de compra/venta/cambio" ni "instrucciones de aumento/disminución de sectores"; la estructura de activos no implica directamente recomendaciones de trading. Cuando el usuario solicite decisiones de inversión, se requiere un análisis adicional que incluya valoración en tiempo real, fundamentos, período de tenencia, comisiones reales, tolerancia al riesgo, capital disponible y costo de oportunidad; de lo contrario, se debe indicar claramente que no es posible realizar un juicio fiable, sin presentar estimaciones teóricas como recomendaciones de inversión.

Entrada y Clasificación

• Obligatorio: código o nombre de cada fondo, valor de mercado actual V, ganancia/pérdida acumulada P (positivo = ganancia, negativo = pérdida); moneda por defecto RMB; debe indicarse la fecha de la instantánea de la cuenta.
• Opcional: nombre del fondo, tipo de fondo, categoría de inversión principal, tipo de participación, registros de compra y venta, dividendos, comisiones, detalles de costos, etc.
• Los fondos ya vendidos no se incluyen en la tenencia actual; si el usuario proporciona pérdidas realizadas por separado, se registran de forma independiente y no pueden mezclarse automáticamente con el valor de mercado y las ganancias/pérdidas de la tenencia actual.
• La clasificación de tenencias se basa en el contrato del fondo, informes periódicos y los atributos del fondo proporcionados explícitamente por el usuario. Si no se puede verificar, se etiqueta como "pendiente de clasificar". Un mismo valor de mercado solo puede colocarse en una categoría principal, prohibiendo duplicaciones. La clasificación es a nivel de producto del fondo y no equivale a la proporción de valores subyacentes.
• Cuando el usuario solo proporciona el código sin la categoría, se puede verificar con fuentes públicas; no se deben etiquetar erróneamente como tenencias reales de la misma fecha si las fechas de entrada son diferentes. Todos los informes deben indicar claramente la fecha de la instantánea de la cuenta del usuario y la fecha de los datos externos.
• C = V-P es el costo de tenencia actual inferido a partir de las ganancias/pérdidas de la cuenta, no necesariamente la suma de todas las entradas de efectivo históricas; en caso de ventas parciales, dividendos o transferencias, se debe explicar esta limitación.

Cálculos Precisos

Utiliza operaciones con decimales de precisión (Decimal), redondeando solo para la visualización; los montos mínimos de reposición deben redondearse al céntimo superior.

Sean V el valor de mercado actual, P la ganancia/pérdida acumulada, C=V-P, y r>0 el porcentaje de aumento supuesto desde el precio actual.

Elemento Estadístico	Fórmula
Rendimiento de la tenencia	P/C
Aumento necesario para recuperar pérdidas sin reposición (fondo individual en pérdida)	-P/V
Monto adicional necesario para recuperar pérdidas con un aumento futuro r (fondo individual)	A=máx(0,-P/r-V), 0 si ya está en ganancia
Aumento necesario para recuperar pérdidas tras reponer A	-P/(V+A) (en caso de pérdida)
Valor de mercado total, ganancia/pérdida total, costo total del portafolio	ΣV, ΣP, ΣC
Rendimiento total del portafolio, aumento total necesario para recuperar pérdidas sin reposición	ΣP/ΣC, en pérdida -ΣP/ΣV
Reposición total para que cada fondo individual recupere pérdidas	Σmáx(0,-Pᵢ/r-Vᵢ) (términos en ganancia = 0)
Reposición teórica para que todo el portafolio compense ganancias y pérdidas	máx(0,-ΣP/r-ΣV), asumiendo que todas las tenencias suben r

Por defecto, se calculan los escenarios r=10% y r=20%, modificables por el usuario. Se verifica que (V+A)×(1+r) ≥ C+A con decimales exactos para los totales. No se incluyen por defecto explicaciones adicionales de principios de reposición, ejemplos de verificación o páginas de escenarios de recuperación del portafolio, para que lectores no profesionales puedan ver las tablas directamente.

Contenido Fijo del PDF (Por Defecto Solo Dos Páginas)

Nombre del informe y título de portada unificados: Análisis del Portafolio de Inversión en Fondos. No se utilizan otros títulos principales como "diagnóstico", "juicio clave" o "sugerencias de ejecución".

1. Resumen de la Cuenta: Fecha de instantánea, número de tenencias, valor de mercado actual, costo estimado, ganancia/pérdida acumulada, rendimiento total, aumento total necesario para recuperar pérdidas. Solo cifras y definiciones necesarias; sin opiniones de inversión ni gráficos de distribución de activos repetidos.
2. Única Tabla Resumen de Tenencias: Fondo/Código | Valor de Mercado Actual | Ganancia/Pérdida y Rendimiento | Aumento Necesario sin Reposición para Recuperar Pérdidas | Reposición Necesaria si Sube 10% | Reposición Necesaria si Sube 20%. Al final de la tabla, una breve nota: los totales de las dos columnas son estimaciones de reposición para que cada fondo individual recupere pérdidas, no recomendaciones de inversión. Las cifras de pérdida se muestran en rojo, las de ganancia en verde; los montos de reposición individuales que superen ≥10,000 yuanes se muestran en rojo y negrita con una advertencia de alto monto; el usuario puede modificar el umbral. Los montos son precisos al céntimo. No se añade una columna de "acción/juicio actual" sin evidencia suficiente.
3. Distribución de Activos del Portafolio: Solo se incluye un conjunto detallado de gráficos de barras horizontales con etiquetas de texto, donde cada fila muestra directamente la categoría, la barra, el porcentaje y el monto. Las categorías son mutuamente excluyentes y la suma de los montos es igual al valor de mercado total. Se adjuntan los fondos incluidos en cada categoría, la proporción máxima de una sola tenencia y el criterio de clasificación. No se deben dibujar gráficos de barras apiladas de colores repetidos en la página de inicio o encima del gráfico; no deben aparecer gráficos sin texto y solo con colores.

No se generan por defecto análisis de cambios de cartera, análisis de timing, comparaciones antes/después o contenido inferido de aumentos/disminuciones de sectores. Estas son tareas de investigación de trading separadas que requieren evidencia y no pueden derivarse únicamente del valor de mercado, las ganancias/pérdidas y las proporciones de distribución.

Presentación y Calidad

• Formato A4 vertical, en chino, con capacidad de búsqueda; texto en gráficos y tablas claro y legible, adecuado para ampliación en dispositivos móviles; el número de páginas es suficiente para completar el contenido, sin relleno o expansión intencionada.
• Colores estables para las categorías, pero el texto y los valores de las categorías deben mostrarse directamente con las barras. Las reposiciones de alto monto se resaltan en rojo; los montos normales y los títulos no deben abusar de los colores.
• No se pueden derivar opiniones de operación como "vale la pena reponer", "necesita vender" o "debería comprar de base amplia" a partir de las pérdidas flotantes originales o los montos de reposición condicional; no se deben agregar juicios de mercado prospectivos generalizados.
• Nombre del PDF: Análisis del Portafolio de Inversión en Fondos_YYYY-MM-DD.pdf. Se conserva la fecha de instantánea del informe para permitir comparaciones entre períodos.
• Después de la generación, se verifica la tabla de tenencias y el gráfico de barras por categoría, comprobando que el texto en chino y los números no se superpongan ni falten caracteres; se verifica ΣC=ΣV−ΣP y la conservación de los montos por grupo.

Método de Generación

Scripts generales:

• scripts/portfolio_calc.py: Cálculos decimales precisos y validación de montos.
• scripts/build_report_pdf.py: Lee JSON, llama al script de cálculos y genera un PDF en chino, compatible con --html para generar HTML de revisión.

Ejecución: python scripts/build_report_pdf.py input.json output.pdf. Estructura de ejemplo de entrada:

{
  "as_of": "YYYY-MM-DD",
  "currency": "CNY",
  "scenarios": ["0.10", "0.20"],
  "highlight_threshold": "10000",
  "positions": [
    {"code": "código_del_fondo", "name": "nombre_del_fondo", "market_value": "valor_mercado_actual", "pnl": "ganancia_pérdida_actual", "category": "categoría_principal_del_fondo"}
  ],
  "sold_excluded": []
}

El ZIP solo contiene la habilidad general y los scripts de cálculo y generación de PDF, sin ningún dato de tenencias de usuarios, discusiones históricas o conclusiones de transacciones individuales.