77 lines
1.4 KiB
Markdown
77 lines
1.4 KiB
Markdown
# BraceIQMed
|
|
|
|
Medical scoliosis brace generation platform.
|
|
|
|
## Architecture
|
|
|
|
```
|
|
braceiqmed/
|
|
├── frontend/ # React + Vite + Three.js
|
|
├── api/ # Node.js Express API server
|
|
├── brace-generator/ # FastAPI + PyTorch brace generation
|
|
├── templates/ # Brace template STL/GLB files
|
|
├── scoliovis-api/ # ScolioVis ML model for spine detection
|
|
└── scripts/ # Deployment scripts
|
|
```
|
|
|
|
## Quick Start (Local Development)
|
|
|
|
```bash
|
|
# Build all containers
|
|
docker compose build
|
|
|
|
# Start all services
|
|
docker compose up -d
|
|
|
|
# View logs
|
|
docker compose logs -f
|
|
|
|
# Stop all services
|
|
docker compose down
|
|
```
|
|
|
|
Access at: http://localhost
|
|
|
|
## Deployment (EC2)
|
|
|
|
### First-time setup on server:
|
|
|
|
```bash
|
|
# Clone the repo
|
|
git clone https://github.com/YOUR_USERNAME/braceiqmed.git ~/braceiqmed
|
|
cd ~/braceiqmed
|
|
|
|
# Build and start
|
|
docker compose build
|
|
docker compose up -d
|
|
```
|
|
|
|
### Update deployment:
|
|
|
|
```bash
|
|
cd ~/braceiqmed
|
|
git pull
|
|
docker compose up -d --build
|
|
```
|
|
|
|
Or use the deploy script:
|
|
```bash
|
|
./scripts/deploy.sh
|
|
```
|
|
|
|
## Services
|
|
|
|
| Service | Internal Port | Description |
|
|
|---------|---------------|-------------|
|
|
| Frontend | 80 | React SPA + nginx proxy |
|
|
| API | 3002 | Express.js REST API |
|
|
| Brace Generator | 8002 | FastAPI + PyTorch |
|
|
|
|
## Environment Variables
|
|
|
|
See `.env.example` for available configuration options.
|
|
|
|
## License
|
|
|
|
Proprietary - All rights reserved.
|