mirror of
https://github.com/taylanbakircioglu/flowfish.git
synced 2026-09-12 05:48:55 +00:00
taylanbakircioglu
6e503368f7
- Grafana Beyla DaemonSet for kernel-level HTTP/gRPC/DNS capture (passive, zero application changes, W3C traceparent header propagation) - flowfish-l7-collector in-cluster bridge: OTLP receiver + buffered pull API - L7 Ingestion Service: K8s service-proxy poll → enrich → RabbitMQ - ClickHouse l7_http_flows / l7_grpc_flows / l7_dns_flows + APM RED MVs - Neo4j L7Workload nodes + SAME_WORKLOAD cross-cluster bridges - New pages: Service Map, Trace Explorer, APM Services List, APM Service Detail - Analysis Wizard now supports L4 / L7 / Both modes with HTTP/gRPC/DNS picks - Integration Hub gains L7 dependency summary + tree-summary integrations - Multi-Cluster Management: dual-agent install (Inspector Gadget L4 + Beyla L7), runtime OpenShift detection so SCCs auto-install with kubectl too - ServiceMap edge → Trace Explorer drill-down with virtual_trace_id correlation - Docs: new L7 architecture diagram, README L7 sections, 3 new screenshots
🐟 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.