mirror of https://github.com/SamyRai/turash.git synced 2025-12-26 23:01:33 +00:00

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

4.5 KiB

Raw Blame History

Turash: Complete Platform Specification

Executive Summary

Turash is a B2B SaaS platform that digitizes industrial symbiosis by connecting businesses' waste streams with neighboring demand, unlocking €50B+ annual savings across European industrial ecosystems.

The Problem

European industries waste €500B annually on virgin resource procurement and waste disposal while emitting 1.2B tons of CO₂. Industrial symbiosis (IS) could reduce this by 20-50%, but fragmented analog processes and information asymmetry prevent adoption. Existing platforms are either too academic or too narrow to drive meaningful change.

The Solution

A resource-matching engine that:

Digitizes Resource Flows: Captures heat, water, waste, and by-products with precision levels from rough estimates to verified measurements
Optimizes Multi-Party Exchanges: Uses graph algorithms to find economically viable matches within spatial and temporal constraints
Drives Adoption: Starts with "cheap-to-act" resources (waste pickup, shared services) and builds trust through tangible ROI
Scales Network Effects: Creates local industrial ecosystems where businesses trade resources like a marketplace

Market Opportunity

TAM: €500B European industrial resource flows
SAM: €50B addressable through digital IS platforms
SOM: €2B first-mover advantage in heat/waste matching (€500M by year 3)

For detailed market analysis, see 01_market_analysis.md

Business Model

Freemium: See + Match for free (network effects driver)
Subscription: €50-500/facility/month based on engagement
Transactions: 10-20% commission on facilitated exchanges
Municipal: License fees for city dashboards (€50k-200k/year)

For complete monetization strategy, see monetisation/ folder

Competitive Advantage

Data-First: Privacy tiers with device-signed validation
Multi-Modal: Resources + services + products in one platform
Local Focus: Geographic clustering drives higher match rates
Utility Partnerships: Leverage existing data and relationships
Real-World Data Handling: Proven capability with messy industrial data (CSVs, SCADA exports, municipal Excel, ERP feeds)

For competitive analysis, see 02_competitive_analysis.md

Exit Strategy

Primary: Acquisition by industrial automation players (Siemens, Schneider, ABB) seeking circular economy capabilities
Secondary: Smart-city platforms or utility software companies
Positioning: Proven B2B SaaS with €2M+ ARR, EU market leadership in industrial symbiosis

Go-to-Market Strategy

Primary Flywheel: SME-bottom-up - Build density through individual businesses → parks → cities buy established ecosystems
Secondary: City-top-down - Municipal pilots seed platforms, then transition to business-paid model
Policy-Resilient Entry Points: Multiple pathways to avoid single policy dependency

For detailed GTM strategy, see monetisation/go-to-market.md

Technical Foundation

Graph Database: Neo4j for complex relationship traversals
Go 1.25 Backend: Performance-optimized for real-time matching
Event-Driven: WebSocket notifications for live market updates
Privacy-First: Public/network-only/private data visibility tiers
Data Integration: ETL pipelines for industrial data sources (SCADA, ERP, Excel, CSV, IoT sensors, utility APIs)

For technical architecture, see 08_platform_architecture_features.md and 12_go_125_stack_backend_architecture.md

Key Metrics (Year 1 Goals)

Platform: 500 businesses, 50 cities, €2M ARR
Impact: 500 GWh waste heat matched, €50M savings, 100k tons CO₂ avoided
Product: 85% data completion rate, 60% match conversion, <2s response times

For detailed roadmap and metrics, see 28_project_roadmap.md

Team & Timeline

MVP: 3 months (heat matching, manual entry, 1 industrial park)
v1.0: 6 months (multi-resource, automated ingestion, 10 cities)
Scale: 12 months (enterprise features, international expansion)
Team: 8 engineers, 2 domain experts, 1 BD/sales

Funding Ask

Seeking €2.5M seed funding for 18-month runway to product-market fit and first revenue.

This document provides the complete technical specification, combining core concepts, architecture decisions, implementation details, and go-to-market strategy.

4.5 KiB Raw Blame History