diff --git a/FIRE_PLANNING_ENHANCEMENTS.md b/FIRE_PLANNING_ENHANCEMENTS.md new file mode 100644 index 0000000..de2d901 --- /dev/null +++ b/FIRE_PLANNING_ENHANCEMENTS.md @@ -0,0 +1,198 @@ +# FIRE Planning Calculator - Educational Enhancements + +## Summary of Changes + +This document describes the educational content and explanations added to the FIRE Planning mini app to help users understand the calculations and methodology. + +--- + +## 1. Educational Info Section (Top of Page) + +**Location:** Below the header, before the input form + +**Content:** +- **Green highlighted box** with lightbulb icon +- Explanation of FIRE (Financial Independence, Retire Early) movement +- Detailed explanation of the **4% Safe Withdrawal Rate Rule** +- Formula breakdown: **FIRE Target = Annual Expenses × 25** +- Practical example: A$80,000/year expenses → A$2,000,000 target +- Trinity Study reference + +**Purpose:** Educate users before they enter data + +--- + +## 2. Calculation Methodology Box + +**Location:** In results section, above summary cards + +**Content:** +- **Blue highlighted box** explaining step-by-step calculations +- Shows formulas with **real-time calculated values**: + 1. Annual Savings = Income × Savings Rate + 2. FIRE Target (4% Rule) = Annual Expenses × 25 + 3. Yearly Growth = (Net Worth + Savings) × (1 + Return Rate) + 4. Inflation-Adjusted Target = FIRE Target × (1 + Inflation)^years + 5. Progress % = (Net Worth ÷ Adjusted Target) × 100% + +**Purpose:** Transparency in how numbers are calculated + +--- + +## 3. Enhanced Summary Cards + +**Added to each card:** +- **Subtitle explanations** below the main value +- Context about what each number means +- Additional details like: + - "Based on 4% rule (25× expenses)" + - "Adjusted for X% annual inflation" + - "In Y years (target year)" + - Suggestions when FIRE not achieved + +**Purpose:** Help users interpret each metric + +--- + +## 4. Scenario Analysis Explanation + +**Location:** Above scenario tabs + +**Content:** +- Explanation of why different scenarios matter +- What each scenario represents: + - **Conservative (6%)**: Bonds/safer investments + - **Neutral (8%)**: Balanced portfolio + - **Optimistic (10%)**: Aggressive stock-heavy portfolio +- Note about historical market variance + +**Purpose:** Help users understand risk and return trade-offs + +--- + +## 5. Chart Descriptions + +**Added before each chart:** + +### Net Worth Growth Chart +- Explains green line (projected net worth with compound growth) +- Explains red dashed line (inflation-adjusted FIRE target) +- Clear indication of what "crossing" means (FIRE achieved!) + +### Progress Chart +- Explains the percentage calculation +- Notes that 100% = FIRE achieved + +### Projection Table +- Explains what each column represents +- Notes that green rows = FIRE achieved years + +**Purpose:** Make visualizations self-explanatory + +--- + +## 6. FAQ Section (Bottom of Page) + +**Location:** Below all results and charts + +**6 Comprehensive FAQs:** + +### Q1: Why multiply annual expenses by 25? +- Explains 4% rule mathematics +- Provides concrete example +- Shows the inverse relationship (1 ÷ 0.04 = 25) + +### Q2: What's a realistic return rate? +- Historical S&P 500 returns (~10% nominal) +- Real returns after inflation (7-8%) +- Different investor profiles (conservative/balanced/aggressive) +- Recommended ranges (6-10%) + +### Q3: How does compound growth work? +- Formula: New Net Worth = (Previous + Savings) × (1 + Return) +- Step-by-step numerical example +- Explains exponential growth concept + +### Q4: Why does FIRE target increase over time? +- Inflation explanation +- Purchasing power concept +- Formula: Future = Current × (1 + Inflation)^years +- Example: A$100k → A$145k in 15 years at 2.5% inflation + +### Q5: Should I include my home in net worth? +- Distinction between total net worth and investable assets +- Why primary residence doesn't generate FIRE cash flow +- Recommendation to track both separately + +### Q6: Important Assumptions & Limitations +- **Bulleted list of caveats:** + - Constant savings/income assumption + - Taxes and healthcare not included + - Market volatility considerations + - Superannuation/401k exclusion + - Disclaimer: Planning tool, not financial advice + +**Purpose:** Address common questions and provide education + +--- + +## Visual Design + +All educational sections use: +- **Color-coded backgrounds:** + - Green gradient for FIRE/4% rule intro + - Blue for calculation methodology + - Yellow/cream for FAQ section + - White cards for individual FAQs +- **Icons** for visual interest and quick recognition +- **Proper hierarchy** with headings and spacing +- **Readable font sizes** (text-sm for detailed content) +- **Responsive design** that works on mobile + +--- + +## User Journey + +1. **Learn first** - Educational intro sets context +2. **Input data** - Clear help text on each field +3. **Calculate** - See methodology explanation +4. **Understand results** - Enhanced summary cards with context +5. **Visualize** - Charts with descriptions +6. **Deep dive** - Detailed table +7. **Learn more** - FAQ section for deeper understanding + +--- + +## Key Formulas Highlighted + +1. **FIRE Target** = Annual Expenses × 25 +2. **Annual Savings** = Income × Savings Rate +3. **Compound Growth** = (Net Worth + Savings) × (1 + Return Rate) +4. **Inflation Adjustment** = Target × (1 + Inflation Rate)^years +5. **Progress** = (Net Worth ÷ Adjusted Target) × 100% + +--- + +## Benefits + +✅ **Transparency** - Users understand where numbers come from +✅ **Education** - Learn FIRE principles while planning +✅ **Confidence** - Make informed decisions with full context +✅ **Trust** - Clear methodology builds credibility +✅ **Self-service** - FAQ answers common questions without support + +--- + +## Future Enhancements (Optional) + +- Interactive tooltips on hover for input fields +- Video tutorials or animated explanations +- Links to Trinity Study and FIRE movement resources +- Glossary of financial terms +- Share/export functionality with explanations included +- Multi-language support for international users + +--- + +**Last Updated:** October 11, 2025 +**Version:** 1.1 (Educational Enhancement Release) diff --git a/agents.md b/agents.md index 5c1c7ce..184cf5c 100644 --- a/agents.md +++ b/agents.md @@ -101,11 +101,8 @@ Blog-like content management: - Tag categorization - Publication status tracking -#### IPTVCollection & IPTVChannel -IPTV playlist management: -- M3U playlist parsing -- Channel metadata -- Category organization +#### mini_apps +A collection of mini apps which can be located at mini_apps_views.py #### Analytics Models - **ClickLog**: Individual click tracking with timestamps diff --git a/links/mini_apps_views.py b/links/mini_apps_views.py index c9d1286..0dc5128 100644 --- a/links/mini_apps_views.py +++ b/links/mini_apps_views.py @@ -25,7 +25,16 @@ class MiniAppsListView(TemplateView): 'thumbnail': 'https://images.unsplash.com/photo-1589254065878-42c9da997008?w=400&h=300&fit=crop', 'icon': 'fas fa-volume-up', 'color': '#8e44ad' - },{ + }, + { + 'name': 'FIRE Planning', + 'description': 'Plan your Financial Independence Retire Early (FIRE) journey with interactive calculators, projections, and visualizations.', + 'url': 'mini-apps-fire-planning', + 'thumbnail': 'https://images.unsplash.com/photo-1579621970563-ebec7560ff3e?w=400&h=300&fit=crop', + 'icon': 'fas fa-chart-line', + 'color': '#27ae60' + }, + { 'name': 'Weather Dashboard', 'description': 'Real-time weather information with beautiful visualizations and forecasts.', 'url': '#', @@ -55,3 +64,12 @@ class TTSView(TemplateView): context = super().get_context_data(**kwargs) context['page_title'] = 'Text-to-Speech' return context + + +class FIREPlanningView(TemplateView): + template_name = 'links/mini_apps/fire_planning.html' + + def get_context_data(self, **kwargs): + context = super().get_context_data(**kwargs) + context['page_title'] = 'FIRE Planning Calculator' + return context diff --git a/links/templates/links/mini_apps/fire_planning.html b/links/templates/links/mini_apps/fire_planning.html new file mode 100644 index 0000000..5b26684 --- /dev/null +++ b/links/templates/links/mini_apps/fire_planning.html @@ -0,0 +1,963 @@ +{% extends 'base.html' %} +{% load i18n %} +{% load static %} + +{% block title %}{% trans "FIRE Planning Calculator" %} - {% trans "Mini Apps" %}{% endblock %} + +{% block extra_css %} + +{% endblock %} + +{% block content %} +
+ +
+

