Yerel Geliştirme

Backend

cd backend
npm install
cp .env.example .env      # gerçek değerleri kendiniz doldurun
npm run dev               # tsx ile izleme modunda

Betik	Görev
npm run dev	Geliştirme sunucusu
npm run build	TypeScript derlemesi
npm start	Derlenmiş çıktıyı çalıştırır
npm run typecheck	Tip denetimi
npm run logs:test / logs:test:db / logs:migrate	Günlük araçları
npm run nodered:test	Node-RED taşıma kontrolleri
npm run swagger:test	OpenAPI kontrolleri

MongoDB erişilemezse sunucu hiç başlamaz — bu bilinçli bir davranıştır.

Frontend

cd dashboard
npm install
cp .env.example .env
npm run dev

Betik	Görev
npm run dev	Vite geliştirme sunucusu
npm run build / preview	Üretim derlemesi ve önizleme
npm run lint / lint:fix	ESLint
npm run prettier / prettier:fix	Biçimlendirme
npm run typecheck / typecheck:test	Tip denetimi
npm run test:iqv / :watch / :coverage / :ci	Jest + MSW
npm run ci:verify	Birleşik doğrulama

LAN üzerinden test

Vite host: '0.0.0.0' ile çalışır. Başka bir cihazdan http://192.168.x.x:5173 ile açtığınızda giriş çalışır: geliştirmede özel ağ origin'leri CORS tarafından kabul edilir. Ayrıntı: Güvenlik / CORS.

Dokümantasyon sitesi

python -m pip install -r requirements-docs.txt
python -m mkdocs serve
python -m mkdocs build --strict