المحفظة المعمارية لـ JBake - الرؤية وحالات الاستخدام

@startuml
skinparam backgroundColor #FEFEFE
skinparam handwritten false

class ProjetAsciiDoc {
  +titre: String
  +jbake-type: "مشروع"
  +jbake-status: published|draft
  +jbake-date: Date
  +jbake-tags: List<String>
  --
  +project-category: String
  +project-client: String
  +project-duration: String
  +project-role: String
  +project-thumbnail: String
  +project-gallery: List<String>
  +project-tech-stack: String
  +project-highlights: List<String>
  +project-demo-url: String
  +project-github-url: String
  --
  +body: HTML (converti)
}

class JBakeEngine {
  +parse(asciidoc)
  +extractMetadata()
  +convertToHTML()
}

class ThymeleafTemplate {
  +portfolio.html
  +project.html
  +partials/project-card.html
}

class PortfolioPage {
  +published_projects: List
  +filtres: categories
}

ProjetAsciiDoc --> JBakeEngine : تحليل
JBakeEngine --> ThymeleafTemplate : يوفر بيانات
ThymeleafTemplate --> PortfolioPage : يولد
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam componentStyle rectangle

package "قوالب Thymeleaf" {
  component [index.html] as index
  component [portfolio.html] as portfolio
  component [project.html] as project

  package "أجزاء" {
    component [header.html] as header
    component [footer.html] as footer
    component [project-card.html] as card
    component [tech-badge.html] as badge
    component [gallery.html] as gallery
  }
}

package "البيانات JBake" {
  database "published_projects" as data
  database "محتوى (مشروع)" as content
}

index --> header
index --> footer

portfolio --> header
portfolio --> footer
portfolio --> card
data --> portfolio : تكرار

project --> header
project --> footer
project --> badge
project --> gallery
content --> project : مشروع فردي

note right of card
قطعة قابلة لإعادة الاستخدام
لعرض خريطة
لمشروع مع :
- thumbnail
- titre
- tags
- highlights
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE

rectangle "مستند AsciiDoc" {
  (":project-client: شركة أكمي") as attr1
  (":project-duration: 6 أشهر") as attr2
  (":project-tags: java, react") as attr3
}

rectangle "نموذج JBake" {
  (content['project-client']) as prop1
  (content['project-duration']) as prop2
  (content.tags) as prop3
}

rectangle "قالب Thymeleaf" {
  (th:text="${project['project-client']}") as tmpl1
  (th:text="${project['project-duration']}") as tmpl2
  (th:each="وسم : ${project.tags}") as tmpl3
}

attr1 --> prop1 : parsing
attr2 --> prop2 : parsing
attr3 --> prop3 : parsing

prop1 --> tmpl1 : binding
prop2 --> tmpl2 : binding
prop3 --> tmpl3 : binding
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam handwritten false

class ProjetAsciiDoc {
  +titre: String
  +jbake-type: "مشروع"
  +jbake-status: published|draft
  +jbake-date: Date
  +jbake-tags: List<String>
  __
  +project-category: String
  +project-client: String
  +project-duration: String
  +project-role: String
  +project-thumbnail: String
  +project-gallery: List<String>
  +project-tech-stack: String
  +project-highlights: List<String>
  +project-demo-url: String
  +project-github-url: String
  __
  +body: HTML (converti)
}

class JBakeEngine {
  +parse(asciidoc)
  +extractMetadata()
  +convertToHTML()
}

class ThymeleafTemplate {
  +portfolio.html
  +project.html
  +partials/project-card.html
}

class PortfolioPage {
  +published_projects: List
  +filtres: categories
}

ProjetAsciiDoc --> JBakeEngine : تحليل
JBakeEngine --> ThymeleafTemplate : يوفر بيانات
ThymeleafTemplate --> PortfolioPage : يولد
@enduml

@startuml
skinparam backgroundColor #FEFEFE

object Projet {
  project-category = "ويب"
  project-subcategory = "التجارة الإلكترونية"
  project-industry = "التجزئة"
  project-complexity = "عالي"
}

object Taxonomie {
  categories : [web, mobile, data, devops]
  subcategories : Map<category, List>
  industries : [retail, finance, healthcare, ...]
  complexities : [low, medium, high]
}

Projet --> Taxonomie : مُصنَّف وفقًا

note right of Taxonomie
يسمح بالتصفية المتعددة المعايير في القالب portfolio.html عبر JavaScript أو من جانب الخادم
end note
@enduml