نقشه پیاده‌سازی در Confluence
این طراحی برای پیاده‌سازی بر بستر Atlassian Confluence تهیه شده است. هر بخش رابط کاربری به یک قابلیت بومی یا افزونه متعارف نگاشت شده و برای قابلیت‌های وابسته به افزونه، جایگزین بومی نیز تعیین شده است.
مبنای نسخه
نگاشت‌ها بر پایه Confluence Data Center نوشته شده‌اند. در نسخه Cloud، متغیرهای قالب و Stylesheet سفارشی در دسترس نیستند و برای آن‌ها از متن راهنمای قالب و افزونه پوسته استفاده می‌شود. برای دیدن معادل هر بخش روی خود صفحات، «راهنمای Confluence» را از سربرگ روشن کنید.
اولویت با قابلیت‌های بومی
هر بخش ابتدا با ماکروها و امکانات استاندارد Confluence طراحی شده و افزونه فقط جایی پیشنهاد شده که ارزش افزوده روشنی دارد.
داده‌محور با برچسب و ویژگی صفحه
همه فهرست‌ها، فیلترها و گزارش‌ها از برچسب‌ها و جدول ویژگی‌های صفحه تغذیه می‌شوند؛ بنابراین با ثبت هر دانش، صفحات به‌روز می‌مانند.
دسترسی در سطح فضا و صفحه
محرمانگی با مجوزهای فضا و محدودیت صفحه اعمال می‌شود و نیاز به توسعه اختصاصی ندارد.
معماری فضاها
هر حوزه دانشی یک فضای مستقل با مالک و مجوزهای مشخص است. همه فضاهای دانشی دسته فضای km دارند تا جست‌وجوی سراسری با CQL ممکن باشد و صفحه اصلی فضای KM صفحه اصلی سایت است.
| کلید فضا | عنوان | کاربرد | دسترسی |
|---|---|---|---|
| KM | پورتال مدیریت دانش | صفحه اصلی سامانه، راهنمای استفاده، پرسش‌های پرتکرار و قالب‌های سراسری | مشاهده: همه کارکنان؛ ویرایش: تیم مدیریت دانش |
| TECH | دانش فنی و تخصصی | معماری نرم‌افزار، زیرساخت و شبکه، توسعه نرم‌افزار و امنیت اطلاعات | مشاهده و ایجاد: کارکنان فنی؛ انتشار: مالک حوزه |
| PROC | دانش فرایندی و سازمانی | فرایندهای کاری، دستورالعمل‌ها و رویه‌های اجرایی | مشاهده: همه کارکنان؛ ایجاد: مالکان فرایند |
| PROJ | دانش پروژه‌ای | مستندات، تجربیات و درس‌آموخته‌های پروژه‌ها | مشاهده: همه کارکنان؛ صفحات حساس با محدودیت صفحه |
| LEARN | آموزش و یادگیری | مسیرهای یادگیری، محتوای آموزشی و آموزش ابزارها | مشاهده: همه کارکنان؛ ایجاد: تیم آموزش و مدرسان |
| ANLY | دانش تحلیلی و مدیریتی | گزارش‌های تحلیلی، مطالعات تخصصی و مستند تصمیمات | مشاهده: مدیران و تحلیلگران؛ محدودیت در سطح فضا |
| INNO | نوآوری و بهبود | ایده‌ها، پیشنهادها و راهکارهای بهبود | مشاهده و ایجاد: همه کارکنان |
نمونه درخت صفحات فضای TECH
- دانش فنی و تخصصی (صفحه اصلی فضا)
- معماری نرم‌افزار
- راهنمای استاندارد طراحی API در سامانه‌های بانکی
- معماری مرجع میکروسرویس‌ها در سامانه‌های پرداخت
- زیرساخت و شبکه
- دستورالعمل بررسی خطاهای ارتباطی سرویس‌های پرداخت
- الگوهای پایش و هشداردهی زیرساخت
- توسعه نرم‌افزار
- چگونه خطای Timeout در فراخوانی سرویس‌های شاپرک را عیب‌یابی کنیم؟
- امنیت اطلاعات
- چک‌لیست امنیتی پیش از استقرار سرویس‌ها در محیط عملیاتی
قرارداد برچسب‌ها
km-type-*km-type-guide، km-type-lesson- نوع دانش؛ مبنای فیلتر نوع، قالب‌ها و گزارش درس‌آموخته‌ها
km-unit-*km-unit-payments، km-unit-security- واحد سازمانی؛ مبنای فیلتر واحد در جست‌وجو
km-featuredkm-featured- دانش منتخب تیم مدیریت دانش؛ بخش پرکاربرد صفحه اصلی
برچسب موضوعیapi، امنیت، شاپرک- موضوع دانش؛ مبنای جست‌وجو و دانش‌های مرتبط. بدون فاصله و با خط تیره
قالب‌های صفحه و ویژگی‌ها
برای هر نوع دانش یک قالب صفحه تعریف می‌شود. جدول ویژگی‌های صفحه در ابتدای همه قالب‌ها یکسان است تا گزارش‌های تجمیعی کار کنند.
فیلدهای مشترک Page Properties
نوع دانشدسته‌بندی و زیرمجموعهواحد سازمانیمالک دانشسطح محرمانگیوضعیت (ماکرو Status)تاریخ بازبینی بعدی
KM - راهنمای تخصصی
km-type-guide- ۱خلاصه مدیریتی
- ۲هدف و دامنه کاربرد
- ۳پیش‌نیازها
- ۴شرح دانش
- ۵مراحل اجرا
- ۶نکات تخصصی
- ۷خطاهای رایج و راهکارها
- ۸منابع
KM - دستورالعمل
km-type-instruction- ۱خلاصه
- ۲دامنه کاربرد
- ۳پیش‌نیازها
- ۴مراحل اجرا
- ۵مسیر تشدید
- ۶خطاهای رایج
- ۷منابع
KM - درس‌آموخته
km-type-lesson- ۱خلاصه تجربه
- ۲زمینه پروژه
- ۳مسئله یا چالش
- ۴راهکار ارائه‌شده
- ۵نتیجه و دستاورد
- ۶توصیه‌ها
KM - محتوای آموزشی
km-type-training- ۱هدف آموزشی
- ۲مخاطب و پیش‌نیاز
- ۳سرفصل‌ها
- ۴ویدئو یا ارائه
- ۵تمرین
- ۶منابع تکمیلی
KM - مستندات پروژه
km-type-project-doc- ۱معرفی پروژه
- ۲نمای کلی معماری
- ۳تصمیمات کلیدی
- ۴وابستگی‌ها
- ۵منابع
KM - تحلیل و تحقیق
km-type-research- ۱خلاصه مدیریتی
- ۲روش بررسی
- ۳یافته‌ها
- ۴پیشنهادها
- ۵منابع
KM - پرسش و پاسخ
km-type-qa- ۱پرسش
- ۲پاسخ کوتاه
- ۳توضیح تکمیلی
- ۴منابع مرتبط
نگاشت صفحات به قابلیت‌های Confluence
برای هر بخش طراحی، قابلیت پیاده‌سازی و نوع آن مشخص شده است.
بومیقابلیت استاندارد Confluence، بدون نیاز به افزونهافزونهنیازمند نصب افزونه از Marketplace یا قابلیت نسخه‌های بالاترجایگزین بومیراهکار جایگزین با امکانات پایه در صورت نبود افزونه
صفحه اصلی
مشاهده صفحه| بخش طراحی | قابلیت Confluence | نوع | توضیح |
|---|---|---|---|
| نوار جست‌وجو | Livesearch | بومی | با پارامتر فضا و برچسب، در بالای صفحه اصلی فضای KM |
| بخش معرفی و دکمه‌ها | Section & Column، Image، Create from Template | بومی | دکمه ثبت دانش به قالب‌های فضای مقصد متصل می‌شود |
| کارت‌های دسته‌بندی | Panel در ستون‌ها، پیوند فضا | بومی | عدد مستندات با به‌روزرسانی دوره‌ای دستی یا افزونه گزارش‌گیری |
| تازه‌ترین دانش‌ها | Content by Label با نمایش Excerpt | بومی | مرتب‌سازی بر اساس تاریخ ایجاد یا ویرایش |
| تب پربازدیدترین | Analytics یا افزونه گزارش‌گیری | افزونه | جایگزین: فهرست منتخب با برچسب km-featured |
| دانش‌های پرکاربرد | Content by Label (km-featured) | بومی | انتخاب و به‌روزرسانی ماهانه توسط تیم مدیریت دانش |
| درس‌آموخته‌ها | Page Properties Report | بومی | ستون‌های چالش، راهکار و نتیجه از جدول ویژگی‌های صفحه |
| پرسش‌های پرتکرار | Expand | بومی | پاسخ‌ها با Excerpt Include از صفحه پرسش‌ها خوانده می‌شوند |
دسته‌بندی و فهرست دانش‌ها
مشاهده صفحه| بخش طراحی | قابلیت Confluence | نوع | توضیح |
|---|---|---|---|
| هر دسته‌بندی | یک فضا (Space) با صفحه اصلی اختصاصی | بومی | زیرمجموعه‌ها صفحات والد درخت صفحات هستند |
| فهرست زیرمجموعه‌ها | Children Display | بومی | با نمایش خلاصه هر صفحه |
| فهرست دانش‌های حوزه | Content by Label | بومی | محدود به فضای همان حوزه |
| مشارکت‌کنندگان فعال | Contributors | بومی | محدود به فضای حوزه |
| برچسب‌های پرکاربرد | Popular Labels | بومی | در سطح سایت یا فضا |
جست‌وجوی دانش
مشاهده صفحه| بخش طراحی | قابلیت Confluence | نوع | توضیح |
|---|---|---|---|
| جست‌وجوی متنی و پیشنهاد هنگام تایپ | Quick Search و صفحه جست‌وجوی بومی | بومی | فیلترهای فضا، مشارکت‌کننده، تاریخ و نوع محتوا |
| فیلتر نوع دانش و واحد | برچسب‌های km-type و km-unit در CQL | بومی | مثال: label = km-type-guide AND space = TECH |
| فیلتر پویا روی گزارش‌ها | Table Filter | افزونه | جایگزین: جست‌وجوی پیشرفته بومی |
صفحه جزئیات دانش
مشاهده صفحه| بخش طراحی | قابلیت Confluence | نوع | توضیح |
|---|---|---|---|
| اطلاعات تکمیلی و وضعیت | Page Properties و Status | بومی | منبع داده همه گزارش‌های تجمیعی |
| خلاصه مدیریتی | Excerpt درون Info Panel | بومی | در فهرست‌ها و نتایج نمایش داده می‌شود |
| فهرست مطالب | Table of Contents | بومی | بر اساس سرفصل‌های صفحه |
| مراحل اجرا | Task List یا فهرست شماره‌دار | بومی | - |
| نمودارها | draw.io | افزونه | جایگزین: تصویر پیوست‌شده با ماکرو Image |
| نکات و خطاهای رایج | Tip Panel و Expand | بومی | - |
| پیوست‌ها و منابع | Attachments و پیوند صفحه | بومی | - |
| تاریخچه نسخه‌ها | Page History | بومی | مقایسه و بازگشت به نسخه قبلی |
| دانش‌های مرتبط | Content by Label | بومی | بر اساس برچسب‌های مشترک |
| آیا مفید بود؟ | Like | بومی | بازخورد ساختاریافته با افزونه بازخورد صفحه |
| نظرات و پیشنهاد اصلاح | Comments و Inline Comments | بومی | - |
| علاقه‌مندی و اشتراک | Save for later و Share | بومی | - |
ثبت دانش جدید
مشاهده صفحه| بخش طراحی | قابلیت Confluence | نوع | توضیح |
|---|---|---|---|
| انتخاب نوع دانش | Create from Template و Page Templates | بومی | هفت قالب، یکی برای هر نوع دانش |
| فیلدهای اطلاعات پایه | Template Variables | بومی | در ویرایشگر Data Center؛ مقادیر در Page Properties درج می‌شوند |
| فرم چندمرحله‌ای با اعتبارسنجی | افزونه فرم مانند ConfiForms | افزونه | جایگزین: قالب با متن راهنما و ویژگی‌های صفحه |
| کلمات کلیدی | Labels | بومی | - |
| پیوست‌ها | Attachments | بومی | - |
| سطح محرمانگی | Restrictions | بومی | به همراه فیلد سطح محرمانگی در Page Properties |
| پیش‌نویس | Drafts | بومی | - |
| ارسال برای بررسی | Status، Restrictions و Task برای بازبین | بومی | گردش تأیید چندمرحله‌ای با افزونه مدیریت سند |
درس‌آموخته‌ها، آموزش و پروفایل
مشاهده صفحه| بخش طراحی | قابلیت Confluence | نوع | توضیح |
|---|---|---|---|
| کارت‌های درس‌آموخته | Page Properties Report | بومی | فیلتر با برچسب km-type-lesson |
| مسیرهای یادگیری | Children Display | بومی | هر مسیر یک صفحه والد با صفحات فرزند مرتب |
| پیشرفت شخصی | Task List و Task Report | بومی | نسخه شخصی مسیر از قالب ایجاد می‌شود |
| ویدئوهای آموزشی | Multimedia | بومی | پخش فایل پیوست‌شده در صفحه |
| کارت پروفایل | User Profile | بومی | - |
| فعالیت‌های اخیر | Recently Updated با فیلتر نویسنده | بومی | - |
| آمار بازدید | Analytics یا افزونه گزارش‌گیری | افزونه | جایگزین: نمایش تعداد دانش‌ها با Page Properties Report |
| علاقه‌مندی‌ها | Save for later | بومی | - |
افزونه‌های پیشنهادی و جایگزین بومی
هیچ‌کدام از افزونه‌ها برای راه‌اندازی سامانه الزامی نیستند؛ اگر نصب نشوند، جایگزین بومی همان نیاز را با سادگی بیشتر برآورده می‌کند.
| افزونه | کاربرد در طراحی | جایگزین بومی |
|---|---|---|
| draw.io Diagrams | نمودارهای معماری و فرایند قابل ویرایش در صفحه | تصویر پیوست‌شده با ماکرو Image |
| ConfiForms یا Forms for Confluence | فرم چندمرحله‌ای ثبت دانش با اعتبارسنجی | قالب صفحه با متغیرهای قالب و متن راهنما |
| Comala Document Management | گردش تأیید چندمرحله‌ای و ثبت سابقه تأیید | ماکرو Status، محدودیت صفحه و Task برای بازبین |
| Table Filter, Charts & Spreadsheets | فیلتر پویا روی گزارش‌های Page Properties | جست‌وجوی بومی با CQL و برچسب‌ها |
| Analytics یا افزونه گزارش‌گیری | آمار بازدید، پربازدیدترین‌ها و شمارش خودکار | فهرست منتخب با برچسب km-featured و حذف عدد |
| Refined یا Scroll Viewport | پوسته و ناوبری اختصاصی پورتال | Stylesheet سراسری و میانبرهای فضا در Data Center |
گردش بررسی و انتشار
وضعیت هر دانش با ماکرو Status در جدول ویژگی‌های صفحه ثبت می‌شود و محدودیت مشاهده تا زمان انتشار برقرار می‌ماند.
- پیش‌نویس۱
صفحه با قالب ایجاد شده و فقط برای نویسنده قابل مشاهده است.
- در انتظار بررسی۲
وضعیت در Page Properties تغییر می‌کند و برای مالک حوزه Task ثبت می‌شود.
- نیازمند اصلاح۳
بازبین توضیح خود را به‌صورت نظر ثبت و صفحه را به نویسنده بازمی‌گرداند.
- منتشرشده۴
محدودیت مشاهده برداشته می‌شود و صفحه در گزارش‌ها و جست‌وجو قرار می‌گیرد.
- بازبینی دوره‌ای۵
در تاریخ بازبینی بعدی، مالک دانش صحت محتوا را تأیید یا آن را به‌روز می‌کند.
راست‌به‌چپ و فونت
در Data Center، جهت راست‌به‌چپ و فونت Vazirmatn با Stylesheet سراسری اعمال می‌شود. فایل فونت به صفحه‌ای در فضای KM پیوست و نشانی آن در Stylesheet درج می‌شود.
css
/* Global stylesheet: Confluence Data Center > Look and Feel > Stylesheet */
@font-face {
font-family: "Vazirmatn";
src: url("/download/attachments/<pageId>/Vazirmatn-Variable.woff2") format("woff2");
font-weight: 100 900;
font-display: swap;
}
#main-content,
.wiki-content {
direction: rtl;
text-align: right;
font-family: "Vazirmatn", Tahoma, sans-serif;
line-height: 1.9;
}
.wiki-content pre,
.wiki-content code {
direction: ltr;
text-align: left;
}فازبندی پیاده‌سازی
فاز ۱: بومی
- ایجاد فضاها و درخت صفحات
- هفت قالب صفحه با ویژگی‌های صفحه
- صفحه اصلی با Content by Label و Page Properties Report
- جست‌وجو، برچسب‌ها و Stylesheet راست‌به‌چپ
فاز ۲: افزونه‌های کم‌ریسک
- draw.io برای نمودارها
- فیلتر پویای گزارش‌ها
- گزارش بازدید برای پربازدیدترین‌ها
فاز ۳: تکمیلی
- گردش تأیید چندمرحله‌ای
- فرم چندمرحله‌ای ثبت دانش
- بازخورد ساختاریافته صفحه