Skip to content

Instantly share code, notes, and snippets.

@ag14spirit
Last active September 12, 2025 20:24
Show Gist options
  • Select an option

  • Save ag14spirit/d92a1da95f8d41a1d4e72c7bd12a0b62 to your computer and use it in GitHub Desktop.

Select an option

Save ag14spirit/d92a1da95f8d41a1d4e72c7bd12a0b62 to your computer and use it in GitHub Desktop.
This schema outlines the structure for extracting and organizing information from A/V project proposals. It covers project overview, scope, technical specifications, installation requirements, client needs, budget, and future considerations, ensuring consistent and complete A/V project documentation.
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "A/V Project Proposal Extraction",
"type": "object",
"properties": {
"project_metadata": {
"type": "object",
"properties": {
"client": {
"type": "object",
"properties": {
"organization": {
"type": "string"
},
"address": {
"type": "string"
},
"url": {
"type": "string"
},
"liaison": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"title": {
"type": "string"
},
"email": {
"type": "string",
"format": "email"
},
"phone": {
"type": "string"
}
},
"required": ["name", "title", "email", "phone"],
"additionalProperties": false
},
"other_contacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"title": {
"type": "string"
},
"email": {
"type": "string",
"format": "email"
},
"phone": {
"type": "string"
}
},
"required": ["name", "title", "email", "phone"],
"additionalProperties": false
}
}
},
"required": ["organization", "address", "liaison"],
"additionalProperties": false
},
"project_name": {
"type": "string"
},
"budget": {
"type": "number"
},
"start_date": {
"type": "string",
"format": "date"
},
"due_date": {
"type": "string",
"format": "date"
},
"location": {
"type": "object",
"properties": {
"site_name": {
"type": "string"
},
"address": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": ["site_name", "address"],
"additionalProperties": false
}
},
"required": ["client", "budget", "due_date"],
"additionalProperties": false
},
"project_overview": {
"type": "object",
"properties": {
"purpose": {
"type": "string",
"description": "The client's driving purpose behind the project; the intent or main objective as it pertains to the A/V installation."
},
"background": {
"type": "string",
"description": "The background context or impetus for the A/V project, including existing infrastructure or previous installations, if present."
},
"approach": {
"type": "string",
"description": "The pre-sales design concept and expectations, including remarkable techniques, methods, or intricacies required to meet client objectives. Describes reasoning behind the path chosen for the project."
},
"expectations": {
"type": "string",
"description": "Narrative or bullet-style description of the business goals and A/V-related objectives as presented in the client's request. Include client needs, preferences, special use cases, or unique scenarios as contractually noted."
},
"objectives": {
"type": "string",
"description": "List of contractually itemized objectives to be achieved as a result of completing the project."
}
},
"required": ["purpose", "background", "objectives"],
"additionalProperties": false
},
"project_scope": {
"type": "object",
"properties": {
"work_summary": {
"type": "string",
"description": "Concise summary of contractual work to be completed (2-3 sentences)."
},
"detailed_scope": {
"type": "object",
"properties": {
"audio": {
"type": "array",
"description": "Itemized list of in-scope audio system deliverables.",
"items": {
"type": "string"
}
},
"video": {
"type": "array",
"description": "Itemized list of in-scope video system deliverables.",
"items": {
"type": "string"
}
},
"lighting": {
"type": "array",
"description": "Itemized list of in-scope lighting system deliverables.",
"items": {
"type": "string"
}
},
"acoustics": {
"type": "array",
"description": "Itemized list of in-scope acoustics-related deliverables.",
"items": {
"type": "string"
}
},
"controls": {
"type": "array",
"description": "Itemized list of in-scope control/automation system deliverables.",
"items": {
"type": "string"
}
},
"creative": {
"type": "array",
"description": "Itemized list of in-scope creative content or design-related deliverables.",
"items": {
"type": "string"
}
},
"scenic": {
"type": "array",
"description": "Itemized list of in-scope fabrication, scenic, or environment-related deliverables.",
"items": {
"type": "string"
}
},
"curation": {
"type": "array",
"description": "Itemized list of in-scope curation and presentation services for key museum pieces, artifacts, elements, or other historic centerpieces.",
"items": {
"type": "string"
}
}
},
"required": [],
"additionalProperties": false
},
"zones": {
"type": "array",
"description": "Architectural or functional areas relevant to the system installation.",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"zone_name": {
"type": "string",
"description": "Name or label of the architectural zone (e.g., auditorium)."
},
"description": {
"type": "string",
"description": "Short narrative or notes about the zone's special considerations relevant to the system installation."
}
},
"required": ["zone_name", "description"],
"additionalProperties": false
}
},
"products": {
"type": "array",
"description": "Relevant itemized in-scope products, technologies, or services with details.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Product name or brief description."
},
"brand": {
"type": "string",
"description": "Product brand or manufacturer."
},
"model": {
"type": "string",
"description": "Product model number or SKU identifier."
},
"key_specifications": {
"type": "string",
"description": "Critical specifications or comments as contractually noted."
}
},
"required": ["name", "brand", "model", "key_specifications"],
"additionalProperties": false
}
},
"OFE": {
"type": "array",
"description": "Contractually itemized owner-furnished equipment (OFE) to be provided by the client.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Product name or brief description."
},
"brand": {
"type": "string",
"description": "Product brand or manufacturer."
},
"model": {
"type": "string",
"description": "Product model number or SKU identifier."
},
"key_specifications": {
"type": "string",
"description": "Critical specifications or comments as contractually noted."
}
},
"required": ["name", "brand", "model"],
"additionalProperties": false
}
},
"selections": {
"type": "array",
"description": "Itemized product color preferences, as contractually noted.",
"items": {
"type": "object",
"properties": {
"product": {
"type": "string",
"description": "Product name or brief description."
},
"type": {
"type": "string",
"description": "Product type or category."
},
"color": {
"type": "string",
"description": "Product color preference."
},
"qty": {
"type": "string",
"description": "Product quantity for each specified color."
}
},
"required": ["product", "color", "qty"],
"additionalProperties": false
}
}
},
"required": ["work_summary", "detailed_scope", "zones", "products"],
"additionalProperties": false
},
"project_management_plan": {
"type": "object",
"properties": {
"milestones": {
"type": "string",
"description": "Key dates, deadlines, phases, and milestones."
},
"budget_breakdown": {
"type": "string",
"description": "Cost estimates, financial considerations, or cost breakdowns as contractually noted."
},
"RAID_log": {
"type": "object",
"description": "Early RAID items identified during the planning phase",
"properties": {
"risks": {
"type": "array",
"description": "Potential problems that could impact the project.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"owner": {
"type": "string"
},
"mitigation": {
"type": "string"
},
"identified_on": {
"type": "string",
"format": "date"
}
},
"required": ["description"]
}
},
"assumptions": {
"type": "array",
"description": "Factors presumed true for planning, such as existing conditions or client/owner obligations.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"rationale": {
"type": "string"
},
"validated_by": {
"type": "string"
},
"assumed_on": {
"type": "string",
"format": "date"
}
},
"required": ["description"]
}
},
"issues": {
"type": "array",
"description": "Unplanned problems encountered early, such as contradictory scope inclusions and exclusions.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"owner": {
"type": "string"
},
"resolution": {
"type": "string"
},
"raised_on": {
"type": "string",
"format": "date"
}
},
"required": ["description"]
}
},
"decisions": {
"type": "array",
"description": "Key choices made during planning, including product finish color selections.",
"items": {
"type": "object",
"properties": {
"decision": {
"type": "string"
},
"made_by": {
"type": "string"
},
"date": {
"type": "string",
"format": "date"
},
"impact": {
"type": "string"
}
},
"required": ["decision", "made_by"]
}
}
},
"required": ["risks", "assumptions", "issues", "decisions"],
"additionalProperties": false
}
},
"required": ["milestones", "RAID_log", "budget_breakdown"],
"additionalProperties": false
},
"quality_management_plan": {
"type": "object",
"properties": {
"performance": {
"type": "string",
"description": "Technical requirements and metrics for critical system component performance evaluation."
},
"standards": {
"type": "string",
"description": "Any industry standards, codes, or certifications as contractually noted."
},
"training": {
"type": "string",
"description": "Information on user training, support plans, warranties, or service agreements as contractually included."
},
"integration": {
"type": "string",
"description": "Protocols, standards, or descriptions of interoperability among systems, including owner furnished equipment (OFE) interactions with contractually scoped systems."
}
},
"required": ["performance"],
"additionalProperties": false
},
"future_considerations": {
"type": "object",
"properties": {
"scalability": {
"type": "string",
"description": "Provisions for future expansion or upgrades."
},
"future_trends": {
"type": "string",
"description": "Relevant or emerging trends and technologies highlighted in the proposal."
}
},
"required": [],
"additionalProperties": false
}
},
"required": [
"project_metadata",
"project_overview",
"project_scope",
"project_management_plan",
"quality_management_plan"
],
"additionalProperties": false
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment