# viky-m/habit-tracker-backend architecture

> Architecture diagram of the GitHub repository viky-m/habit-tracker-backend, 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/viky-m/habit-tracker-backend
- Repository: https://github.com/viky-m/habit-tracker-backend

## Overview

This is a Laravel habit-tracking API: users authenticate, manage habits and reminders, log completions, and receive streak, XP, hero, achievement, and analytics progression. The graph shows the documented product branches plus the sampled authentication and gamification calls. Most other controller/service relationships are supported by the SOURCE INDEX only where it explicitly names the dependency; unsampled feature internals and notification delivery are not inferred.

Main entry points: [`app/Providers/AppServiceProvider.php`](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Providers/AppServiceProvider.php) (Service and repository bindings), [`app/Services/GamificationService.php`](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/GamificationService.php) (Progression coordinator), [`app/Services/HabitLogService.php`](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/HabitLogService.php) (Completion processing), [`app/Services/AuthService.php`](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/AuthService.php) (Authentication service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API entry"]
  node_auth_api["Authentication API<br/>[AuthController.php]"]
  node_auth_logic["Authentication service<br/>[AuthService.php]"]
  node_repository_bindings["Service and repository bindings"]
end

subgraph group_habits["Habit tracking"]
  node_habit_api["Habit API"]
  node_habit_service["Habit management<br/>[HabitService.php]"]
  node_habit_log_api["Completion API"]
  node_habit_log_service["Completion processing"]
  node_reminder_api["Reminder API"]
  node_reminder_service["Reminder management"]
end

subgraph group_progression["Gamification"]
  node_gamification["Progression coordinator"]
  node_xp["XP calculation<br/>[XpCalculator.php]"]
  node_level_up["Level-up rules<br/>[LevelUpService.php]"]
  node_heroes_api["Hero catalog API<br/>[HeroController.php]"]
  node_user_hero_api["User hero API"]
  node_hero_service["Hero management<br/>[HeroService.php]"]
  node_user_hero_service["User hero management"]
  node_achievements["Achievement engine"]
  node_achievement_api["Achievement API"]
  node_stats_api["Analytics API"]
  node_stats_service["User analytics"]
end

subgraph group_persistence["Persistence layer"]
  node_user[("User accounts<br/>[User.php]")]
  node_habit[("Habits<br/>[Habit.php]")]
  node_habit_logs[("Completion logs<br/>[HabitLog.php]")]
  node_reminders[("Reminders<br/>[HabitReminder.php]")]
  node_hero[("Hero templates<br/>[Hero.php]")]
  node_user_hero[("User hero progress<br/>[UserHero.php]")]
  node_achievement_model[("Achievements<br/>[Achievement.php]")]
end

node_client(("API client"))

node_client -->|"sends auth requests"| node_auth_api
node_auth_api -->|"delegates auth"| node_auth_logic
node_auth_logic -->|"creates accounts"| node_user
node_auth_logic -->|"creates starter hero"| node_gamification
node_client -.->|"manages habits"| node_habit_api
node_habit_api -->|"delegates operations"| node_habit_service
node_habit_service -.->|"manages records"| node_habit
node_client -.->|"logs completion"| node_habit_log_api
node_habit_log_api -->|"delegates logging"| node_habit_log_service
node_habit_log_service -.->|"awards progression"| node_gamification
node_habit_log_service -.->|"records completion"| node_habit_logs
node_habit_log_service -.->|"updates habit"| node_habit
node_client -.->|"configures reminders"| node_reminder_api
node_reminder_api -->|"delegates operations"| node_reminder_service
node_reminder_service -.->|"manages reminders"| node_reminders
node_gamification -->|"calculates XP"| node_xp
node_gamification -->|"processes levels"| node_level_up
node_gamification -->|"updates progress"| node_user_hero
node_gamification -->|"finds starter"| node_hero
node_client -.->|"browses heroes"| node_heroes_api
node_client -.->|"manages heroes"| node_user_hero_api
node_client -.->|"checks achievements"| node_achievement_api
node_client -.->|"requests analytics"| node_stats_api
node_repository_bindings -->|"binds service"| node_auth_logic
node_repository_bindings -->|"binds service"| node_gamification
node_repository_bindings -->|"binds service"| node_habit_service
node_repository_bindings -->|"binds service"| node_habit_log_service
node_repository_bindings -->|"binds service"| node_reminder_service
node_repository_bindings -->|"binds service"| node_hero_service
node_repository_bindings -->|"binds service"| node_user_hero_service
node_repository_bindings -->|"binds service"| node_achievements
node_repository_bindings -->|"binds service"| node_stats_service

click node_auth_api "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/AuthController.php"
click node_auth_logic "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/AuthService.php"
click node_user "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/User.php"
click node_habit_api "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/HabitController.php"
click node_habit_service "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/HabitService.php"
click node_habit_log_api "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/HabitLogController.php"
click node_habit_log_service "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/HabitLogService.php"
click node_habit "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/Habit.php"
click node_habit_logs "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/HabitLog.php"
click node_reminder_api "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/HabitReminderController.php"
click node_reminder_service "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/HabitReminderService.php"
click node_reminders "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/HabitReminder.php"
click node_gamification "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/GamificationService.php"
click node_xp "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/XpCalculator.php"
click node_level_up "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/LevelUpService.php"
click node_heroes_api "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/HeroController.php"
click node_user_hero_api "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/UserHeroController.php"
click node_hero_service "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/HeroService.php"
click node_user_hero_service "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/UserHeroService.php"
click node_hero "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/Hero.php"
click node_user_hero "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/UserHero.php"
click node_achievements "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/AchievementService.php"
click node_achievement_api "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/AchievementController.php"
click node_achievement_model "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/Achievement.php"
click node_stats_api "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/UserStatsController.php"
click node_stats_service "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/UserStatsService.php"
click node_repository_bindings "https://github.com/viky-m/habit-tracker-backend/blob/main/app/Providers/AppServiceProvider.php"

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_auth_api,node_auth_logic,node_repository_bindings,node_client toneBlue
class node_habit_api,node_habit_service,node_habit_log_api,node_habit_log_service,node_reminder_api,node_reminder_service toneAmber
class node_gamification,node_xp,node_level_up,node_heroes_api,node_user_hero_api,node_hero_service,node_user_hero_service,node_achievements,node_achievement_api,node_stats_api,node_stats_service toneMint
class node_user,node_habit,node_habit_logs,node_reminders,node_hero,node_user_hero,node_achievement_model toneRose
```

## Components

### API entry

- [Authentication API](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/AuthController.php): `app/Http/Controllers/Api/AuthController.php`
- [Authentication service](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/AuthService.php): `app/Services/AuthService.php`
- [Service and repository bindings](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Providers/AppServiceProvider.php): `app/Providers/AppServiceProvider.php`

### Habit tracking

- [Habit API](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/HabitController.php): `app/Http/Controllers/Api/HabitController.php`
- [Habit management](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/HabitService.php): `app/Services/HabitService.php`
- [Completion API](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/HabitLogController.php): `app/Http/Controllers/Api/HabitLogController.php`
- [Completion processing](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/HabitLogService.php): `app/Services/HabitLogService.php`
- [Reminder API](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/HabitReminderController.php): `app/Http/Controllers/Api/HabitReminderController.php`
- [Reminder management](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/HabitReminderService.php): `app/Services/HabitReminderService.php`

### Gamification

- [Progression coordinator](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/GamificationService.php): `app/Services/GamificationService.php`
- [XP calculation](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/XpCalculator.php): `app/Services/XpCalculator.php`
- [Level-up rules](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/LevelUpService.php): `app/Services/LevelUpService.php`
- [Hero catalog API](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/HeroController.php): `app/Http/Controllers/Api/HeroController.php`
- [User hero API](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/UserHeroController.php): `app/Http/Controllers/Api/UserHeroController.php`
- [Hero management](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/HeroService.php): `app/Services/HeroService.php`
- [User hero management](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/UserHeroService.php): `app/Services/UserHeroService.php`
- [Achievement engine](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/AchievementService.php): `app/Services/AchievementService.php`
- [Achievement API](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/AchievementController.php): `app/Http/Controllers/Api/AchievementController.php`
- [Analytics API](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Http/Controllers/Api/UserStatsController.php): `app/Http/Controllers/Api/UserStatsController.php`
- [User analytics](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Services/UserStatsService.php): `app/Services/UserStatsService.php`

### Persistence layer

- [User accounts](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/User.php): `app/Models/User.php`
- [Habits](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/Habit.php): `app/Models/Habit.php`
- [Completion logs](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/HabitLog.php): `app/Models/HabitLog.php`
- [Reminders](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/HabitReminder.php): `app/Models/HabitReminder.php`
- [Hero templates](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/Hero.php): `app/Models/Hero.php`
- [User hero progress](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/UserHero.php): `app/Models/UserHero.php`
- [Achievements](https://github.com/viky-m/habit-tracker-backend/blob/main/app/Models/Achievement.php): `app/Models/Achievement.php`

### Other components

- **API client**

## Connections

- API client → Authentication API: sends auth requests (evidence: `app/Http/Controllers/Api/AuthController.php`)
- Authentication API → Authentication service: delegates auth (evidence: `app/Http/Controllers/Api/AuthController.php`)
- Authentication service → User accounts: creates accounts (evidence: `app/Services/AuthService.php`)
- Authentication service → Progression coordinator: creates starter hero (evidence: `app/Services/AuthService.php`)
- API client → Habit API: manages habits
- Habit API → Habit management: delegates operations (evidence: `app/Http/Controllers/Api/HabitController.php`)
- Habit management → Habits: manages records
- API client → Completion API: logs completion
- Completion API → Completion processing: delegates logging (evidence: `app/Http/Controllers/Api/HabitLogController.php`)
- Completion processing → Progression coordinator: awards progression
- Completion processing → Completion logs: records completion
- Completion processing → Habits: updates habit
- API client → Reminder API: configures reminders
- Reminder API → Reminder management: delegates operations (evidence: `app/Http/Controllers/Api/HabitReminderController.php`)
- Reminder management → Reminders: manages reminders
- Progression coordinator → XP calculation: calculates XP (evidence: `app/Services/GamificationService.php`)
- Progression coordinator → Level-up rules: processes levels (evidence: `app/Services/GamificationService.php`)
- Progression coordinator → User hero progress: updates progress (evidence: `app/Services/GamificationService.php`)
- Progression coordinator → Hero templates: finds starter (evidence: `app/Services/GamificationService.php`)
- API client → Hero catalog API: browses heroes
- API client → User hero API: manages heroes
- API client → Achievement API: checks achievements
- API client → Analytics API: requests analytics
- Service and repository bindings → Authentication service: binds service (evidence: `app/Providers/AppServiceProvider.php`)
- Service and repository bindings → Progression coordinator: binds service (evidence: `app/Providers/AppServiceProvider.php`)
- Service and repository bindings → Habit management: binds service (evidence: `app/Providers/AppServiceProvider.php`)
- Service and repository bindings → Completion processing: binds service (evidence: `app/Providers/AppServiceProvider.php`)
- Service and repository bindings → Reminder management: binds service (evidence: `app/Providers/AppServiceProvider.php`)
- Service and repository bindings → Hero management: binds service (evidence: `app/Providers/AppServiceProvider.php`)
- Service and repository bindings → User hero management: binds service (evidence: `app/Providers/AppServiceProvider.php`)
- Service and repository bindings → Achievement engine: binds service (evidence: `app/Providers/AppServiceProvider.php`)
- Service and repository bindings → User analytics: binds service (evidence: `app/Providers/AppServiceProvider.php`)
