# 病媒智慧防治小程序

**Repository Path**: GuangMingDesign/svcs_wx

## Basic Information

- **Project Name**: 病媒智慧防治小程序
- **Description**: 病媒智慧防治小程序
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-28
- **Last Updated**: 2026-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SVCS 小程序

基于 Uni-app X、UTS、UVUE 和蒸汽模式的消杀任务移动业务端。项目使用原生页面路由，不再由单个 `index.uvue` 条件渲染全部业务。

## 当前结构

```text
svcs_wx/
├── App.uvue                    # 应用壳和全局样式入口
├── main.uts                    # 应用创建入口
├── pages.json                  # 27 个原生页面路由
├── pages/                      # 每个页面一个 .uvue 文件
├── components/                 # 页面外壳、标题栏、底部导航和业务弹窗
├── stores/                     # 响应式业务状态
├── lifecycle/                  # 页面进入和应用启动编排
├── router/                     # 页面名与原生路由映射
├── domain/                     # 认证、导航、任务、执行、审核和管理逻辑
├── network/                    # JSON 请求、鉴权和幂等处理
├── api/                        # API 兼容门面及文件上传下载
├── storage/                    # 登录会话和任务上下文持久化
├── config/                     # 环境配置
├── types/                      # UTS 业务类型
└── styles/                     # 全局业务样式
```

完整的职责边界、路由表和新增页面规则见 [ARCHITECTURE.md](./ARCHITECTURE.md)。

## 开发配置

1. 使用 HBuilderX 5.15 或更新版本打开当前目录。
2. 在 `manifest.json` 的 `mp-weixin.appid` 填写正式微信小程序 AppID。
3. 后端 `WX_MINIAPP_APPID`、`WX_MINIAPP_SECRET` 必须使用同一套微信凭据。
4. 默认 API 为 `https://svcs.greendeertech.cn/svcs-api/api/v1/miniapp`。本地调试可设置存储键 `svcs_api_base`，值必须为 HTTPS 且包含 `/api/v1/miniapp`。
5. 微信公众平台需配置 request、uploadFile 和 downloadFile 合法域名。

## 本地发行验证

```powershell
& 'E:\Install\HBuilderX\cli.exe' publish mp-weixin `
  --project 'E:\Code\Java\xiaosha\src\svcs_wx' `
  --upload false `
  --sourceMap false
```

输出目录为 `unpackage/dist/build/mp-weixin`。该命令只生成本地产物，不上传微信平台。

## 约束

- 页面必须在 `pages/` 中独立建档并登记到 `pages.json`。
- 页面只负责展示和交互绑定，业务请求写入对应 `domain/` 模块。
- `uni.request` 只能出现在 `network/`，上传和下载只能出现在 `api/files.uts`。
- 路由调用只能通过 `router/routes.uts`，业务代码通过 `domain/navigation.uts` 导航。
- 本地存储只能通过 `storage/` 或 `config/environment.uts` 的封装访问。
- 可复用界面进入 `components/`，不得把整页模板复制回共享组件。