Skip to content

Commit a60a4e8

Browse files
demirclaude
demir
and
claude
committed
İlk versiyon: Unikys kullanım kılavuzu
- MkDocs + Material theme yapılandırması - GitHub Actions ile otomatik deploy - Ana sayfa ve giriş bölümü - 13 modül sayfası (sidebar analizi ile) - Roller ve yetkiler sayfası - SSS sayfası 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
0 parents  commit a60a4e8

22 files changed

+2326
-0
lines changed

‎.github/workflows/deploy.yml‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
name: Deploy MkDocs to GitHub Pages
2+
3+
on:
4+
push:
5+
branches:
6+
- main
7+
workflow_dispatch:
8+
9+
permissions:
10+
contents: read
11+
pages: write
12+
id-token: write
13+
14+
concurrency:
15+
group: "pages"
16+
cancel-in-progress: false
17+
18+
jobs:
19+
build:
20+
runs-on: ubuntu-latest
21+
steps:
22+
- name: Checkout
23+
uses: actions/checkout@v4
24+
25+
- name: Setup Python
26+
uses: actions/setup-python@v5
27+
with:
28+
python-version: '3.x'
29+
30+
- name: Install dependencies
31+
run: |
32+
pip install mkdocs-material
33+
34+
- name: Build site
35+
run: mkdocs build
36+
37+
- name: Upload artifact
38+
uses: actions/upload-pages-artifact@v3
39+
with:
40+
path: ./site
41+
42+
deploy:
43+
environment:
44+
name: github-pages
45+
url: ${{ steps.deployment.outputs.page_url }}
46+
runs-on: ubuntu-latest
47+
needs: build
48+
steps:
49+
- name: Deploy to GitHub Pages
50+
id: deployment
51+
uses: actions/deploy-pages@v4

