normogen/docs

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.

• 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

• AI Agent Quick Reference - Essential commands and patterns
• AI Agent Guide - Comprehensive guide for working in this repository