e322145ffb
Rewrite the encryption/persona/JWT docs to match the implemented code and record the multi-person sharing design. - multi-person-sharing.md (NEW): ADR for per-profile DEK + X25519 envelope sharing. All five original open questions resolved 2026-07-18. Covers divorced-parents, pets, graduation, and elderly-parent care; adds an admin permission tier for owner-incapacity. Decided, not yet implemented. (#3) - encryption.md: full rewrite to the implemented wrapped-DEK / Web Crypto model; the old version described ZK encryption as 'planned'. (#4) - jwt-authentication-decision.md: rewritten to match implementation (PBKDF2 not bcrypt, no Redis, token_version revocation, real Claims). Original aspirational content preserved in a History section. (#4) - PERSONA_AND_FAMILY_MANAGEMENT.md: 'Current reality' section added, old 'Implementation Status' marked superseded, encryption section corrected. (#4) - ENCRYPTION_UPDATE_SUMMARY.md: archived (changelog for a rewrite that itself went stale). (#4) - ADR README index updated for the new + reconciled entries. |
||
|---|---|---|
| .. | ||
| 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