# Future Roadmap & TODOs

## Phase 3: AI Analysis & Insights

### 1. Data Analysis Enhancements
- [ ] **Timeframe Selection**:
    - [ ] Update Backend API to accept timeframe parameters (e.g., `?range=30d`, `?range=year`, `?range=all`).
    - [ ] Update Frontend to include a dropdown/toggle for these timeframes.
- [ ] **Advanced Stats**:
    - [ ] Top Artists / Tracks calculation for the selected period.
    - [ ] Genre distribution charts (Pie/Bar chart).

### 2. AI Integration (Gemini)
- [ ] **Trigger Mechanism**:
    - [ ] Add "Generate AI Report" button on the UI.
    - [ ] (Optional) Schedule daily auto-generation.
- [ ] **Prompt Engineering**:
    - [ ] Design prompts to analyze:
        - "Past 30 Days" (Monthly Vibe Check).
        - "Overall" (Yearly/All-time evolution).
    - [ ] Provide raw data (list of tracks + audio features) to Gemini.
- [ ] **Storage**:
    - [ ] Create `AnalysisReport` table to store generated HTML/Markdown reports.
    - [ ] View past reports in a new "Insights" tab.

### 3. Playlist Generation
- [ ] **Concept**: "Daily Vibe Playlist" or "AI Recommended".
- [ ] **Implementation**:
    - [ ] Use ReccoBeats or Spotify Recommendations API.
    - [ ] Seed with top 5 recent tracks.
    - [ ] Filter by audio features (e.g., "High Energy" playlist).
- [ ] **Action**:
    - [ ] Add "Save to Spotify" button in the UI (Requires `playlist-modify-public` scope).

### 4. Polish
- [ ] **Mobile Responsiveness**: Ensure Ant Design tables and charts stack correctly on mobile.
- [ ] **Error Handling**: Better UI feedback for API failures (e.g., expired tokens).