‎README.md‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# Unikys Kullanım Kılavuzu
2+
3+
Bu repository, Unikys Kalite Yönetim Sistemi'nin kullanım kılavuzunu içermektedir.
4+
5+
## Canlı Site
6+
7+
[https://omu.github.io/unikys-docs/](https://omu.github.io/unikys-docs/)
8+
9+
## Geliştirme
10+
11+
### Gereksinimler
12+
13+
- Python 3.x
14+
- pip
15+
16+
### Kurulum
17+
18+
```bash
19+
# Bağımlılıkları yükle
20+
pip install mkdocs-material
21+
22+
# Yerel sunucuyu başlat
23+
mkdocs serve
24+
```
25+
26+
Tarayıcıda `http://127.0.0.1:8000` adresini açın.
27+
28+
### Yapı
29+
30+
```
31+
unikys-docs/
32+
├── mkdocs.yml # MkDocs konfigürasyonu
33+
├── docs/
34+
│ ├── index.md # Ana sayfa
35+
│ ├── giris/ # Giriş bölümü
36+
│ ├── moduller/ # Modül sayfaları
37+
│ ├── roller.md # Roller ve yetkiler
38+
│ └── sss.md # Sık sorulan sorular
39+
└── .github/
40+
└── workflows/
41+
└── deploy.yml # Otomatik deploy
42+
```
43+
44+
### Deploy
45+
46+
`main` branch'e push yapıldığında GitHub Actions otomatik olarak siteyi build edip GitHub Pages'e deploy eder.
47+
48+
## Katkıda Bulunma
49+
50+
1. Değişikliklerinizi yapın
51+
2. `mkdocs serve` ile yerel olarak test edin
52+
3. Pull request oluşturun
53+
54+
## Lisans
55+
56+
Bu dokümantasyon Ondokuz Mayıs Üniversitesi tarafından hazırlanmıştır.

‎docs/giris/arayuz.md‎

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
# Arayüz Tanıtımı
2+
3+
Bu sayfa, Unikys sisteminin temel arayüz öğelerini tanıtmaktadır.
4+
5+
## Ana Bileşenler
6+
7+
Sistem arayüzü üç ana bölümden oluşur:
8+
9+
1. **Sol Menü (Sidebar)** - Modüllere erişim
10+
2. **Üst Çubuk (Topnav)** - Kullanıcı işlemleri ve ayarlar
11+
3. **İçerik Alanı** - Ana çalışma alanı
12+
13+
## Sol Menü (Sidebar)
14+
15+
Sol menü, sistemdeki tüm modüllere erişim sağlar. Menü öğeleri kullanıcı rolüne göre değişir.
16+
17+
### Menü Yapısı
18+
19+
- **Ana Sayfa**: Sistem ana sayfası
20+
- **Veri ve Göstergeler**: Kurumsal veri yönetimi
21+
- **Süreç Yönetimi**: Süreç tanımlama ve takibi
22+
- **Risk Yönetimi**: Risk ve fırsat yönetimi
23+
- **Geri Bildirimler**: Paydaş geri bildirimleri
24+
- **İç Değerlendirme**: Kurum içi değerlendirmeler
25+
- **İç Denetim**: Denetim süreçleri
26+
- **İyileştirme Yönetimi**: DİF ve düzeltici eylemler
27+
- **Eylem Planı**: Yıllık eylem planları
28+
- **İç Kontrol**: İç kontrol standartları
29+
- **Belge Yönetimi**: Doküman kategorileri
30+
- **Duyurular**: Sistem duyuruları
31+
- **Raporlar**: Raporlama modülü
32+
- **Ayarlar**: Sistem ayarları
33+
34+
!!! info "Rol Bazlı Menü"
35+
Gördüğünüz menü öğeleri, sahip olduğunuz role göre değişir. Bazı menüler sadece belirli roller için görünür.
36+
37+
## Üst Çubuk (Topnav)
38+
39+
Üst çubuk aşağıdaki öğeleri içerir:
40+
41+
### Menü Açma/Kapama
42+
Sol taraftaki hamburger ikonu (≡) ile sol menüyü açıp kapatabilirsiniz.
43+
44+
### Kullanıcı Menüsü
45+
Sağ üst köşede e-posta adresiniz görünür. Tıkladığınızda:
46+
47+
- **Profil**: Profil bilgilerinizi görüntüleyin
48+
- **Şifre Değiştir**: Şifrenizi değiştirin
49+
- **Çıkış**: Sistemden çıkış yapın
50+
51+
### Bildirimler
52+
Zil ikonu ile sistem bildirimlerinizi görebilirsiniz. Yeni bildiriminiz varsa ikon üzerinde sayı görünür.
53+
54+
### Yıl Seçici
55+
Aktif yılı görüntüler ve değiştirmenize olanak tanır. Yıl değiştirdiğinizde tüm veriler seçilen yıla göre filtrelenir.
56+
57+
!!! warning "Yıl Seçimi"
58+
Doğru yılın seçili olduğundan emin olun. Yanlış yıl seçimi, hatalı veri girişine neden olabilir.
59+
60+
## İçerik Alanı
61+
62+
Ana çalışma alanı, seçilen modüle göre değişir. Genellikle şu öğeleri içerir:
63+
64+
### Sayfa Başlığı
65+
Sayfanın adı ve breadcrumb navigasyonu
66+
67+
### Araç Çubuğu
68+
- **Yeni Ekle** butonu
69+
- **Dışa Aktar** seçenekleri (Excel, PDF)
70+
- **Filtreler** ve arama
71+
72+
### Veri Tablosu
73+
Kayıtların listelendiği tablo. Tabloda:
74+
75+
- Sıralama yapabilirsiniz
76+
- Sayfalama ile gezinebilirsiniz
77+
- Satıra tıklayarak detay sayfasına gidebilirsiniz
78+
79+
### Detay Panelleri
80+
Kayıt detay sayfalarında ilişkili veriler paneller halinde gösterilir.
81+
82+
## Kısayollar
83+
84+
| Kısayol | Açıklama |
85+
|---------|----------|
86+
| Sol menü tıklama | İlgili modüle gitme |
87+
| Tablo satırı tıklama | Detay sayfasına gitme |
88+
| Geri butonu | Önceki sayfaya dönme |
89+
90+
## Responsive Tasarım
91+
92+
Sistem, farklı ekran boyutlarına uyum sağlar:
93+
94+
- **Masaüstü**: Tam özellikli görünüm
95+
- **Tablet**: Daraltılmış menü
96+
- **Mobil**: Hamburger menü ile erişim
97+
98+
!!! tip "Tavsiye"
99+
En iyi deneyim için masaüstü veya tablet kullanmanız önerilir.

‎docs/giris/hakkinda.md‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# Unikys Hakkında
2+
3+
Unikys, üniversiteler için geliştirilmiş kapsamlı bir **Kalite Yönetim Sistemi**dir. Yükseköğretim kurumlarının kalite güvence süreçlerini dijital ortamda yönetmelerini sağlar.
4+
5+
## Temel Özellikler
6+
7+
### Süreç Yönetimi
8+
- Ana süreç ve alt süreçlerin tanımlanması
9+
- Süreç faaliyetlerinin takibi
10+
- Görev tanımları ve sorumluluklar
11+
12+
### Risk ve Fırsat Yönetimi
13+
- Risk tanımlama ve değerlendirme
14+
- Fırsat yönetimi
15+
- Risk aktivitelerinin takibi
16+
17+
### Performans İzleme
18+
- Kurumsal göstergeler
19+
- Veri girişi ve onay süreçleri
20+
- Hedef takibi
21+
22+
### İç Denetim ve Değerlendirme
23+
- İç denetim planlaması
24+
- Denetçi atamaları
25+
- Bulgu ve eylem takibi
26+
27+
### İyileştirme Yönetimi
28+
- Doküman İyileştirme Formu (DİF)
29+
- Düzeltici eylemler
30+
- Uygunsuzluk yönetimi
31+
32+
### Belge Yönetimi
33+
- Doküman kategorileri
34+
- Belge talep ve onay süreçleri
35+
- Versiyon kontrolü
36+
37+
## Kullanıcı Tipleri
38+
39+
Sistemde farklı yetki seviyelerine sahip kullanıcı rolleri bulunmaktadır:
40+
41+
| Rol Kategorisi | Açıklama |
42+
|----------------|----------|
43+
| **Yönetim Rolleri** | Admin, Üniversite Yönetimi |
44+
| **Süreç Rolleri** | Süreç Sorumlusu, Süreç Temsilcisi, Süreç Koordinatörü |
45+
| **Denetim Rolleri** | İç Denetçi, Komisyon Üyesi |
46+
| **Veri Rolleri** | Kalite Temsilcisi, Etiket Sorumlusu |
47+
48+
Detaylı bilgi için [Roller ve Yetkiler](../roller.md) sayfasına bakınız.
49+
50+
## Teknik Altyapı
51+
52+
- **Web Tabanlı**: Modern tarayıcılardan erişilebilir
53+
- **Çok Kiracılı**: Farklı üniversiteler için özelleştirilebilir
54+
- **Güvenli**: Rol tabanlı erişim kontrolü
55+
- **Raporlama**: Excel ve PDF formatında dışa aktarım

‎docs/giris/sisteme-giris.md‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# Sisteme Giriş
2+
3+
Bu sayfa, Unikys sistemine nasıl giriş yapılacağını açıklamaktadır.
4+
5+
## Giriş Sayfası
6+
7+
Sisteme erişmek için kurumunuzun Unikys adresine gidin. Giriş sayfasında aşağıdaki bilgileri girmeniz gerekmektedir:
8+
9+
- **E-posta**: Kurumsal e-posta adresiniz
10+
- **Şifre**: Sistem şifreniz
11+
12+
## İlk Giriş
13+
14+
Sisteme ilk kez giriş yapıyorsanız:
15+
16+
1. Yöneticinizden hesap bilgilerinizi alın
17+
2. Giriş sayfasına gidin
18+
3. E-posta ve şifrenizi girin
19+
4. **Giriş Yap** butonuna tıklayın
20+
21+
!!! warning "Şifre Güvenliği"
22+
İlk girişten sonra şifrenizi değiştirmeniz önerilir. Şifre değişikliği için sağ üst köşedeki profil menüsünü kullanabilirsiniz.
23+
24+
## Şifre Değiştirme
25+
26+
Şifrenizi değiştirmek için:
27+
28+
1. Sağ üst köşedeki kullanıcı adınıza tıklayın
29+
2. Açılan menüden **Şifre Değiştir** seçeneğini seçin
30+
3. Mevcut şifrenizi ve yeni şifrenizi girin
31+
4. **Kaydet** butonuna tıklayın
32+
33+
## Çıkış Yapma
34+
35+
Sistemden güvenli çıkış yapmak için:
36+
37+
1. Sağ üst köşedeki kullanıcı adınıza tıklayın
38+
2. Açılan menüden **Çıkış** seçeneğini seçin
39+
40+
!!! tip "Güvenlik İpucu"
41+
Paylaşımlı bilgisayarlarda çalışıyorsanız, işiniz bittiğinde mutlaka çıkış yapın.
42+
43+
## Sorun Giderme
44+
45+
### Şifremi Unuttum
46+
47+
Şifrenizi unuttuysanız sistem yöneticinize başvurun.
48+
49+
### Hesabım Kilitlendi
50+
51+
Çok sayıda başarısız giriş denemesi hesabınızın kilitlenmesine neden olabilir. Bu durumda sistem yöneticinize başvurun.
52+
53+
### Sisteme Erişemiyorum
54+
55+
- İnternet bağlantınızı kontrol edin
56+
- Tarayıcınızı güncelleyin
57+
- Önbelleği temizleyin
58+
- Sorun devam ederse sistem yöneticinize başvurun

‎docs/index.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Unikys Kullanım Kılavuzu
2+
3+
Unikys Kalite Yönetim Sistemi'ne hoş geldiniz. Bu kılavuz, sistemin tüm modüllerini ve özelliklerini detaylı olarak açıklamaktadır.
4+
5+
## Hızlı Başlangıç
6+
7+
1. **[Sisteme Giriş](giris/sisteme-giris.md)** - Sisteme nasıl giriş yapılır
8+
2. **[Arayüz Tanıtımı](giris/arayuz.md)** - Menüler ve temel navigasyon
9+
3. **[Roller ve Yetkiler](roller.md)** - Kullanıcı rolleri ve erişim hakları
10+
11+
## Modüller
12+
13+
| Modül | Açıklama |
14+
|-------|----------|
15+
| [Veri ve Göstergeler](moduller/veri-gostergeler.md) | Kurumsal veri ve gösterge yönetimi |
16+
| [Süreç Yönetimi](moduller/surec-yonetimi.md) | Ana süreçler ve alt süreçlerin yönetimi |
17+
| [Risk Yönetimi](moduller/risk-yonetimi.md) | Risk tanımlama, değerlendirme ve takibi |
18+
| [Geri Bildirimler](moduller/geri-bildirimler.md) | Paydaş geri bildirimleri |
19+
| [İç Değerlendirme](moduller/ic-degerlendirme.md) | Kurum içi değerlendirme süreçleri |
20+
| [İç Denetim](moduller/ic-denetim.md) | İç denetim planlaması ve yürütmesi |
21+
| [İyileştirme Yönetimi](moduller/iyilestirme.md) | DİF, düzeltici eylemler ve iyileştirmeler |
22+
| [Eylem Planı](moduller/eylem-plani.md) | Yıllık eylem planları |
23+
| [İç Kontrol](moduller/ic-kontrol.md) | İç kontrol standartları ve faaliyetleri |
24+
| [Belge Yönetimi](moduller/belge-yonetimi.md) | Doküman kategorileri ve talepleri |
25+
| [Duyurular](moduller/duyurular.md) | Sistem duyuruları |
26+
| [Raporlar](moduller/raporlar.md) | Çeşitli raporlama özellikleri |
27+
| [Ayarlar](moduller/ayarlar.md) | Sistem ayarları ve yönetimi |
28+
29+
## Yardım
30+
31+
Sorularınız için [Sık Sorulan Sorular](sss.md) sayfasını inceleyebilirsiniz.
32+
33+
---
34+
35+
!!! info "Kılavuz Hakkında"
36+
Bu kılavuz yönetici (admin) perspektifinden hazırlanmıştır. Diğer kullanıcı rolleri için gerekli bilgiler, yöneticiler tarafından aktarılmalıdır.

0 commit comments

Comments
 (0)