PROJECT_CONTEXT.md 2.7 KB

PROJECT_CONTEXT.md

1. Vision Statement

LocalFoodAI is a local food AI that provides full nutritional value information on any food and can generate complete menu proposals based on the user's specification.

Key Features:

  • User Accounts: Create an account and log in.
  • Nutritional Info: Complete data (macros, minerals, vitamins, amino acids, etc.) for any food.
  • Food Combinations: Nutritional overview for user-specified quantities/combinations.
  • Nutrient Search: Search for specific nutrients and get a sortable list of foods.
  • Saved Lists: Store and edit food combinations in named lists.
  • Menu Proposals: AI-generated menus based on nutritional goals and constraints (e.g., allergies).
  • Nutrition Chat: Competent AI interaction for any nutrition-related queries.
  • Local Web Search: Anonymous tool for gathering missing info without leaving the server.

Constraints:

  • Privacy: No user data leaves the server. All computation is local.
  • Open Source: Public repo on https://git.btshub.lu/LocalFoodAI_<IAM>. No confidential data in Git.
  • Environment: Ubuntu 24.04 VM (8 vCPUs, 30 GB RAM, no dedicated GPU).
  • Backend: Python/FastAPI with local database (SQLite/PostgreSQL).
  • LLM: Quantized local models (via Ollama) optimized for CPU.

2. Roles

  • Product Owner & Tech Lead: User (Roni) - Interviews customer, writes Taiga backlog, directs Antigravity.
  • Development Team: Antigravity (AI) - Writes code, generates implementation plans, verifies logic.
  • Customer & Scrum Master: Teacher (Gilles Everling) - Stakeholder and authority on "Done".

3. Workflow & Scrum Rules

  • Sprint Duration: 1 week.
  • Meetings:
    • Daily Scrum (Wiki documentation: Accomplishments, Next steps, Obstacles).
    • Thursday: Sprint Review, Sprint Retrospective, Sprint Planning.
  • Backlog Management: User Stories in Taiga, broken into Technical Tasks.
  • Review Policy: "Request Review" (Antigravity must not auto-proceed). User must approve Python/DB logic.
  • Commit Format: Every commit message must start with TG-<task_id>: <description>.
  • Taiga-Gogs Integration: Webhooks track progress via commit messages.

4. Documentation Requirements (For Final Grade)

  • Technical Document: Installation/config guide, tech stack explanation, LLM selection rationale, diagram of local communication, proof of 100% data privacy.
  • User Manual: Non-developer guide on how to use all features.
  • Antigravity Reflection: Explain model usage, agent permissions, and how struggles were handled.

5. VM Access

  • Host: 192.168.130.171
  • User: roni
  • Password: BTSai123
  • Root Password: BTSai123