# subscriptions/

## Files

| File | What | When to read |
| ---- | ---- | ------------ |
| `README.md` | Feature overview, API endpoints, configuration | Understanding subscription flow |

## Subdirectories

| Directory | What | When to read |
| --------- | ---- | ------------ |
| `api/` | HTTP controllers and routes | API endpoint changes |
| `domain/` | Services and type definitions | Business logic changes |
| `data/` | Repository for database operations | Database queries |
| `external/` | Stripe API client wrapper | Stripe integration |
| `migrations/` | Database schema | Schema changes |
| `jobs/` | Scheduled background jobs | Grace period processing |
| `tests/` | Unit and integration tests | Adding or modifying tests |
