76 lines
1.9 KiB
Markdown
76 lines
1.9 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code and similar agents when working in this repository.
|
|
|
|
## Session Startup
|
|
|
|
Read these files in order before planning, coding, reviewing, or deploying:
|
|
|
|
1. `memory.md`
|
|
2. `docs/architecture.md`
|
|
3. `docs/api-reference.md`
|
|
4. `AGENTS.md`
|
|
|
|
Use `docs/agents/handoff.md` only as supplemental background when the primary docs are not enough.
|
|
|
|
## Project Overview
|
|
|
|
`yoyuzh.xyz` is a full-stack personal site focused on:
|
|
|
|
- account/auth flows
|
|
- personal cloud drive
|
|
- quick transfer
|
|
- admin console
|
|
- Capacitor Android shell
|
|
|
|
## Commands
|
|
|
|
Do not run frontend business commands from the repository root.
|
|
|
|
### Frontend (`cd front`)
|
|
|
|
```bash
|
|
npm run dev
|
|
npm run build
|
|
npm run preview
|
|
npm run clean
|
|
npm run lint
|
|
npm run test
|
|
```
|
|
|
|
### Backend (`cd backend`)
|
|
|
|
```bash
|
|
mvn spring-boot:run
|
|
mvn spring-boot:run -Dspring-boot.run.profiles=dev
|
|
mvn test
|
|
mvn package
|
|
```
|
|
|
|
There is no dedicated backend lint or typecheck command.
|
|
|
|
### Deploy
|
|
|
|
```bash
|
|
node scripts/deploy-front-oss.mjs
|
|
node scripts/deploy-front-oss.mjs --dry-run
|
|
node scripts/deploy-front-oss.mjs --skip-build
|
|
node scripts/deploy-android-apk.mjs
|
|
node scripts/deploy-android-release.mjs
|
|
```
|
|
|
|
The deploy scripts now prefer the repository root `.env` file and keep `.env.oss.local` only as a legacy fallback.
|
|
|
|
## Repo Conventions
|
|
|
|
- Root `.env` is the shared local secrets and deploy-config entrypoint.
|
|
- `.env.example` is the template.
|
|
- `memory.md` is the main continuity file.
|
|
- `docs/agents/` stores only the supplemental handoff doc; `CLAUDE.md` itself stays at the repository root.
|
|
|
|
## Known Constraints
|
|
|
|
- Frontend production still hardcodes `https://api.yoyuzh.xyz/api` in `front/.env.production`.
|
|
- Vite build chunk warnings do not currently block release.
|
|
- Backend service metadata and SSH-related secrets have been consolidated into root `.env`; do not echo those values in normal responses.
|