+ + FIRE Planning Calculator +

+

+ Plan Your Financial Independence and Early Retirement Journey +

+
+ + +
+
+
+ +
+
+

+ + Understanding FIRE & The 4% Rule +

+
+

+ FIRE (Financial Independence, Retire Early) is a movement focused on achieving financial freedom through aggressive saving and smart investing. +

+

+ The 4% Rule: Based on the Trinity Study, this rule suggests you can safely withdraw 4% of your investment portfolio annually in retirement, adjusted for inflation, with a high probability your money will last 30+ years. +

+

+ Your FIRE Target = Annual Expenses × 25 (because 1 ÷ 0.04 = 25) +

+

+ + Example: If you need A$80,000/year to live comfortably, your FIRE target is A$2,000,000. + At 4% withdrawal, A$2M × 4% = A$80,000 per year. +

+
+
+
+
+ + +
+

+ + Your Financial Details +

+ +
+
+ + +
Your current age in years
+
+ +
+ + +
Age you want to achieve financial independence
+
+ +
+ + +
Investable assets excluding primary residence
+
+ +
+ + +
Total net worth including property
+
+ +
+ + +
Expected yearly spending after FIRE
+
+ +
+ + +
Total yearly income before tax
+
+ +
+ + +
Percentage of income saved annually
+
+ +
+ + +
Average annual investment return rate
+
+ +
+ + +
Expected average annual inflation
+
+
+ +
+ + +
+
+ + +
+

