|
Some checks failed
CI/CD Pipeline / frontend-lint (push) Successful in 1m38s
CI/CD Pipeline / frontend-build (push) Failing after 35s
CI/CD Pipeline / backend-lint (push) Failing after 7m3s
CI/CD Pipeline / backend-build (push) Has been skipped
CI/CD Pipeline / e2e-test (push) Has been skipped
|
||
|---|---|---|
| .gitea/workflows | ||
| .playwright-mcp | ||
| archive | ||
| bugulma | ||
| data | ||
| docs | ||
| k8s | ||
| models | ||
| scripts | ||
| .gitignore | ||
| .woodpecker-trigger.md | ||
| .woodpecker.yml | ||
| ADMIN_PANEL_CONCEPT.md | ||
| COMMUNITY_FEATURES_PROPOSAL.md | ||
| COMMUNITY_FEATURES_QUICK_WINS.md | ||
| COMMUNITY_FEATURES_STATUS_REPORT.md | ||
| COMMUNITY_FUNCTIONALITY_WORKFLOW_REPORT.md | ||
| COMMUNITY_INTEGRATION_STRATEGY.md | ||
| idea.md | ||
| ORIGINAL_FEATURES_SUMMARY.md | ||
| people.md | ||
| PRODUCT_SERVICE_DISCOVERY_CONCEPT.md | ||
| PRODUCT_SERVICE_DISCOVERY_IMPLEMENTATION.md | ||
| README.md | ||
| SMALL_CITY_PROBLEMS_SOLUTIONS.md | ||
Turash: Industrial Symbiosis Platform
Turash guides businesses to optimal resource exchanges, navigating the complex landscape of industrial symbiosis and providing direction to sustainable profitability.
🌟 What is Turash?
Turash is a B2B SaaS platform that digitizes industrial symbiosis by connecting businesses' waste streams with neighboring demand. We unlock €50B+ annual savings across European industrial ecosystems through intelligent resource matching.
The Problem
European industries waste €500B annually on virgin resource procurement and waste disposal while emitting 1.2B tons of CO₂. Industrial symbiosis could reduce this by 20-50%, but fragmented analog processes prevent adoption.
The Solution
A resource-matching engine that:
- Digitizes Resource Flows: Captures heat, water, waste, and by-products with precision
- Optimizes Multi-Party Exchanges: Uses graph algorithms for economically viable matches
- Drives Adoption: Starts with "cheap-to-act" resources, builds trust through ROI
🏗️ Architecture
Core Components
- Graph Database: Neo4j for complex relationship traversals
- Relational Database: PostgreSQL with PostGIS for spatial operations
- Backend: Go 1.25+ with event-driven architecture
- Matching Engine: Graph algorithms for multi-party optimization
- API: RESTful with WebSocket real-time updates
Key Features
- Privacy-tiered data visibility (public/network/private)
- Automated ingestion from industrial data sources
- Geographic clustering for higher match rates
- Real-time market updates and notifications
📊 Market Opportunity
- TAM: €500B European industrial resource flows
- SAM: €50B addressable through digital IS platforms
- SOM: €2B first-mover advantage (€500M by year 3)
🎯 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)
🚀 Roadmap
MVP (Q1 2025)
- Heat matching in 1 industrial park
- Manual data entry, basic matching
- Proof of concept validation
v1.0 (Q2 2025)
- Multi-resource types (waste, water, materials)
- Automated data ingestion
- 10 cities, enterprise features
Scale (Q4 2025)
- Full platform, international expansion
- Advanced analytics and optimization
📁 Repository Structure
├── concept/ # Platform specifications & research
├── models/ # Go core algorithms & models
├── bugulma/ # Proof-of-concept implementation
├── docs/ # Documentation
│ ├── app/ # 🏗️ Core application docs (MVP, database)
│ ├── business/ # Business strategy, branding, funding
│ ├── implementation/ # Implementation plans and reports
│ ├── concept/ # Strategic concept and research
│ ├── dev_guides/ # Development guides
│ └── api/ # API documentation
├── scripts/ # Utility scripts and API tools
├── data/ # Sample data and datasets
├── archive/ # Archived data and completed projects
└── dev_guides/ # Development documentation
🛠️ Technology Stack
Backend
- Language: Go 1.25+
- Database: PostgreSQL 13+ with PostGIS
- Graph DB: Neo4j 5.0+
- Framework: Gin (HTTP), Gorilla WebSocket
- ORM: GORM with spatial extensions
Infrastructure
- Container: Docker & Docker Compose
- Deployment: Kubernetes-ready
- Monitoring: Prometheus + Grafana
- CI/CD: GitHub Actions
📈 Key Metrics
Platform Goals (Year 1)
- Adoption: 500 businesses, 50 cities
- Impact: 500 GWh waste heat matched, €50M savings, 100k tons CO₂ avoided
- Performance: 85% data completion, 60% match conversion, <2s response times
Success Metrics
- Monthly active businesses
- Resource exchange volume (€)
- CO₂ emissions avoided (tons)
- Customer acquisition cost
- Monthly recurring revenue
🤝 Contributing
We welcome contributions! Please see our contributing guidelines for details.
Development Setup
-
Clone the repository
git clone https://github.com/SamyRai/turash.git cd turash -
Review documentation
- Start with concept/00_introduction.md
- Check mvp_concept.md for current scope
-
Run core models
cd models go run .
📚 Documentation
Core Documentation
- Platform Specification - Complete technical overview
- MVP Concept - Current development focus
- Mathematical Models - Algorithm specifications
- Architecture - System design
- Database Structure - Data models and relationships
Business Documentation
- Business Model - Revenue streams and pricing
- Go-to-Market - Market strategy
- Competitive Analysis - Market positioning
- Funding Strategy - Funding applications and programs
- Branding - Brand identity and positioning
Technical Documentation
- Go 1.25 Stack - Backend architecture
- Graph Database Integration - Neo4j implementation
- PostGIS Integration - Spatial operations
- Development Guides - Framework and tool guides
Implementation & Planning
- Architecture Refactoring - Backend modernization plan
- Implementation Gap - Current vs. required features
- Project Readiness - Development status
🔗 Links
- Website: turash.com (planned)
- Documentation: docs.turash.com (planned)
- Demo: demo.turash.com (planned)
📞 Contact
- Email: contact@turash.com (planned)
- LinkedIn: Turash Platform
- Twitter: @turash
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
Turash draws inspiration from Tatar cultural heritage, where "tura" (compass) has guided travelers for centuries. We honor this tradition by providing businesses with clear direction through the complex landscape of industrial symbiosis.
Turash: Navigate Resource Exchanges 🚀