Records the decision: client-side AES-256-GCM, double-PBKDF2 auth/enc-key split, server-as-blind-store, in-memory key lifecycle, and Phase 1 limitations (forgotten password = data loss; Phase 2 recovery wrapping deferred). |
||
|---|---|---|
| .. | ||
| adr | ||
| archive | ||
| deployment | ||
| development | ||
| implementation | ||
| product | ||
| testing | ||
| AI_AGENT_GUIDE.md | ||
| AI_QUICK_REFERENCE.md | ||
| README.md | ||
Normogen Documentation Index
Welcome to the Normogen project documentation. This directory contains all project documentation organized by category.
📁 Documentation Structure
Product
Core product documentation and project overview.
- README.md - Project overview and quick start guide
- STATUS.md - Current project status
- ROADMAP.md - Development roadmap and milestones
- PROGRESS.md - Progress dashboard
- introduction.md - Project introduction and background
- encryption.md - Encryption and security architecture
Implementation
Phase-by-phase implementation completion records (2.3 through 2.8, plus frontend). See implementation/README.md for the full list.
ADR
Architecture Decision Records — the "why" behind the major technical choices (stack, schema, JWT, frontend, deployment).
Development
Development workflow and CI/CD.
Testing
Test scripts and testing notes.
- test-api-endpoints.sh - API endpoint testing
- test-medication-api.sh - Medication API tests
- solaria-test.sh / check-solaria-logs.sh - Solaria deployment testing
- quick-test.sh - Quick smoke test
Deployment
Deployment guides and scripts.
- DEPLOYMENT_GUIDE.md - Complete deployment guide
- deploy-to-solaria.sh / deploy-and-test-solaria.sh - Solaria deployment scripts
Archive
Superseded and historical documentation kept for reference (phase plans, old CI state, point-in-time test snapshots). Not current.
📊 Project Status
- Backend: Phase 2.x feature-complete (through drug interactions); security-hardened; deployed on Solaria.
- Frontend: Early stage (Login/Register + API/store layer; router not wired).
- Tests: 18 unit + 13 integration, CI-gated with MongoDB.
- See product/STATUS.md for the full breakdown.
- Last Updated: 2026-06-27
🤖 For AI Agents
- AI Agent Quick Reference - Essential commands and patterns
- AI Agent Guide - Comprehensive guide for working in this repository