# Normogen

**Normogen** (Mapudungun for "Balanced Life") is an open-source health data platform for private, secure health data management.

## 📚 Documentation

All project documentation has been organized into the `docs/` directory:

- **[Documentation Index](./docs/README.md)** - Start here for complete documentation
- **[Product Overview](./docs/product/README.md)** - Project introduction and features
- **[Quick Start](./docs/product/README.md#quick-start)** - Get started quickly
- **[API Documentation](./docs/product/README.md#backend-api-endpoints)** - Backend API reference

## 🚀 Quick Start

```bash
# Clone repository
git clone <forgejo-url> normogen
cd normogen/backend

# Setup configuration
cp .env.example .env
# Edit .env with your values

# Run with Docker Compose
docker compose up -d

# Check status (default port is 6500 via NORMOGEN_PORT; Solaria maps it to host 6800)
curl http://localhost:6500/health
```

## 📊 Current Status

- **Backend**: ✅ Phase 2.x feature-complete (Rust + Axum + MongoDB), including drug interactions (Phase 2.8). Security-hardened: token-version validation, hashed refresh-token persistence, fail-fast config, real-IP audit logging. Deployed on Solaria.
- **Frontend**: 🚧 Early (React + TypeScript) — Login/Register pages + API/store layer exist; router not yet wired.
- **Tests**: 18 unit + 13 integration (auth + medication), CI-gated with MongoDB.
- **Deployment**: Docker on Solaria (image built manually — CI can't run DinD on Forgejo).
- See [docs/product/STATUS.md](./docs/product/STATUS.md) for the full breakdown.

## 🗂️ Documentation Structure

```
docs/
├── product/          # Product definition, features, roadmap
├── implementation/   # Phase plans, specs, progress reports
├── testing/          # Test scripts and results
├── deployment/       # Deployment guides and scripts
├── development/      # Git workflow, CI/CD, development tools
└── archive/          # Historical documentation
```

## 📖 Full Documentation

See the [Documentation Index](./docs/README.md) for complete project documentation.

---

*Last Updated: 2026-06-27*