# Addresses Module

## Overview
Address resources capture shipping and billing locations saved by customers. The module currently exposes schema metadata to help clients generate forms and admin UIs.

## Endpoints
- `GET /addresses/schema` — returns column metadata for the `addresses` table. No authentication is enforced by default.

## Data Model
- **Address**
  - `id` (auto-increment integer primary key)
  - `userId` (nullable integer FK to `users.id`)
  - Contact info: `label`, `fullName`, `phone`, `addressLine1`, `addressLine2`, `city`, `state`, `postalCode`, `country`
  - Flags: `isDefaultShipping`, `isDefaultBilling`
  - Audit fields: `createdAt`, `updatedAt`

## Notes
- IDs have been migrated to integers to align with the rest of the platform.
- When persisting addresses from other services, ensure the owning `userId` exists and is active.