{
  "_note": "Copy to assoc_fields.json on the host. Do not commit assoc_fields.json. This file is the canonical field definition for all association registry entries. Adding a field here and saving via the management interface will backfill all existing associations with the default value.",
  "_version": "1.0",
  "groups": [
    "Identity",
    "Physical Structure",
    "Governance and Management",
    "Legal and Compliance",
    "Record"
  ],
  "fields": [
    {
      "nickname": "assoc_legal_name",
      "label": "Legal Name",
      "type": "text",
      "group": "Identity",
      "default": "",
      "required": true,
      "help": "Full legal name as recorded with Illinois Secretary of State"
    },
    {
      "nickname": "assoc_type",
      "label": "Association Type",
      "type": "select",
      "group": "Identity",
      "default": "UNK",
      "options": ["Condominium", "Master", "CIC", "Unincorporated", "UNK", "Disputed"],
      "required": true,
      "help": "VS-01 verified value"
    },
    {
      "nickname": "assoc_statute",
      "label": "Governing Statute",
      "type": "text",
      "group": "Identity",
      "default": "",
      "required": false,
      "help": "e.g. 765 ILCS 605 — populated after VS-01 verification"
    },
    {
      "nickname": "assoc_street",
      "label": "Street Address",
      "type": "text",
      "group": "Identity",
      "default": "",
      "required": false,
      "help": "Physical address of the property"
    },
    {
      "nickname": "assoc_city",
      "label": "City",
      "type": "text",
      "group": "Identity",
      "default": "",
      "required": false,
      "help": ""
    },
    {
      "nickname": "assoc_county",
      "label": "County",
      "type": "text",
      "group": "Identity",
      "default": "",
      "required": false,
      "help": "e.g. Cook County"
    },
    {
      "nickname": "assoc_state",
      "label": "State",
      "type": "text",
      "group": "Identity",
      "default": "IL",
      "required": false,
      "help": ""
    },
    {
      "nickname": "assoc_zip",
      "label": "ZIP Code",
      "type": "text",
      "group": "Identity",
      "default": "",
      "required": false,
      "help": ""
    },
    {
      "nickname": "assoc_placekey",
      "label": "Placekey",
      "type": "text",
      "group": "Identity",
      "default": "",
      "required": false,
      "help": "Permanent geographic anchor — e.g. 247-222@5sb-8bs-y35"
    },
    {
      "nickname": "assoc_website",
      "label": "Association Website",
      "type": "text",
      "group": "Identity",
      "default": "",
      "required": false,
      "help": "URL of association-managed site if any"
    },
    {
      "nickname": "assoc_buildings",
      "label": "Number of Buildings",
      "type": "text",
      "group": "Physical Structure",
      "default": "UNK",
      "required": false,
      "help": "Integer or UNK — VS-02"
    },
    {
      "nickname": "assoc_units",
      "label": "Number of Units",
      "type": "text",
      "group": "Physical Structure",
      "default": "UNK",
      "required": false,
      "help": "Integer or UNK — VS-02"
    },
    {
      "nickname": "assoc_year_built",
      "label": "Year Built",
      "type": "text",
      "group": "Physical Structure",
      "default": "",
      "required": false,
      "help": "e.g. 1974"
    },
    {
      "nickname": "assoc_stories",
      "label": "Stories Per Building",
      "type": "text",
      "group": "Physical Structure",
      "default": "",
      "required": false,
      "help": "e.g. 3"
    },
    {
      "nickname": "assoc_mgmt_company",
      "label": "Management Company",
      "type": "text",
      "group": "Governance and Management",
      "default": "",
      "required": false,
      "help": ""
    },
    {
      "nickname": "assoc_mgmt_contact",
      "label": "Management Contact",
      "type": "text",
      "group": "Governance and Management",
      "default": "",
      "required": false,
      "help": "Name and email of primary contact"
    },
    {
      "nickname": "assoc_mgmt_certified",
      "label": "Manager IDFPR Certified",
      "type": "select",
      "group": "Governance and Management",
      "default": "UNK",
      "options": ["Yes", "No", "UNK"],
      "required": false,
      "help": "VS-03"
    },
    {
      "nickname": "assoc_cai_listing",
      "label": "CAI Directory Listing",
      "type": "text",
      "group": "Governance and Management",
      "default": "",
      "required": false,
      "help": "How the association or its management company appears in CAI — member, vendor, AAMC, etc."
    },
    {
      "nickname": "assoc_bbb_standing",
      "label": "BBB Standing",
      "type": "text",
      "group": "Governance and Management",
      "default": "",
      "required": false,
      "help": "Better Business Bureau rating and status for the management company"
    },
    {
      "nickname": "assoc_idfpr_complaint",
      "label": "IDFPR Complaints",
      "type": "text",
      "group": "Governance and Management",
      "default": "",
      "required": false,
      "help": "Any complaints on record against the manager at IDFPR"
    },
    {
      "nickname": "assoc_sos_id",
      "label": "SOS Entity File Number",
      "type": "text",
      "group": "Legal and Compliance",
      "default": "",
      "required": false,
      "help": "Illinois Secretary of State entity file number — VS-08"
    },
    {
      "nickname": "assoc_sos_standing",
      "label": "Corporate Standing",
      "type": "select",
      "group": "Legal and Compliance",
      "default": "UNK",
      "options": ["Active", "Dissolved", "UNK"],
      "required": false,
      "help": "VS-08"
    },
    {
      "nickname": "assoc_declaration_recorded",
      "label": "Declaration Recorded",
      "type": "select",
      "group": "Legal and Compliance",
      "default": "UNK",
      "options": ["Yes", "No", "UNK"],
      "required": false,
      "help": "VS-10"
    },
    {
      "nickname": "assoc_declaration_instrument",
      "label": "Declaration Instrument No.",
      "type": "text",
      "group": "Legal and Compliance",
      "default": "",
      "required": false,
      "help": "County Recorder document number — VS-10"
    },
    {
      "nickname": "assoc_liens_active",
      "label": "Active Liens",
      "type": "text",
      "group": "Legal and Compliance",
      "default": "",
      "required": false,
      "help": "Count or description of active liens recorded against units or the association"
    },
    {
      "nickname": "assoc_litigation_active",
      "label": "Active Litigation",
      "type": "text",
      "group": "Legal and Compliance",
      "default": "",
      "required": false,
      "help": "Known active cases from public court record"
    },
    {
      "nickname": "assoc_registered",
      "label": "Registered Date",
      "type": "readonly",
      "group": "Record",
      "default": "",
      "required": false,
      "help": "ISO date when this association was added to the registry — set automatically"
    },
    {
      "nickname": "assoc_updated",
      "label": "Last Updated",
      "type": "readonly",
      "group": "Record",
      "default": "",
      "required": false,
      "help": "ISO date of most recent update — set automatically"
    }
  ]
}