mirror of
https://github.com/taylanbakircioglu/flowfish.git
synced 2026-09-12 05:48:55 +00:00
taylanbakircioglu
582e3eba68
Restructure /dependencies/summary response to provide per-service downstream/callers breakdowns instead of a single aggregated view. Backend: - Unified loop in format_dependency_summary handles single and multi-service identically, fixing replica data loss bug for single-service queries - Each matched_service now carries its own downstream/callers DependencySummaryGroup - New top-level summary object with globally deduplicated aggregate counts (split downstream_critical_count and callers_critical_count) - hop_count added to _compact_service (only when > 1 to avoid depth=1 noise) - _dedup_entries now preserves entry with lowest hop_count on collision - multi_service flag now correctly checks collapsed workload count Frontend: - Updated TypeScript interfaces (DependencySummary, MatchedService with groups) - IntegrationHub Preview: per-service Collapse for multi-service, summary stats - DependencyCategoryGroup: conditional hop_count column for multi-depth queries - Snippet builders updated to parse matched_services and summary structure API & Docs: - OpenAPI spec: new DependencySummary schema, depth parameter descriptions - README, feature-list, DATA_ARCHITECTURE docs updated - Fixed pre-existing doc bug (default traversal depth 3 -> 1) Made-with: Cursor
🐟 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.