Un modelo de datos para subvenciones, reembolsos, préstamos condonables y programas de reparación
La ayuda para reparaciones del hogar no cabe de forma prudente en una tabla que solo tenga nombre, ciudad y cantidad. Un modelo útil necesita capas separadas para la identidad del registro, geografía de servicio, condiciones del beneficio, señales publicadas de elegibilidad, plazos, evidencia de fuente, localización y estado operativo. Los hechos desconocidos deben seguir siendo desconocidos.
Comience con el contrato vigente: compare los registros de la muestra con el esquema JSON. Use la salud del conjunto para ver las notas vigentes sobre filas e identidad basada en nombres, y la preparación para la venta para consultar el límite comercial actual. No sustituya un recuento guardado ni interprete la preparación como una puntuación de calidad.
Comience con una fila de programa por ciudad
Una fila de programa por ciudad es un registro servido y asociado con una ciudad. El esquema vigente dice que id es estable dentro de su ciudad, por lo que la clave prudente de la aplicación incluye tanto la ciudad como el ID. Un programa estatal, regional o nacional seleccionado puede aparecer en varias ciudades por diseño.
Por eso las filas municipales son ubicaciones para descubrir opciones, no recuentos verificados de programas jurídicamente separados. No cuente cada asociación repetida como una administración, un fondo o una oportunidad distinta.
Entienda las medidas publicadas de elementos distintos
El endpoint de salud define distinctPrograms como nombres únicos guardados. Define locallyUniquePrograms como nombres distintos que aparecen en una sola ciudad. Son medidas útiles del catálogo, pero ninguna constituye un registro verificado de identidades jurídicas.
La agrupación por nombres puede dividir un programa cuando cambia la redacción o unir programas distintos que comparten un nombre genérico. Antes de consolidar filas, compare la administración, la URL fuente, la geografía, las condiciones del beneficio y otra evidencia. Conserve las filas originales incluso cuando una capa analítica cree un grupo provisional.
Mantenga separadas la identidad y la presentación
| Capa | Ejemplos | Regla de modelado |
|---|---|---|
| Identidad del registro | Ciudad más id | Use la clave limitada que entrega la API. No suponga que el ID es único en todo el sistema. |
| Identidad publicada | name, source, URL citada | Conserve la redacción de la fuente y la administración. El nombre solo no sirve para eliminar duplicados. |
| Grupo analítico | Estimación de nombres distintos o grupo revisado entre ciudades | Identifique el método y no presente un grupo inferido como identidad jurídica verificada. |
| Presentación al usuario | Descripción, etiqueta de cantidad y fecha localizadas | Seleccione los campos localizados por separado y conserve la cita y la alternativa. |
Modele las condiciones del beneficio, no solo el sustantivo promocional
Guarde el tipo de ayuda publicado sin convertir productos distintos en uno solo:
- Subvención: puede no exigir devolución, pero aun así requerir autorización previa, inspecciones, costos permitidos, controles del contratista u ocupación continuada.
- Reembolso o incentivo: puede pagar solo después de una compra, instalación, inspección o entrega aprobada.
- Préstamo condonable: puede dejar de ser pagadero solo al cumplir condiciones como la ocupación durante cierto tiempo, y puede incluir un gravamen.
- Préstamo diferido: puede aplazar el pago hasta una venta, transferencia, refinanciamiento u otro evento.
- Financiamiento reembolsable: puede incluir evaluación crediticia, interés, cargos, garantía y condiciones del prestamista fuera de la decisión de descubrir ayudas.
- Servicio de reparación o ayuda en especie: puede brindar mano de obra, materiales, evaluación o pago al contratista en vez de efectivo al propietario.
- Beneficio tributario: puede reducir el impuesto debido bajo reglas y plazos separados, no aportar efectivo al principio del proyecto.
Si la fuente no establece las condiciones, guarde un valor desconocido o una etiqueta propia de la fuente. No infiera "subvención" del título de una página ni convierta un servicio de reparación en una adjudicación monetaria.
Trate la cantidad como un conjunto de hechos
Un campo numérico aislado es ambiguo. Mantenga por separado el valor, la etiqueta publicada, la moneda, la función de la cifra, quién recibe el pago, el momento, la participación en costos, las condiciones de devolución o condonación y la cita de respaldo cuando se conozcan. La API vigente expone maxAmount y etiquetas localizadas, pero su presencia no garantiza una adjudicación ni establece todas las condiciones.
No sume máximos entre filas, no infiera un total para el hogar ni suponga que un límite guardado puede reducir un préstamo. Las reglas para combinar programas y evitar duplicación de beneficios exigen evidencia explícita de la administración.
Represente la geografía como alcance, no como una sola cadena
Conserve la asociación con la ciudad usada para descubrir opciones y permita notas separadas sobre el área de servicio, como condado, estado, territorio de servicios públicos, jurisdicción tribal, regla rural, vecindario o zona de afiliado. La ciudad elegida no demuestra que una dirección particular califique.
Cuando un producto necesite comportamiento a nivel de dirección, debe usar un método geográfico revisado por separado y seguir enviando al usuario a confirmar el servicio con la administración. No infiera cobertura por un código postal cercano ni por el nombre de la ciudad postal.
Mantenga las señales de evaluación fuera de decisiones finales
Campos como eligibilityType, incomeRequirement, specialPopulations, projectTypes y fundingStatus pueden apoyar el descubrimiento. No sustituyen las reglas completas. El esquema advierte que fundingStatus puede retrasarse y que unknown exige confirmar con la administración.
El resultado de un filtro debe llamarse posible programa para investigar. Los hechos ausentes o contradictorios del hogar no deben tratarse en silencio como aprobados, rechazados o elegibles.
Convierta la procedencia y la localización en campos principales
Guarde la cita, el objeto de vigencia, la identidad de la solicitud, la versión de la API y la revisión del conjunto junto con las notas de evaluación. Una revisión identifica la generación servida, no la exactitud, vigencia, derechos ni idoneidad.
El esquema conserva los nombres en inglés y define variantes en español para descripciones, etiquetas de cantidades y fechas. No traduzca identificadores, nombres de fuentes, valores enumerados ni significado numérico en el mismo campo. Use una alternativa campo por campo y deje claro cuándo falta material en el idioma de la fuente.
Tablas recomendadas para el sistema receptor
- Filas de programas: ciudad, ID, identidad publicada, categoría, señales de evaluación y revisión servida.
- Condiciones del beneficio: tipo, función de la cantidad, momento del pago, devolución, gravamen, condonación, participación en costos y marcas de desconocido.
- Geografía: ciudad de descubrimiento y cualquier evidencia revisada sobre el área de servicio.
- Localización: un registro de valor y procedencia por cada campo que admita idiomas.
- Evidencia: URL citada, estado del enlace, alcance de revisión, fechas y campos de confianza.
- Grupos analíticos: grupo opcional entre ciudades, método, estado de revisión y filas integrantes.
- Correcciones: campo informado, URL de una fuente oficial, resumen de la fuente, fecha de revisión y resolución sin datos del solicitante.
Asigne la muestra vigente a su propio modelo
Conserve la identidad, la evidencia, los valores desconocidos y las alternativas de idioma antes de añadir una presentación específica.
Abrir el esquema del registro Explorar la muestra públicaPreguntas comunes
¿Cada fila de ciudad es un programa diferente?
No. Un programa más amplio puede estar asociado con varias ciudades. La fila es un registro de descubrimiento limitado a la ciudad.
¿El recuento de programas distintos es un recuento verificado de identidades?
No. La medida publicada agrupa nombres únicos guardados. La variación de nombres y los nombres genéricos limitan lo que puede establecer.
¿Un préstamo condonable puede guardarse como subvención?
No sin perder obligaciones importantes. Conserve el préstamo, la condonación, el gravamen, la ocupación y las condiciones que activan el pago o la condonación cuando la fuente las establezca.