+ + Your FIRE Journey Summary +

+ +
+ +
+ + +
+

+ + How We Calculate Your FIRE Journey +

+
+

1. Annual Savings: Income × Savings Rate = ...

+

2. FIRE Target (4% Rule): Annual Expenses × 25 = ...

+

3. Yearly Growth: (Net Worth + Annual Savings) × (1 + Return Rate)

+

4. Inflation-Adjusted Target: FIRE Target × (1 + Inflation)years

+

5. Progress: (Current Net Worth ÷ Inflation-Adjusted Target) × 100%

+

+ + FIRE is achieved when your net worth reaches or exceeds your inflation-adjusted target (≥100% progress) +

+
+
+ + +
+

Scenario Analysis

+

+ + Compare different return rate scenarios. Historical stock market returns vary, so it's wise to plan for multiple outcomes. + Conservative (6%) = bonds/safer investments, + Neutral (8%) = balanced portfolio, + Optimistic (10%) = aggressive stock-heavy portfolio. +

+
+ + + +
+
+ + +
+

+ + Net Worth Projection vs FIRE Target +

+

+ Green line: Your projected net worth growth (investments + annual savings × compound returns). + Red dashed line: FIRE target adjusted for inflation. + When green crosses above red, you've achieved FIRE! 🎉 +

+ +
+ + +
+

+ + FIRE Progress Over Time +

+

+ Your FIRE progress as a percentage. 100% means you've reached your target! + This shows: (Current Net Worth ÷ Inflation-Adjusted FIRE Target) × 100% +

+ +
+ + +
+

+ + Year-by-Year Projection +

+

+ Detailed breakdown of your FIRE journey. + Green rows indicate years where you've achieved FIRE (≥100% progress). +

+
+ + + + + + + + + + + + + + +
AgeYearNet WorthFIRE TargetProgressAnnual Savings
+
+
+
+ + +
+

+ + Frequently Asked Questions +

+ +
+
+

+ + Why multiply annual expenses by 25? +

+

+ The 4% rule (based on historical market data) suggests you can safely withdraw 4% of your portfolio annually. + Since 1 ÷ 0.04 = 25, you need 25 times your annual expenses. For example: need A$60,000/year → target A$1,500,000 portfolio. +

+
+ +
+

+ + What's a realistic return rate? +

+

+ Historical stock market returns (S&P 500) average ~10% annually before inflation. After inflation (~2-3%), real returns are ~7-8%. + Conservative investors might use 6%, balanced 8%, aggressive 10%. Diversified portfolios typically aim for 7-9%. +

+
+ +
+

+ + How does compound growth work? +

+

+ Each year: New Net Worth = (Previous Net Worth + Annual Savings) × (1 + Return Rate). + Example: Start with A$100,000, save A$30,000/year at 8% return → Year 1: (A$100k + A$30k) × 1.08 = A$140,400. + This compounds over time, creating exponential growth! +

+
+ +
+

+ + Why does the FIRE target increase over time? +

+

+ Inflation! A$100,000 today won't have the same purchasing power in 15 years. At 2.5% inflation, A$100,000 becomes ~A$145,000 in 15 years. + The calculator adjusts your target using: Future Target = Current Target × (1 + Inflation Rate)years +

+
+ +
+

+ + Should I include my home in net worth? +

+

+ For FIRE calculations, use "Net Worth excl. home" - only investable assets that generate income. + Your primary residence doesn't produce cash flow for living expenses (though it does have value and reduces housing costs). + Track total net worth separately for overall wealth monitoring. +

+
+ +
+

+ + Important Assumptions & Limitations +

+
    +
  • Assumes constant savings rate and income (real life varies!)
    • +
  • Doesn't account for taxes, healthcare costs, or unexpected expenses
    • +
  • Market returns fluctuate - use scenario analysis for different outcomes
    • +
  • Superannuation/401k considerations not included (consult financial advisor)
    • +
  • This is a planning tool, not financial advice - do your own research!
    • +
+
+
+
+
+ + + + + +{% endblock %} diff --git a/links/urls.py b/links/urls.py index 22d0d22..1b71e9d 100644 --- a/links/urls.py +++ b/links/urls.py @@ -51,6 +51,7 @@ urlpatterns = [ path('ui/mini-apps/', mini_apps_views.MiniAppsListView.as_view(), name='mini-apps-list'), path('ui/mini-apps/image-gallery/', mini_apps_views.ImageGalleryView.as_view(), name='mini-apps-image-gallery'), path('ui/mini-apps/tts/', mini_apps_views.TTSView.as_view(), name='mini-apps-tts'), + path('ui/mini-apps/fire-planning/', mini_apps_views.FIREPlanningView.as_view(), name='mini-apps-fire-planning'), # TTS API path('ui/tts-api/', views.generate_tts_api, name='tts-api'),