# shroom_admin

**Repository Path**: yimio/shroom_admin

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-20
- **Last Updated**: 2026-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Shroom 后台

Shroom（菇日记）生产后台源码库，包含后台 API、数据库迁移、测试、运维脚本和管理控制台。

## 仓库边界

- `server/`：Node.js API、领域服务、数据库迁移、测试与部署定义。
- `public/admin/`：`shroom.evox.run/admin` 管理控制台静态页面。
- 不包含用户端 H5/小程序源码、用户上传内容、生产数据库、日志、真实环境变量或密钥。
- 生产运行目录 `/www/wwwroot/shroom` 不是源码真源；所有持续变更应先进入本仓库。

## 本地验证

需要 Node.js 20+ 与测试环境配置：

```bash
cd server
npm ci
npm test
node --check src/server.js
node --check ../public/admin/admin.js
```

完整测试基线当前包含部分依赖未部署前端源码的既有失败；任何变更都必须同时运行目标测试，并证明没有增加失败集合。

## 发布原则

1. 从明确 commit 生成唯一 release；
2. 写入 `/var/lib/qoderwake/handoffs/pending/<release-id>/`；
3. 附文件清单、SHA-256、测试、部署、健康检查与回滚说明；
4. 由受控发布器执行写前备份、路径白名单、部署、服务重启和失败回滚；
5. 禁止提交 `.env`、token、密码、Cookie、私钥、生产数据、上传文件或数据库备份。

生产入口：`https://shroom.evox.run`

管理后台：`https://shroom.evox.run/admin/`