- Project Objectives
- Context
- AI Usage Caps by Feature
- Enhancement List
- Project Scope
- Project Content
- Feature Block 1: Analytics
- Feature Block 2: Wellness Study & Triage (remaining)
- Feature Block 3: Home Page
- Feature Block 4: Personalisation Hub
- Feature Block 5: Wellness Plan
- Feature Block 6: Body Wellness Platform
- Feature Block 7: Sleep Wellness Platform
- Feature Block 8: Mind Wellness Platform
- Feature Block 9: Wellness Tracker & Monitor
- Feature Block 10: Wellness Channel
- Feature Block 11: Wellness Community
- Feature Block 12: User Management
- Appendix — Project Progress
Project Objectives
The objective is to sequentially release into production each product feature. The product feature list is canonical and will grow as new versions are built for release.
Release-It means:- Test-It: against its real, live production code.
- Fix-It: anything genuinely wrong, found in the course of testing.
- Document-It: accurately document the functionality based on fixed code.
- Upload-It: to the Katie AI Knowledge base – so she can train and support users.
Note: CSS consolidation into stylesheets is a seperate plan. CSS changes that are part of improvements and fixes precede CSS consolidation plans for each version
Context: The core tools this document requires for every feature release are:
Knowledge Manager — the actual admin tool, live at /admin-knowledge-manager/. Every corrected document gets submitted there, reviewed by a second person, and approved before Katie can use it. Built once, in the RAG project; this project just uses it, feature by feature.
Knowledge Management Guide (katie-rag-guide.php) containing:
- the build and functional specification of the knowledge manager
- its use and its functional operation
- Content Manager’s Hints: the writing standard every knowledge document should follow
GOD JSON / assessmentscript — the user’s personal and wellness profile: a JSON column called assessmentscript, inside a database table called assessment.
AI Usage Caps by Feature
Every AI-powered feature has a real, ongoing cost per use. Without a defined cap per feature, a popular one could scale cost unexpectedly fast. Setting (or confirming “no AI involved”) a usage cap is now a standing task for every feature block, done as part of testing it — not assumed, not skipped.
| Feature Block | Uses AI? | Usage Cap | Status |
|---|---|---|---|
| 1. Analytics | No — pure calculation | N/A | [x] Confirmed |
| 2–12. All remaining blocks | Not yet assessed | — | [ ] Not started |
Enhancement List
Longer-term improvements identified during testing — not bugs, not blockers, genuine new capability ideas, scheduled separately from the immediate fix-and-document work in each Feature Block.
| Enhancement | Relates to | Status |
|---|---|---|
| Add Recipes to the Wellness Channel as a “Taste It” stream, alongside the existing “Hear It” (Sound) and “See It” (Vision) streams | Feature Block 10: Wellness Channel | [ ] Proposed |
| Add a button to auto-add a recipe’s ingredients directly to the Pantry | Feature Block 6: Body Wellness Platform (Pantry) | [ ] Proposed |
Project Scope
For every release the complete feature list must be in full – because new features can impact released features.
Ticked items are completed. Everything else is a planned backlog
Version One Features List:
- Home page
- General description of product/offer
- Wellness Study & Triage
- Triage with Katie
- Biometrics
- Body & Digestive Analytics ✔
- Sleep Analytics ✔
- Neuro Analytics ✔
- Self-Assessed Biomarkers
- Verification Centre
- Wellness Report
- Personalisation Hub
- Wholefoods Database
- Supplements Database
- Mind Therapies Database
- Sleep Therapies Database
- Suggested Supplements
- Suggested Wholefoods
- Suggested EAT & NEAT Activities
- Suggested Mind Therapies
- Suggested Sleep Therapies
- Wellness Plan
- Your Priorities
- Your Personalisation
- Your Holistic Wellness Programme
- › Body Platform
- › Sleep Platform
- › Mind Platform
- One Click Doctor Share
- Body Wellness Platform
- Pantry
- Cooking and Preparation Methods
- AI and Self Build Recipes
- Meal Planner (Auto / Build)
- Activity Planner (Auto / Build)
- Full Body Plan Builder
- AI Cheat Foods (Supermarket labels) — 3 analyses
- AI Cheat Foods (Restaurant / Takeaway image analysis) — 3 analyses
- Sleep Wellness Platform
- Sleep Studio Page
- Apnea Page
- Circadian Page
- Insomnia Page
- CBT-I Modules
- Sleep Diary Page
- Restless Legs Page
- Sleep Tools Page
- Panic Page
- Mind Wellness Platform
- Neuro Profiling
- Neuro Load Analysis
- Neuro State
- Neuro Therapy Planner
- Wellness Tracker & Monitor
- Wellness Tracker
- Wellness Monitor
- Day Type Selection
- Cheat Logger
- Wellness Channel
- Sound and Vision Streams — Rotating
- Wellness Products Channel
- Wellness Verification Tests
- Wellness Monitoring
- Wellness Support Tools and Devices
- Wellness Supplements
- Wellness Community
- Katie AI Support
- User Management
- Account
- › Login
- › Account Page
- › Delete Account
- Plans & Billing
- › Upgrade
- › Plans
- › Checkout
- › Cancel Subscription
- › Undo Cancellation
- › Billing Portal
- Seat Management
Project Content
Is a section per feature or feature block. Each section includes
- › Scope of feature block
- › List of associated scripts
- Errors and Improvement + status tag
- Document Requirements + status tag
- Document AI Upload a+ status tag
- AI Usage Cap + status tag
Feature Block 1: Analytics In Progress
Scope of feature block: Body & Digestive Analytics, Sleep Analytics, Neuro Analytics. Confirmed to share one calculation engine and one results display, not three separate codebases.
List of associated scripts
assessmentCalculator.php— original calculation logic for every scoreassessmentCalculatorIntelligent.php— later rewrite of the same calculations. Confirmed live, matched directly against a real screenshotassessmentResultsShow.php— older plain-table results display. Live status unconfirmedassessmentResultsIntelligent.php— newer “vibrant card” results display. Confirmed live, matched directly against a real screenshotassessmentResult.php— supplied but not yet reviewed at all
Errors and Improvement
Diabetes age-scoring disagreed between the two live calculator files — a dead, unreachable line meant ages 50–59 scored 9 points instead of the intended 5. Corrected in assessmentCalculatorIntelligent.php to match the original calculator’s working bands.
Real developer notes were exposed directly in the results table in assessmentResultsShow.php (e.g. “IBS Risk-checked php okay but js missing gad contrib”), alongside a malformed duplicate <tr> tag. Both cleaned.
An unreachable IBS scoring band in assessmentCalculator.php, labelled “Severe was Extreme.” Harmless (real max score is 90, so 91+ can never trigger) but unpolished and worth tidying.
assessmentResult.php has not been opened or reviewed at all yet.
assessmentResultsShow.php‘s real live status has not been confirmed either way.
Document Requirements
assessment-scoring-reference.txt — derived directly from the corrected production logic. Covers, as twelve self-contained paragraphs: BMI (formula and five risk bands), BMR (Mifflin-St Jeor, by gender), VFA / Visceral Fat (formula by gender, four risk bands), GAD-7 Anxiety (scoring method, four risk bands), OSA / Sleep Apnea (seven yes/no factors, four risk bands), Insomnia / ISI (scoring method, four risk bands), Circadian Rhythm (scoring method, four risk bands), IBS (combined scoring including the GAD-7 bridge, real 90-point ceiling), SIBO (scoring method, four risk bands), Celiac (scoring method, four risk bands), Lactose (scoring method including ethnicity adjustment, four risk bands), Diabetes (all seven contributing factors, four risk bands), and IBD Alert (separate, unconditional trigger).
Document AI Upload
- Submit
assessment-scoring-reference.txtvia Add New → Upload .txt at/admin-knowledge-manager/ - Approve in the Review Queue
- Test live, through the real chat widget, asking about thresholds close to similar-sounding numbers in different scores — e.g. GAD-7’s Severe (15+) versus Diabetes’s very different scale — to confirm no cross-contamination
AI Usage Cap
No AI calls involved at all — every score is pure PHP calculation, not generative AI. No usage cap needed for this block.
Feature Block 2: Wellness Study & Triage (remaining)
Scope of feature block: Triage with Katie, Biometrics, Self-Assessed Biomarkers, Verification Centre, Wellness Report. Excludes Analytics — already Feature Block 1.
List of associated scripts
- script name 1 — untested
- script name 2 — untested
- script name 3 — untested
Errors and Improvement
Document Requirements
Document AI Upload
AI Usage Cap
Feature Block 3: Home Page
Scope of feature block: General description of product/offer.
List of associated scripts
- script name 1 — untested
- script name 2 — untested
- script name 3 — untested
Errors and Improvement
Document Requirements
Document AI Upload
AI Usage Cap
Feature Block 4: Personalisation Hub
Scope of feature block: Wholefoods Database, Supplements Database, Mind Therapies Database, Sleep Therapies Database, Suggested Supplements, Suggested Wholefoods, Suggested EAT & NEAT Activities, Suggested Mind Therapies, Suggested Sleep Therapies.
List of associated scripts
- script name 1 — untested
- script name 2 — untested
- script name 3 — untested
Errors and Improvement
Document Requirements
Document AI Upload
AI Usage Cap
Feature Block 5: Wellness Plan
Scope of feature block: Your Priorities, Your Personalisation, Your Holistic Wellness Programme (Body Platform, Sleep Platform, Mind Platform), One Click Doctor Share.
List of associated scripts
- script name 1 — untested
- script name 2 — untested
- script name 3 — untested
Errors and Improvement
Document Requirements
Document AI Upload
AI Usage Cap
Feature Block 6: Body Wellness Platform
Scope of feature block: Pantry, Cooking and Preparation Methods, AI and Self Build Recipes, Meal Planner, Activity Planner, Full Body Plan Builder, AI Cheat Foods (Supermarket labels), AI Cheat Foods (Restaurant / Takeaway).
List of associated scripts
uk_food_analyzer_v5.php(AI and Self Build Recipes) — Tested — green light- script name 2 — untested
- script name 3 — untested
Errors and Improvement
Recipes (uk_food_analyzer_v5.php) tested and approved. Two longer-term enhancements identified during testing, logged in the Enhancement List, not treated as blockers: adding Recipes to the Wellness Channel as a “Taste It” stream, and a one-click “add to Pantry” button.
Document Requirements
Document AI Upload
AI Usage Cap
Feature Block 7: Sleep Wellness Platform
Scope of feature block: Sleep Studio Page, Apnea Page, Circadian Page, Insomnia Page, CBT-I Modules, Sleep Diary Page, Restless Legs Page, Sleep Tools Page, Panic Page.
List of associated scripts
- script name 1 — untested
- script name 2 — untested
- script name 3 — untested
Errors and Improvement
Document Requirements
Document AI Upload
AI Usage Cap
Feature Block 8: Mind Wellness Platform
Scope of feature block: Neuro Profiling, Neuro Load Analysis, Neuro State, Neuro Therapy Planner.
List of associated scripts
- script name 1 — untested
- script name 2 — untested
- script name 3 — untested
Errors and Improvement
Document Requirements
Document AI Upload
AI Usage Cap
Feature Block 9: Wellness Tracker & Monitor
Scope of feature block: Wellness Tracker, Wellness Monitor, Day Type Selection, Cheat Logger.
List of associated scripts
- script name 1 — untested
- script name 2 — untested
- script name 3 — untested
Errors and Improvement
Document Requirements
Document AI Upload
AI Usage Cap
Feature Block 10: Wellness Channel
Scope of feature block: Sound and Vision Streams (Rotating), Wellness Products Channel, Wellness Verification Tests, Wellness Monitoring, Wellness Support Tools and Devices, Wellness Supplements.
List of associated scripts
- script name 1 — untested
- script name 2 — untested
- script name 3 — untested
Errors and Improvement
Pending enhancement (see Enhancement List): a “Taste It” stream, adding Recipes alongside the existing “Hear It” and “See It” streams.
Document Requirements
Document AI Upload
AI Usage Cap
Feature Block 11: Wellness Community
Scope of feature block: Katie AI Support.
List of associated scripts
- script name 1 — untested
- script name 2 — untested
- script name 3 — untested
Errors and Improvement
Document Requirements
Document AI Upload
AI Usage Cap
Feature Block 12: User Management
Scope of feature block: Account (Login, Account Page, Delete Account), Plans & Billing (Upgrade, Plans, Checkout, Cancel Subscription, Undo Cancellation, Billing Portal), Seat Management.
List of associated scripts
- script name 1 — untested
- script name 2 — untested
- script name 3 — untested
Errors and Improvement
Document Requirements
Document AI Upload
AI Usage Cap
Appendix — Project Progress
| Feature Block | Status |
|---|---|
| 1. Analytics | [x] In progress |
| 2. Wellness Study & Triage (remaining) | [ ] Not started |
| 3. Home Page | [ ] Not started |
| 4. Personalisation Hub | [ ] Not started |
| 5. Wellness Plan | [ ] Not started |
| 6. Body Wellness Platform | [ ] Not started |
| 7. Sleep Wellness Platform | [ ] Not started |
| 8. Mind Wellness Platform | [ ] Not started |
| 9. Wellness Tracker & Monitor | [ ] Not started |
| 10. Wellness Channel | [ ] Not started |
| 11. Wellness Community | [ ] Not started |
| 12. User Management | [ ] Not started |
For anything about the RAG system itself — main.py, the database, SSH, systemd, the Knowledge Manager’s own code, or the credentials process — see katie-rag-guide.php. That document is complete and does not need rebuilding.