# reaksmey8/lifeforgefinalprojectjava architecture

> Architecture diagram of the GitHub repository reaksmey8/lifeforgefinalprojectjava, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/reaksmey8/lifeforgefinalprojectjava
- Repository: https://github.com/reaksmey8/lifeforgefinalprojectjava

## Overview

LIFEForge is a terminal-based wellness guidance application. A user launches the TUI, registers or signs in with biometric details, selects a goal, and receives compatibility-aware, personalized pillar guidance and a daily blueprint; recommendations can be explained, discussed, bookmarked, or exported. The graph preserves the documented admin, audit, and reporting branches. Some subsystem links rely on the README or SOURCE INDEX references; unsampled internals are not inferred beyond those relationships.

Main entry points: [`src/main/java/com/lifeforge/view/LifeForge.java`](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/view/LifeForge.java) (Terminal UI), [`src/main/java/com/lifeforge/service/RecommendationService.java`](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/RecommendationService.java) (Recommendation workflow), [`src/main/java/com/lifeforge/service/RecommendationEngine.java`](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/RecommendationEngine.java) (Rule-based engine), [`src/main/java/com/lifeforge/dao`](https://github.com/reaksmey8/lifeforgefinalprojectjava/tree/main/src/main/java/com/lifeforge/dao) (Data access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Terminal experience"]
  node_main["Application entry<br/>[Main.java]"]
  node_tui["Terminal UI<br/>[LifeForge.java]"]
end

subgraph group_workflow["Application workflow"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_profile["User profiles<br/>[UserService.java]"]
  node_goals["Goal management<br/>[GoalService.java]"]
  node_session["User session<br/>[Session.java]"]
  node_bookmarks["Saved recommendations"]
  node_reports["PDF reports"]
  node_admin["Admin and audit<br/>[AdminService.java]"]
end

subgraph group_guidance["Wellness guidance"]
  node_recommendation_service["Recommendation workflow"]
  node_engine["Rule-based engine"]
  node_priority["Priority resolver"]
  node_calories["Calorie guidance"]
  node_hydration["Hydration guidance"]
  node_daily_blueprint["Daily blueprint"]
  node_explanations["Recommendation explanations"]
  node_ai_chat["AI explanations and chat"]
end

subgraph group_persistence["Persistence and integrations"]
  node_daos["Data access"]
  node_db_config["Database connections"]
  node_postgres[("PostgreSQL")]
end

node_user(("User"))

node_user -->|"uses"| node_tui
node_main -->|"launches"| node_tui
node_tui -->|"requests sign-in"| node_auth
node_tui -->|"submits profile"| node_profile
node_tui -->|"selects goal"| node_goals
node_auth -->|"sets identity"| node_session
node_tui -->|"requests guidance"| node_recommendation_service
node_tui -->|"requests reports data"| node_recommendation_service
node_recommendation_service -->|"generates guidance"| node_engine
node_engine -->|"resolves priority"| node_priority
node_engine -->|"calculates targets"| node_calories
node_recommendation_service -->|"calculates hydration"| node_hydration
node_engine -->|"builds blueprint"| node_daily_blueprint
node_recommendation_service -->|"reads recommendations"| node_daos
node_tui -->|"requests rationale"| node_explanations
node_tui -->|"asks contextual questions"| node_ai_chat
node_tui -->|"saves recommendations"| node_bookmarks
node_tui -->|"requests PDF export"| node_reports
node_tui -->|"manages system"| node_admin
node_auth -->|"reads and writes accounts"| node_daos
node_admin -->|"manages records"| node_daos
node_daos -.->|"opens connections"| node_db_config
node_db_config -->|"connects"| node_postgres

click node_main "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/Main.java"
click node_tui "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/view/LifeForge.java"
click node_auth "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/AuthService.java"
click node_profile "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/UserService.java"
click node_goals "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/GoalService.java"
click node_session "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/Session.java"
click node_recommendation_service "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/RecommendationService.java"
click node_engine "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/RecommendationEngine.java"
click node_priority "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/RecommendationPriorityResolver.java"
click node_calories "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/CalorieService.java"
click node_hydration "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/HydrationService.java"
click node_daily_blueprint "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/model/DailyBlueprint.java"
click node_explanations "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/RecommendationExplanationService.java"
click node_ai_chat "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/AiExplanationService.java"
click node_bookmarks "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/SavedRecommendationService.java"
click node_reports "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/JasperReportsService.java"
click node_admin "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/AdminService.java"
click node_daos "https://github.com/reaksmey8/lifeforgefinalprojectjava/tree/main/src/main/java/com/lifeforge/dao"
click node_db_config "https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/config/DatabaseConfig.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_tui,node_user toneBlue
class node_auth,node_profile,node_goals,node_session,node_bookmarks,node_reports,node_admin toneAmber
class node_recommendation_service,node_engine,node_priority,node_calories,node_hydration,node_daily_blueprint,node_explanations,node_ai_chat toneMint
class node_daos,node_db_config,node_postgres toneRose
```

## Components

### Terminal experience

- [Application entry](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/Main.java): `src/main/java/com/lifeforge/Main.java`
- [Terminal UI](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/view/LifeForge.java): `src/main/java/com/lifeforge/view/LifeForge.java`

### Application workflow

- [Authentication](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/AuthService.java): `src/main/java/com/lifeforge/service/AuthService.java`
- [User profiles](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/UserService.java): `src/main/java/com/lifeforge/service/UserService.java`
- [Goal management](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/GoalService.java): `src/main/java/com/lifeforge/service/GoalService.java`
- [User session](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/Session.java): `src/main/java/com/lifeforge/Session.java`
- [Saved recommendations](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/SavedRecommendationService.java): `src/main/java/com/lifeforge/service/SavedRecommendationService.java`
- [PDF reports](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/JasperReportsService.java): `src/main/java/com/lifeforge/service/JasperReportsService.java`
- [Admin and audit](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/AdminService.java): `src/main/java/com/lifeforge/service/AdminService.java`

### Wellness guidance

- [Recommendation workflow](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/RecommendationService.java): `src/main/java/com/lifeforge/service/RecommendationService.java`
- [Rule-based engine](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/RecommendationEngine.java): `src/main/java/com/lifeforge/service/RecommendationEngine.java`
- [Priority resolver](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/RecommendationPriorityResolver.java): `src/main/java/com/lifeforge/service/RecommendationPriorityResolver.java`
- [Calorie guidance](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/CalorieService.java): `src/main/java/com/lifeforge/service/CalorieService.java`
- [Hydration guidance](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/HydrationService.java): `src/main/java/com/lifeforge/service/HydrationService.java`
- [Daily blueprint](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/model/DailyBlueprint.java): `src/main/java/com/lifeforge/model/DailyBlueprint.java`
- [Recommendation explanations](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/RecommendationExplanationService.java): `src/main/java/com/lifeforge/service/RecommendationExplanationService.java`
- [AI explanations and chat](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/service/AiExplanationService.java): `src/main/java/com/lifeforge/service/AiExplanationService.java`

### Persistence and integrations

- [Data access](https://github.com/reaksmey8/lifeforgefinalprojectjava/tree/main/src/main/java/com/lifeforge/dao): `src/main/java/com/lifeforge/dao`
- [Database connections](https://github.com/reaksmey8/lifeforgefinalprojectjava/blob/main/src/main/java/com/lifeforge/config/DatabaseConfig.java): `src/main/java/com/lifeforge/config/DatabaseConfig.java`
- **PostgreSQL**

### Other components

- **User**

## Connections

- User → Terminal UI: uses
- Application entry → Terminal UI: launches (evidence: `src/main/java/com/lifeforge/Main.java`)
- Terminal UI → Authentication: requests sign-in
- Terminal UI → User profiles: submits profile
- Terminal UI → Goal management: selects goal
- Authentication → User session: sets identity (evidence: `src/main/java/com/lifeforge/Session.java`)
- Terminal UI → Recommendation workflow: requests guidance (evidence: `src/main/java/com/lifeforge/controller/RecommendationController.java`)
- Terminal UI → Recommendation workflow: requests reports data (evidence: `src/main/java/com/lifeforge/view/LifeForge.java`)
- Recommendation workflow → Rule-based engine: generates guidance (evidence: `src/main/java/com/lifeforge/service/RecommendationService.java`)
- Rule-based engine → Priority resolver: resolves priority (evidence: `src/main/java/com/lifeforge/service/RecommendationEngine.java`)
- Rule-based engine → Calorie guidance: calculates targets (evidence: `src/main/java/com/lifeforge/service/RecommendationEngine.java`)
- Recommendation workflow → Hydration guidance: calculates hydration (evidence: `src/main/java/com/lifeforge/service/RecommendationService.java`)
- Rule-based engine → Daily blueprint: builds blueprint (evidence: `src/main/java/com/lifeforge/service/RecommendationEngine.java`)
- Recommendation workflow → Data access: reads recommendations (evidence: `src/main/java/com/lifeforge/service/RecommendationService.java`)
- Terminal UI → Recommendation explanations: requests rationale
- Terminal UI → AI explanations and chat: asks contextual questions (evidence: `src/main/java/com/lifeforge/service/AiExplanationService.java`)
- Terminal UI → Saved recommendations: saves recommendations
- Terminal UI → PDF reports: requests PDF export
- Terminal UI → Admin and audit: manages system
- Authentication → Data access: reads and writes accounts (evidence: `src/main/java/com/lifeforge/service/AuthService.java`)
- Admin and audit → Data access: manages records (evidence: `src/main/java/com/lifeforge/service/AdminService.java`)
- Data access → Database connections: opens connections (evidence: `src/main/java/com/lifeforge/dao/RecommendationDao.java`)
- Database connections → PostgreSQL: connects (evidence: `src/main/java/com/lifeforge/config/DatabaseConfig.java`)
