# cems

**Repository Path**: zzsvip/cems

## Basic Information

- **Project Name**: cems
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-27
- **Last Updated**: 2026-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CEMS · 组件环境管理系统

面向团队内部的"系统资产 + 部署环境 + 访问入口"统一登记与查询平台。

- 技术栈：Spring Boot 3 + MyBatis-Plus + PostgreSQL（后端）/ Vue3 + TS + Vite + Element Plus（前端）
- 设计文档：见 [`docs/`](docs/)
- 开发进度（单一事实来源）：见 [`docs/开发进度.md`](docs/开发进度.md)

## 快速启动（全容器化）

前置：已安装 Docker 与 Docker Compose。

```bash
cd deploy
cp .env.example .env        # 然后编辑 .env，至少设置 POSTGRES_PASSWORD 和 JWT_SECRET
docker compose up -d --build
```

- 浏览器访问：`http://localhost`（如改了 `HTTP_PORT` 则用对应端口）
- 后端健康检查：容器内 `http://backend:8080/api/v1/actuator/health`
- 初始管理员（阶段 1 起生效）：`.env` 中的 `ADMIN_USERNAME` / `ADMIN_INIT_PASSWORD`

停止与清理：

```bash
docker compose down          # 停止
docker compose down -v       # 停止并删除数据库数据卷
```

## 本地开发（可选）

```bash
# 后端（需 JDK 21）
cd backend && mvn spring-boot:run
# 前端（需 Node 20），自动代理 /api 到 localhost:8080
cd frontend && npm install && npm run dev
```

## 分阶段交付

本项目按模块分阶段交付，每阶段完成后由你 `docker compose up` 启动并逐页验收。
当前阶段与待办见 [`docs/开发进度.md`](docs/开发进度.md)。