nura-project

🫀 Nura - Panic Attack Detection System

🚨 Early panic attack detection through AI-powered biometric monitoring on smartwatches

📋 Table of Contents

• 🎯 Project Overview
• 🏗️ Repository Structure
• 🛠️ Tech Stack
• 📋 Repository Rules
• 👥 Team

🎯 Project Overview

Nura is an intelligent smartwatch app that uses machine learning to detect early signs of panic attacks, providing:

• 📊 Real-time biometric monitoring
• 🤖 LSTM-based panic prediction
• 🆘 Automated emergency response
• 📱 Multi-platform support (Mobile, Watch, Web)

🏗️ Repository Structure

nura-project/
├── 📦 packages/
│   ├── 🧠 core/              # Domain logic & business rules
│   ├── 📱 mobile-app/        # React Native app
│   ├── ⌚ watch-app/         # WearOS application
│   ├── 🌐 web-dashboard/     # Astro web interface
│   ├── 🔧 backend-api/       # ElysiaJS API server
│   └── 🤖 ml-service/        # LSTM model service
├── 🤝 shared/               # Shared utilities & types
├── 🛠️ tools/                # Development utilities
└── 📄 docs/                 # Documentation

🛠️ Tech Stack

Component	Technology
📱 Mobile	React Native + TypeScript
⌚ Watch	WearOS
🌐 Web	Astro + TailwindCSS
🔧 Backend	ElysiaJS + Bun
🤖 ML	LSTM (TensorFlow)
📦 Monorepo	Turbo + pnpm

📋 Repository Rules

🔀 Branching Strategy

• main - 🔒 Protected, production-ready code
• develop - 🧪 Integration branch for features
• feature/[name]-[description] - 🆕 New features (feature/sebastian-panic-detection)
• bugfix/[name]-[description] - 🐛 Bug fixes (bugfix/gabriel-sensor-connection)
• hotfix/[name]-[description] - 🚨 Critical production fixes (hotfix/daniel-critical-alert-fix)

📝 Commit Convention

Follow Conventional Commits:

feat(core): add panic detection algorithm
fix(mobile): resolve bluetooth connection issue
docs(readme): update installation guide
test(ml): add LSTM model unit tests

Types:

• feat ✨ - New features
• fix 🐛 - Bug fixes
• docs 📚 - Documentation
• test 🧪 - Tests
• refactor ♻️ - Code refactoring
• perf ⚡ - Performance improvements

📁 File Organization

// ✅ Good
src/adapters/inbound/BiometricController.ts
src/domain/entities/User.ts
src/use-cases/DetectPanic.ts

// ❌ Bad
src/controllers/biometric.ts
src/user.ts
src/panic.ts

🚫 Do NOT

• ❌ Commit directly to main or develop
• ❌ Push node_modules or build artifacts
• ❌ Include sensitive data (API keys, credentials)
• ❌ Mix multiple concerns in single commit
• ❌ Skip tests for critical functionality

✅ Do

• ✅ Write descriptive commit messages
• ✅ Keep PRs focused and small
• ✅ Update documentation with changes
• ✅ Follow TypeScript strict mode
• ✅ Use dependency injection for adapters

👥 Team

Name	Role	Responsibilities
👨‍💼 Daniel Dueñas	Product Owner	Requirements, validation
🏗️ Sebastián Torrealba	Tech Lead	Architecture, core domain
🎨 Gabriel Apablaza	UI/UX Developer	Frontend, design
🤖 Joaquín Torres	MLOps Engineer	ML models, algorithms
🧪 Myckoll Winchester	QA Engineer	Testing, watch app
📋 Joaquín Véliz	Scrum Master	Process, backend API

📞 Support

• 🐛 Bug Reports: Create an issue with bug label
• 💡 Feature Requests: Create an issue with enhancement label
• 💬 Questions: Use GitHub Discussions
• 🆘 Emergency: Contact Tech Lead directly

📄 License

This project is proprietary software developed for Universidad Técnica Federico Santa María.

---

🫀 Built with ❤️ by the Nura Team