normogen/docs
goose d7d09482da docs: ADR for zero-knowledge encryption Phase 1
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).
2026-06-28 21:51:47 -03:00
..
adr docs: ADR for zero-knowledge encryption Phase 1 2026-06-28 21:51:47 -03:00
archive docs: reconcile documentation with reality (P3) 2026-06-27 16:02:16 -03:00
deployment fix(backend): P2 config & Docker consistency 2026-06-27 19:54:32 -03:00
development docs: reconcile documentation with reality (P3) 2026-06-27 16:02:16 -03:00
implementation fix(backend): P2 config & Docker consistency 2026-06-27 19:54:32 -03:00
product fix(backend): P2 config & Docker consistency 2026-06-27 19:54:32 -03:00
testing fix(backend): P2 config & Docker consistency 2026-06-27 19:54:32 -03:00
AI_AGENT_GUIDE.md fix(backend): P2 config & Docker consistency 2026-06-27 19:54:32 -03:00
AI_QUICK_REFERENCE.md docs(ai): reorganize documentation and update product docs 2026-03-09 11:04:44 -03:00
README.md docs: reconcile documentation with reality (P3) 2026-06-27 16:02:16 -03:00

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.

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.

  • CI-CD.md - The Forgejo CI/CD pipeline (current)
  • README.md - Workflow and conventions

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