weather-data/CLAUDE.md

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Subdirectories have their own `CLAUDE.md` with module-specific details — see:
- `system-admin/CLAUDE.md` — backend build, patterns, conventions, weather domain
- `system-common/CLAUDE.md` — shared base classes, i18n
- `weather-data-ui/CLAUDE.md` — frontend stack, patterns, critical rules

---

## Project overview

**weather-data** is a full-stack meteorological data analysis platform: Java 17 / Spring Boot 3.5 multi-module backend + Vue 3 / Vite 5 / TypeScript frontend. Forked from [renren-security](https://gitee.com/renrenio/renren-security).

```
weather-data/
├── system-common/            → shared Java lib
├── system-admin/             → admin backend (port 8080, /system-admin)
├── system-dynamic-datasource → multi-DS routing via @DataSource annotation + AOP
├── renren-generator/         → code generator (commented out of build)
└── weather-data-ui/          → Vue 3 SPA frontend
```

**Database**: `weather_data_system` (MySQL). Init from `system-admin/db/weather_data_system.sql` (includes schema + seed data). Default admin: `admin` / `admin` (BCrypt-encoded). Key custom tables: `weather_daily_data`, `weather_station`, `weather_file_scan_record`. No Flyway/Liquibase — all schema changes are manual SQL.

### Port & context path reference

| Service | Port | Context Path | App Class |
|---|---|---|---|
| Admin | 8080 | `/system-admin` | `AdminApplication` |
| Frontend (dev) | 8001 | `/` | Vite dev server |
| Frontend (prod) | 80 | `/` | Nginx via gateway |

---

## Code Style

- **No emoji in UI strings.** Plain Chinese text for labels, buttons, status. Functional Unicode symbols are allowed and used: status dots `●`/`○`, checkmark `✓`, and box-drawing chars (`╔ ═ ╗ ━`) in log banners.
- **No emoji in code comments or docstrings.** Plain text only.
- **Keep CLAUDE.md current** — whenever code is modified, added, deleted, or any file change affects the project structure, build process, architecture, or conventions, update the relevant `CLAUDE.md` in the same commit to reflect the new state. This file and its children are the source of truth for both humans and Claude; stale documentation is a bug.

---

## Docker deployment

Five services in `docker-compose.yml`: mysql (8.0), redis (7 Alpine + AOF), admin JAR, UI (Nginx + built frontend), gateway (Nginx reverse proxy on port 80). The `api` service definition still references the deleted `system-api` module — remove it before deploying.

**Important**: The `deploy/` directory referenced by Docker Compose (`deploy/mysql/init/`, `deploy/nginx/`) **does not exist locally** — it must be created for deployment.

Environment variables from `.env` at project root. Two frontend Dockerfiles: standard multi-stage (`Dockerfile`) and pre-built (`Dockerfile.offline`).

## Repository notes

- `README.md` does not contain substantive guidance — this file is the primary operational reference.
- No CI configuration exists. Only pre-commit is frontend lint-staged via yarn git hooks.
- `renren-generator` module exists but is commented out of the root POM build.
- `system-dynamic-datasource` provides `@DataSource` annotation-driven multi-DS routing; the slave DS config in `application-dev.yml` is commented out.
- `.gitignore` excludes `.idea/` but `.idea/` is tracked (committed IDE config; `.idea/.gitignore` only excludes local files like `workspace.xml`).