mukimovd/turash
1
0
Fork 0
mirror of https://github.com/SamyRai/turash.git synced 2025-12-26 23:01:33 +00:00
Code Issues 1 Actions Packages Projects Releases Wiki Activity
b4715361cd
turash/docs/concept/05_system_overview.md
Damir Mukimov 000eab4740
Major repository reorganization and missing backend endpoints implementation 
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)
2025-11-25 06:01:16 +01:00

994 B
Raw Blame History

3. System Overview

🧩 Core Idea

A geo-temporal resource graph:

  • Nodes: 2.1M+ industrial entities across EU-27
  • Edges: €50B+ annual potential resource exchanges
  • Resources: typed and parameterized flows (heat, water, CO₂, chemicals, by-products, etc.)
  • Engine: spatial and semantic matching + economic evaluation

For detailed market opportunity analysis, see 01_market_analysis.md

Scale Metrics:

  • Initial Target: 500 businesses, 50 cities (Year 1)
  • Growth Target: 5,000 businesses, 200 cities (Year 3)
  • Performance Goals: <2s match response, >85% uptime, >99% data accuracy
  • Economic Impact: €500M+ annual savings, 100k+ tons CO₂ reduction (Year 1)

For detailed project roadmap and metrics, see 28_project_roadmap.md

The backend continuously updates the graph as new data streams (meters, ERP feeds, or manual inputs) arrive, and computes new match opportunities.