İ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

Projeyi klonlayın / Clone the repository

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

Otomatik kurulum / Automatic setup

./start.sh

Manuel Kurulum / Manual Installation

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

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

Servisleri başlatın / Start services

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

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

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

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

git checkout -b feature/new-feature

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}

Fork yapın
Feature branch oluşturun (git checkout -b feature/AmazingFeature)
Değişikliklerinizi commit edin (git commit -m 'Add some AmazingFeature')
Branch'i push edin (git push origin feature/AmazingFeature)
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

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

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
app		app
isg-frontend		isg-frontend
migrations		migrations
monitoring/prometheus		monitoring/prometheus
nginx		nginx
scripts		scripts
tests		tests
.env.example		.env.example
.gitignore		.gitignore
ARCHITECTURE.md		ARCHITECTURE.md
DEPLOYMENT_GUIDE.md		DEPLOYMENT_GUIDE.md
Dockerfile		Dockerfile
GITHUB_PUSH_REPORT.md		GITHUB_PUSH_REPORT.md
README.md		README.md
TEST_DOCUMENTATION.md		TEST_DOCUMENTATION.md
TEST_RESULTS.md		TEST_RESULTS.md
VALIDATION_SUMMARY.md		VALIDATION_SUMMARY.md
alembic.ini		alembic.ini
docker-compose.monitoring.yml		docker-compose.monitoring.yml
docker-compose.prod.yml		docker-compose.prod.yml
docker-compose.staging.yml		docker-compose.staging.yml
docker-compose.yml		docker-compose.yml
pytest.ini		pytest.ini
redis.conf		redis.conf
requirements.txt		requirements.txt
run_tests.py		run_tests.py
setup.sh		setup.sh
start.sh		start.sh

arslanibrahim95/isg-ai-assistant

Folders and files

Latest commit

History

Repository files navigation