mirror of
https://github.com/taylanbakircioglu/flowfish.git
synced 2026-09-12 05:48:55 +00:00
taylanbakircioglu
7a5d4904a9
Bring the public mirror up to date with the latest developments: - L7 HTTP Path Visibility & Per-Path Edge Model (v2.7.0): real HTTP paths in the Service Map / Integration Hub / exports instead of "/". Touches event_transformer (path extraction), graph-writer per-path MERGE key + indexes, graph-query per-path counting, and the frontend. - Beyla route decoration to fix the `/*/*/*/*/*` star-explosion in API-gateway namespaces (low-cardinality route labelling). - RabbitMQ queue-declaration resilience: graph-writer and timeseries-writer tolerate a pre-existing queue whose arguments differ from the declaration (bind to the existing queue instead of crashing). - Version bump to 2.8.0 + CHANGELOG. Example hostnames/annotations use placeholder values (example.com).
🐟 Flowfish Documentation
This directory contains all project documentation organized by category.
📁 Directory Structure
/architecture/ - Architecture & Design Documents
Technical architecture, system design, and integration details.
🎯 Start Here (Architecture Overview)
- ARCHITECTURE_QUICK_REF.md - One-page architecture diagram & port reference
- ARCHITECTURE_SIMPLE.md - Simple data flow diagram with service summary
- ARCHITECTURE_DETAILED.md - Complete layered architecture with sequences
Detailed Documentation
- MICROSERVICES_ARCHITECTURE.md - Microservices architecture overview
- ENTERPRISE_MULTI_CLUSTER.md - Multi-cluster enterprise architecture
- RABBITMQ_INTEGRATION.md - RabbitMQ message queue integration
- INSPECTOR_GADGET_EVENTS.md - Inspektor Gadget event types
- HYBRID_STORAGE_ARCHITECTURE.md - Storage strategy (ClickHouse + Neo4j)
- MICROSERVICES_NAMES.md - Service naming conventions
- change-detection-worker.md - Change Detection Worker (scalable microservice)
/sprints/ - Sprint Plans & Roadmaps
Sprint planning, task breakdown, and development roadmaps.
- Sprint plans coming soon...
/analysis/ - Analysis & Status Reports
Project status, integration reports, and analysis documents.
- INTEGRATION_STATUS.md - Current integration status
- MODERNIZATION_SUMMARY.md - UI/UX modernization summary
/guides/ - User & Developer Guides
How-to guides, tutorials, and best practices.
- Guides coming soon...
Root Level Documents
Core project documentation that lives in the repository root:
- 01-executive-summary.md - Project overview and goals
- 02-feature-list.md - Detailed feature list by phase
- 03-architecture.md - High-level architecture
- 04-technology-stack.md - Technology choices and rationale
- 05-scalability.md - Scalability approach
- 06-security.md - Security design
- 07-roadmap.md - Project roadmap
📋 Quick Links
For Developers
- 🎯 Architecture Quick Reference - Start here!
- Simple Architecture Diagram
- Detailed Architecture
- Microservices Architecture
- Getting Started
- Local Development
For DevOps
For Project Managers
🔄 Document Status
| Category | Status | Last Updated |
|---|---|---|
| Architecture | ✅ Up to date | 2025-01-08 |
| Sprints | 🔴 Pending | - |
| Analysis | ✅ Up to date | 2024-11-21 |
| Guides | 🔴 Pending | - |
| Core Docs | ✅ Up to date | 2025-01-08 |
Note: This documentation structure follows best practices for organizing technical documentation in large projects.