mirror of
https://github.com/SamyRai/turash.git
synced 2025-12-26 23:01:33 +00:00
000eab4740
Repository Structure:
- Move files from cluttered root directory into organized structure
- Create archive/ for archived data and scraper results
- Create bugulma/ for the complete application (frontend + backend)
- Create data/ for sample datasets and reference materials
- Create docs/ for comprehensive documentation structure
- Create scripts/ for utility scripts and API tools
Backend Implementation:
- Implement 3 missing backend endpoints identified in gap analysis:
* GET /api/v1/organizations/{id}/matching/direct - Direct symbiosis matches
* GET /api/v1/users/me/organizations - User organizations
* POST /api/v1/proposals/{id}/status - Update proposal status
- Add complete proposal domain model, repository, and service layers
- Create database migration for proposals table
- Fix CLI server command registration issue
API Documentation:
- Add comprehensive proposals.md API documentation
- Update README.md with Users and Proposals API sections
- Document all request/response formats, error codes, and business rules
Code Quality:
- Follow existing Go backend architecture patterns
- Add proper error handling and validation
- Match frontend expected response schemas
- Maintain clean separation of concerns (handler -> service -> repository)
98 lines
2.7 KiB
JSON
98 lines
2.7 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://cityresourcegraph.com/schemas/match_query_request.json",
|
|
"title": "Match Query Request",
|
|
"description": "Request schema for finding resource matches",
|
|
"type": "object",
|
|
"properties": {
|
|
"resource": {
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"type": "string",
|
|
"enum": ["heat", "water", "steam", "CO2", "biowaste", "cooling", "logistics", "materials", "service"],
|
|
"description": "Resource type to match"
|
|
},
|
|
"direction": {
|
|
"type": "string",
|
|
"enum": ["input", "output"],
|
|
"description": "Looking for supply or demand"
|
|
},
|
|
"site_id": {
|
|
"type": "string",
|
|
"format": "uuid",
|
|
"description": "Site location for spatial matching"
|
|
},
|
|
"temperature_range": {
|
|
"type": "object",
|
|
"properties": {
|
|
"min_celsius": {"type": "number"},
|
|
"max_celsius": {"type": "number"}
|
|
},
|
|
"description": "Temperature range for thermal resources"
|
|
},
|
|
"quantity_range": {
|
|
"type": "object",
|
|
"properties": {
|
|
"min_amount": {"type": "number"},
|
|
"max_amount": {"type": "number"},
|
|
"unit": {"type": "string"}
|
|
},
|
|
"description": "Quantity range requirements"
|
|
}
|
|
},
|
|
"required": ["type", "direction"]
|
|
},
|
|
"constraints": {
|
|
"type": "object",
|
|
"properties": {
|
|
"max_distance_km": {
|
|
"type": "number",
|
|
"minimum": 0,
|
|
"maximum": 1000,
|
|
"default": 25,
|
|
"description": "Maximum transport distance"
|
|
},
|
|
"min_economic_value": {
|
|
"type": "number",
|
|
"minimum": 0,
|
|
"default": 1000,
|
|
"description": "Minimum annual economic value (€)"
|
|
},
|
|
"precision_preference": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"enum": ["measured", "estimated", "rough"]
|
|
},
|
|
"default": ["measured", "estimated"],
|
|
"description": "Preferred data precision levels"
|
|
},
|
|
"include_services": {
|
|
"type": "boolean",
|
|
"default": true,
|
|
"description": "Include service matches"
|
|
}
|
|
}
|
|
},
|
|
"pagination": {
|
|
"type": "object",
|
|
"properties": {
|
|
"limit": {
|
|
"type": "integer",
|
|
"minimum": 1,
|
|
"maximum": 100,
|
|
"default": 20
|
|
},
|
|
"offset": {
|
|
"type": "integer",
|
|
"minimum": 0,
|
|
"default": 0
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"required": ["resource"],
|
|
"additionalProperties": false
|
|
}
|