# TP-EMS (天普大兴园区) Development Guidelines

## Overview
Customer project for Tianpu Daxing Zero-Carbon Park. Uses ems-core via git subtree in `core/`.

## CRITICAL: Do NOT modify core/ directly
The `core/` directory is a git subtree from ems-core. All core changes must be made in the ems-core repository first, then pulled via:
```
git subtree pull --prefix=core ems-core main --squash
```

## Project Structure
- `core/` — git subtree from ems-core (READ-ONLY in this repo)
- `customers/tianpu/` — Customer configuration (config.yaml, devices.json, pricing.json, hooks/)
- `scripts/` — Seeding and admin tools
- `docker-compose.override.yml` — Customer-specific Docker overrides

## Commit Conventions
- Follow Conventional Commits: `<type>(<scope>): <description>`
- Scopes: config, docker, dashboard, monitoring, alarm, hooks

## Deployment
```bash
cp .env.example .env  # Edit settings
docker compose -f core/docker-compose.yml -f docker-compose.override.yml up -d
docker compose -f core/docker-compose.yml -f docker-compose.override.yml exec backend python scripts/seed_data.py
```

## Default Login
- admin / admin123