Graphify-কে একটি Gradle ওয়ার্কফ্লোকে অন্তর্ভুক্ত করুন: নোলেজ গ্রাফ থেকে প্লান্তЮএমএল ডায়াগ্রামে একক কমান্ড দিয়ে

@startuml
skinparam backgroundColor #FEFEFE
skinparam ActivityBackgroundColor #FDEDEC
skinparam ActivityDiamondBackgroundColor #FFF3CD

start

:আর্কিটেকচার ডায়াগ্রাম তৈরি\n(মানুয়ালি, হাতে);

:কোড विकাশ পাচ্ছে\n(নতুন ক্লাস, নতুন নির্ভরতা);

:ডায়াগ্রাম অপ্রচলিত\n(এখন কোডকে প্রতিফলিত করা হয় না);

if (Qui met à jour ?) then (Personne)
    :ভুল ডকুমেন্টেশন;
    note right: Les nouveaux développeurs\nse basent dessus... et font des erreurs
else (Quelqu'un)
    :মানুয়াল আপডেট\n(২-৩ ঘণ্টা কাজ);
    note right: এখনই অপ্রচলিত\nপরবর্তী PR-এ
endif

stop

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam componentStyle rectangle

actor Développeur
component "Graphify\n(pip install graphifyy)" as Graphify
collections "graphify-out/graph.json\n(জ্ঞান গ্রাফ)" as KGJSON
component "PlantUML Gradle প্লাগইন\n(generateKnowledgeGraphDiagram)" as Plugin
component "KnowledgeGraphParser" as Parser
component "KnowledgeGraphRenderer" as Renderer
component "PlantumlService\n(যাচাইকরণ + অঁকা PNG)" as PS
collections "ডায়াগ্রাম/knowledge-graph/\n(.puml + .png)" as Output

Développeur --> Graphify : graphify . --no-viz
Graphify --> KGJSON : উৎস কোডের\nকাঠামো বের করা
Développeur --> Plugin : ./gradlew generateKnowledgeGraphDiagram
Plugin --> Parser : parse(graph.json)
Parser --> Plugin : KnowledgeGraph\n(নোড + এজ + কমিউনিটি)
Plugin --> Renderer : render(graph, filters)
Renderer --> Plugin : কোড PlantUML\nনির্ধারিত
Plugin --> PS : validateSyntax + generateImage
PS --> Output : .puml + .png

note bottom of Plugin
পাইপলাইন DÉTERMINISTE
কোনও কল LLM
প্রতিলিপিযোগ্য ফলাফল
end note

@enduml

# Étape 1 : extraire le Knowledge Graph
graphify . --no-viz

# Étape 2 : générer les diagrammes PlantUML
./gradlew generateKnowledgeGraphDiagram

@startuml
skinparam backgroundColor #FEFEFE
skinparam componentStyle rectangle

package "সাধারণ পাইপলাইন\n(ব্যবহারকারী → ডায়াগ্রাম)" as normal {
    [Fichier .prompt] as prompt
    [LlmService\n+ ApiKeyPool] as llm1
    [ProcessPlantumlPromptsTask] as task1
    [Diagramme PNG] as out1

    prompt --> task1
    task1 --> llm1
    llm1 --> out1
}

package "পাইপলাইন নলেজ গ্রাফ\n(ডিটারমিনিস্টিক, LLM নেই)" as kg {
    [graphify-out/graph.json] as kgjson
    [KnowledgeGraphParser] as parser
    [KnowledgeGraphRenderer] as renderer
    [PlantumlService] as ps
    [Diagramme PNG\n(documentation du plugin)] as out2

    kgjson --> parser
    parser --> renderer
    renderer --> ps
    ps --> out2
}

package "পাইপলাইন ডগফুডিং\n(LLM → প্লাগইনের ডকুমেন্টেশন)" as dogfood {
    [GraphifyPromptAdapter] as gpa
    [Fichiers .prompt\nauto-générés] as auto_prompt
    [LlmService\n+ ApiKeyPool] as llm2
    [ProcessPlantumlPromptsTask] as task2
    [Diagramme PNG\n(documentation LLM)] as out3

    kgjson --> gpa
    gpa --> auto_prompt
    auto_prompt --> task2
    task2 --> llm2
    llm2 --> out3
}

note "একই LlmService, একই ApiKeyPool,\nএকই PlantumlService\n— শূন্য ডুপ্লিকেশন" as N

@enduml

# Documentation déterministe (rapide, pas de LLM)
./gradlew generateKnowledgeGraphDiagram

# Documentation LLM (plus riche, consomme des tokens)
./gradlew generateDiagramDocs

@startuml
skinparam backgroundColor #FEFEFE
skinparam componentStyle rectangle

rectangle "পাইপলাইন DÉTERMINISTE\\n(generateKnowledgeGraphDiagram)" as det {
    [graph.json] as json
    [KnowledgeGraphParser] as parser
    [KnowledgeGraphRenderer] as renderer
    [PlantUML code] as puml

    json --> পার্সr : পার্স
    parser --> renderer : KnowledgeGraph
    renderer --> puml : রেন্ডার (শুদ্ধ ফাংশন)
}

rectangle "পাইপলাইন LLM\\n(processPlantumlPrompts)" as llm {
    [.prompt] as prompt
    [LlmService] as llmSvc
    [ChatModel] as model
    [PlantUML code] as puml2

    prompt --> llmSvc
    llmSvc --> model : API কল
    model --> puml2 : অনির্ধারিত উত্তর
}

note bottom of det
একই ইনপুট → égale আউটপুট
নেটওয়ার্ক ল্যাটেন্সি নেই
টোকেন খরচ নেই
CI-এ পুনরাবৃত্তি করা যায়
end note

note bottom of llm
একই ইনপুট → পরিবর্তনশীল আউটপুট
নেটওয়ার্ক বিলম্ব (1-5s)
টোকেনের খরচ
API এর একটি কী প্রয়োজন
end note

@enduml

@startuml
skinparam backgroundColor #FEFEFE

participant "ডেভেলপার" as Dev
participant "Gradle" as G
participant "GenerateKnowledgeGraphDiagramTask" as Task
participant "KnowledgeGraphParser" as Parser
participant "KnowledgeGraphRenderer" as Renderer
participant "PlantumlService" as PS
collections "graphify-out/graph.json" as JSON
collections "diagrams/knowledge-graph/" as Out

Dev -> G : ./gradlew generateKnowledgeGraphDiagram
G -> Task : সম্পাদন
Task -> JSON : পড়া
Task -> Parser : parse(graph.json)
Parser --> Task : KnowledgeGraph

alt filtres actifs
    Task -> Task : ফিল্টার প্রয়োগ করুন n(community, edgeTypes, maxNodes…)
end

Task -> Renderer : render(graph, filters)
Renderer --> Task : কোড PlantUML

Task -> PS : validateSyntax()
alt valide
    Task -> PS : generateImage()
    PS --> Out : .puml + .png
else invalide
    Task -> Out : .puml (সতর্কতা সঙ্গে)
end

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam componentStyle rectangle

package "EAGER\n(সবসময় চার্জ করা)" as eager {
    [PROMPT_REPRISE.adoc\n(contexte session)] as pr
    [INDEX.adoc\n(vue d'ensemble)] as idx
    [GRAPH_REPORT.adoc\n(~50 lignes)] as gr
}

package "LAZY — পলিসি\n(অনুরোধে)" as lazy_strat {
    [Méthodologies] as meth
    [Archives sessions] as sessions
}

package "LAZY — Graphify\n(লক্ষ্যযোজিত প্রশ্ন)" as lazy_graph {
    [graph.json] as gj
    [Queries\n(query/path/explain)] as queries
}

package "PlantUML\n(অটো-জেনারেটেড)" as puml {
    [generateKnowledgeGraphDiagram] as kgTask
    [generateDiagramDocs] as ddTask
    [Diagrammes PNG] as diagrams
}

Agent --> eager : সেশনের শুরুতে পড়া
Agent ..> lazy_strat : টাইপ শনাক্ত হলে চার্জ
Agent ..> lazy_graph : Query যদি প্রয়োজন হয়, গঠনমূলক
kgTask --> diagrams : নির্ণয়মূলক
ddTask --> diagrams : LLM -এর মাধ্যমে

note right of gr
Knowledge Graph-র সংক্ষিপ্ত রূপ
দেব নোড + সম্প্রদায়
বদল করুন ECOSYSTEM_OVERVIEW
(২২৫ লাইন → ৫০ লাইন)
end note

@enduml

# Script complet en 5 commandes
uv tool install graphifyy
cat > .graphifyignore << 'EOF'
*-context.yml
*.env
build/
.gradle/
EOF
graphify . --no-viz
./gradlew generateKnowledgeGraphDiagram
git add graphify-out/GRAPH_REPORT.adoc graphify-out/graph.json diagrams/knowledge-graph/

@startuml
skinparam backgroundColor #FEFEFE

rectangle "আগে" as avant {
    card "হাতে আঁকা ডায়াগ্রাম\nসর্বদা অপ্রচলিত\nকেউ সেগুলো হালনাগাদ করে না" as av1 #FDEDEC
}

rectangle "পরে" as apres {
    card "স্বয়ংক্রিয়ভাবে তৈরি ডায়াগ্রাম\nকোডের সাথে সর্বদা হালনাগাদ\nGit-এ সংস্করণযুক্ত\nনির্ধারক এবং পুনরুৎপাদনযোগ্য" as ap1 #E8F8E8
}

avant --> apres : graphify . --no-viz\n+ ./gradlew generateKnowledgeGraphDiagram

@enduml