# Phase 2 Architecture (Prepared, Not Built)

The codebase is structured to support Phase 2 features without major refactoring.

## Planned Modules

| Module | Integration Point |
|--------|-------------------|
| CV Database Search | `Job` Scout driver → Elasticsearch/Meilisearch; `User.cv_path` indexed |
| Recruiter Tools | New `Recruiter` role; extend employer portal namespace |
| Resume Builder | New `resumes` table; API v1 endpoints |
| AI Matching | `JobMatchingService` consuming Scout + embeddings |
| Subscription Plans | `plans`, `subscriptions` tables; middleware `EnsureSubscribed` |
| Premium Jobs | `is_sponsored` flag exists; extend with billing |
| Interview Scheduling | `interviews` table linked to `applications` |
| Recruitment CRM | `pipelines`, `pipeline_stages` tables; employer module |

## Extension Points

- **API**: `/api/v1/` versioning in `routes/api.php`
- **Localization**: `lang/en.json`, `lang/si.json`, `lang/ta.json`
- **Queues**: Redis-backed; add new job classes in `app/Jobs/`
- **Notifications**: Extend `app/Notifications/`
- **Policies**: Role-based gates in `app/Policies/`
- **Storage**: S3-compatible disk configured in `config/filesystems.php`

## Database Additions (Future Migrations)

```
plans, subscriptions, resumes, interviews, pipelines,
pipeline_stages, recruiter_notes, skill_tags, user_skills
```

## Service Layer Pattern

All new features should follow:

```
Controller → Request → Service → Repository → Model
```