İSG AI Assistant

İş Sağlığı ve Güvenliği Yapay Zeka Asistanı
Occupational Health and Safety AI Assistant

📋 İçindekiler / Table of Contents

• Proje Hakkında / About
• Özellikler / Features
• Teknoloji Yığını / Technology Stack
• Kurulum / Installation
• Kullanım / Usage
• API Dokümantasyonu / API Documentation
• KVKK Uyumluluğu / GDPR Compliance
• Geliştirme / Development
• Katkıda Bulunma / Contributing
• Lisans / License

🎯 Proje Hakkında / About {#about}

İSG AI Assistant, işyerlerinde iş sağlığı ve güvenliği değerlendirmelerini yapay zeka teknolojisi ile destekleyen modern bir web uygulamasıdır. Türkiye'deki KVKK mevzuatına tam uyumlu olarak geliştirilmiştir.

İSG AI Assistant is a modern web application that supports occupational health and safety assessments in workplaces using artificial intelligence technology. It has been developed in full compliance with Turkey's GDPR legislation.

Temel Amaçlar / Main Objectives

• 🏥 Sağlık değerlendirmelerini dijitalleştirmek
• 🤖 AI destekli risk analizleri yapmak
• 🔒 KVKK uyumlu veri işleme sağlamak
• 📱 Mobil uyumlu PWA deneyimi sunmak
• 🎤 Türkçe sesli girdi desteği vermek

✨ Özellikler / Features {#features}

🏥 Sağlık Değerlendirme / Health Assessment

• Akıllı Formlar: Dinamik sağlık değerlendirme formları
• AI Analizi: 500+ kural içeren yapay zeka destekli risk analizi
• Sesli Girdi: Türkçe tıbbi terminoloji destekli ses tanıma
• Otomatik Raporlama: PDF ve Excel formatında raporlar

🔒 KVKK Uyumluluğu / GDPR Compliance

• Veri Şifreleme: AES-256 ile hassas veri koruması
• Rıza Yönetimi: Detaylı rıza takip ve yönetim sistemi
• Denetim Kayıtları: Tüm veri işlemlerinin kayıt altına alınması
• Veri Minimizasyonu: Gerekli minimum veri toplama prensibi

🌐 Entegrasyonlar / Integrations

• SMS Servisleri: Türk SMS sağlayıcıları ile entegrasyon
• Ödeme Sistemleri: iyzico, PayTR gibi Türk ödeme gateway'leri
• Laboratuvar Sistemleri: HL7 FHIR uyumlu lab entegrasyonları
• Sağlık Cihazları: Fitness tracker ve tıbbi cihaz entegrasyonları

📱 Kullanıcı Deneyimi / User Experience

• PWA Desteği: Offline çalışma ve uygulama kurulumu
• Responsive Tasarım: Mobil, tablet ve masaüstü uyumluluğu
• Türkçe Arayüz: Tam Türkçe dil desteği
• Erişilebilirlik: WCAG 2.1 uyumlu erişilebilir tasarım

🛠️ Teknoloji Yığını / Technology Stack {#technology-stack}

Backend

• FastAPI - Modern Python web framework
• PostgreSQL - İlişkisel veritabanı
• Redis - Önbellek ve oturum yönetimi
• Celery - Arka plan görev işleme
• SQLAlchemy - ORM ve veritabanı yönetimi

Frontend

• React 18 - Modern JavaScript UI kütüphanesi
• Material-UI - React UI bileşen kütüphanesi
• PWA - Progressive Web App özellikleri
• TypeScript - Tip güvenli JavaScript

DevOps & Deployment

• Docker - Container teknolojisi
• Docker Compose - Multi-container orchestration
• Nginx - Reverse proxy ve static file serving
• GitHub Actions - CI/CD pipeline

AI & Machine Learning

• scikit-learn - Makine öğrenmesi algoritmaları
• TensorFlow/PyTorch - Derin öğrenme modelleri
• DeepSpeech - Ses tanıma teknolojisi
• spaCy - Doğal dil işleme

🚀 Kurulum / Installation {#installation}

Ön Gereksinimler / Prerequisites

• Docker 20.10+
• Docker Compose 2.0+
• Node.js 16+ (geliştirme için)
• Git

Hızlı Başlangıç / Quick Start

1. Projeyi klonlayın / Clone the repository

git clone https://github.com/your-username/isg-ai-assistant.git
cd isg-ai-assistant

2. Otomatik kurulum / Automatic setup

./start.sh

Manuel Kurulum / Manual Installation

1. Environment dosyasını oluşturun / Create environment file

cp .env.example .env
# .env dosyasını düzenleyin / Edit .env file

2. Servisleri başlatın / Start services

# Geliştirme ortamı / Development
docker-compose up -d

# Production ortamı / Production
docker-compose --profile production up -d

3. Frontend'i kurun (geliştirme) / Install frontend (development)

cd isg-frontend
npm install
npm start

💻 Kullanım / Usage {#usage}

Geliştirme Ortamı / Development Environment

# Tüm servisleri başlat / Start all services
./start.sh start development

# Frontend'i geliştirme modunda çalıştır / Run frontend in dev mode
./start.sh start frontend-dev

# Logları görüntüle / View logs
./start.sh logs

# Servisleri durdur / Stop services
./start.sh stop

Production Deployment

# Production modunda başlat / Start in production mode
./start.sh start production

# Monitoring ile birlikte / With monitoring
./start.sh start full

Erişim URL'leri / Access URLs

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000
• API Docs: http://localhost:8000/docs
• pgAdmin: http://localhost:5050

📚 API Dokümantasyonu / API Documentation {#api-documentation}

Ana Endpoint'ler / Main Endpoints

Kimlik Doğrulama / Authentication

POST /api/v1/auth/register    # Kullanıcı kaydı / User registration
POST /api/v1/auth/token       # Giriş / Login
GET  /api/v1/auth/me          # Profil / Profile

Sağlık Formları / Health Forms

GET    /api/v1/forms          # Form listesi / List forms
POST   /api/v1/forms          # Yeni form / Create form
GET    /api/v1/forms/{id}     # Form detayı / Form details
PUT    /api/v1/forms/{id}     # Form güncelleme / Update form
DELETE /api/v1/forms/{id}     # Form silme / Delete form

AI Değerlendirme / AI Evaluation

POST /api/v1/forms/ai-evaluate    # AI ile değerlendirme / AI evaluation

Ses İşleme / Speech Processing

POST /api/v1/speech/transcribe    # Ses çevirme / Speech transcription

KVKK / GDPR

GET  /api/v1/kvkk/data-inventory      # Veri envanteri / Data inventory
POST /api/v1/kvkk/consent-update      # Rıza güncelleme / Consent update
POST /api/v1/kvkk/data-deletion-request # Veri silme talebi / Data deletion request

Entegrasyonlar / Integrations

POST /api/v1/integrations/sms/send           # SMS gönderme / Send SMS
POST /api/v1/integrations/payment/create     # Ödeme oluşturma / Create payment
POST /api/v1/integrations/lab/request        # Lab talebi / Lab request
GET  /api/v1/integrations/lab/results/{id}   # Lab sonuçları / Lab results

Detaylı API dokümantasyonu için: http://localhost:8000/docs

🔒 KVKK Uyumluluğu / GDPR Compliance {#kvkk-compliance}

Veri Koruma Önlemleri / Data Protection Measures

• 🔐 Şifreleme: Hassas veriler AES-256 ile şifrelenir
• 📝 Denetim Kayıtları: Tüm veri işlemleri loglanır
• ⏱️ Veri Saklama: Otomatik veri silme politikaları
• ✅ Rıza Yönetimi: Granüler rıza kontrolü
• 🔍 Veri Envanteri: Kullanıcı veri görünürlüğü

Kullanıcı Hakları / User Rights

• Bilgi Talep Etme: Veri envanteri görüntüleme
• Düzeltme: Yanlış verileri düzeltme
• Silme: Veri silme talebinde bulunma
• Taşınabilirlik: Verileri dışa aktarma
• İtiraz: Veri işlemeye itiraz etme

Yasal Uyumluluk / Legal Compliance

• KVKK Kanunu: 6698 sayılı kanuna uygunluk
• Sağlık Mevzuatı: Türk sağlık mevzuatına uyum
• İSG Yönetmeliği: İş sağlığı güvenliği mevzuatı

🛠️ Geliştirme / Development {#development}

Geliştirme Ortamı Kurulumu / Development Setup

1. Repository'yi fork edin
2. Geliştirme dalını oluşturun

git checkout -b feature/new-feature

3. Pre-commit hooks kurun

pip install pre-commit
pre-commit install

Test Çalıştırma / Running Tests

# Backend testleri / Backend tests
python run_tests.py

# Frontend testleri / Frontend tests
cd isg-frontend
npm test

# Entegrasyon testleri / Integration tests
python run_tests.py integration

Code Style

• Backend: Black, isort, flake8
• Frontend: Prettier, ESLint
• Commit Messages: Conventional Commits

Performans / Performance

• Backend: FastAPI async/await patterns
• Frontend: React.lazy, code splitting
• Database: Optimized queries, indexing
• Cache: Redis caching strategy

🤝 Katkıda Bulunma / Contributing {#contributing}

1. Fork yapın
2. Feature branch oluşturun (git checkout -b feature/AmazingFeature)
3. Değişikliklerinizi commit edin (git commit -m 'Add some AmazingFeature')
4. Branch'i push edin (git push origin feature/AmazingFeature)
5. Pull Request oluşturun

Geliştirme Kuralları / Development Guidelines

• Code Coverage: Minimum %80 test coverage
• Documentation: Tüm public API'lar dokümante edilmeli
• Security: Security review gerekli
• Performance: Performance impact assessment

📄 Lisans / License {#license}

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.

📞 İletişim / Contact

• Email: support@isgai.com
• Website: https://isgai.com
• GitHub: https://github.com/your-username/isg-ai-assistant
• Documentation: https://docs.isgai.com

🙏 Teşekkürler / Acknowledgments

• Sağlık Bakanlığı: Türk sağlık mevzuatı rehberliği
• KVKK: Veri koruma mevzuatı
• Açık Kaynak Topluluğu: Kullanılan teknolojiler

Geliştirme Ekibi / Development Team
İSG AI Assistant Team © 2024

Bu proje Türkiye'deki iş sağlığı ve güvenliği standartlarını dijital dönüşümle desteklemek amacıyla geliştirilmiştir.