# waiguan

**Repository Path**: zkak/waiguan

## Basic Information

- **Project Name**: waiguan
- **Description**: 新智慧外管项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-27
- **Last Updated**: 2026-11-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 新智慧外管

全新应用工程，采用官方芋道 Boot 精简版＋Vue3，复用 system/infra。汇智助手仅通过应用 Java BFF → M01公开API → M03 → 私有DeerFlow；不直连 Provider。

本仓为一期开发成果，已有分项部署与真实登录/助手读取证据，详见[Keycloak实施记录](docs/implementation/keycloak-sso-20261028.md)；后继统一权限BFF28482/HTTPS28483候选已运行，真实普通用户助手链及B02原操作恢复已有分项实证；最终前端候选`fc431bd`已精确装载HTTPS28483；旧会话只读检查曾返回401并转到`/login`，自动refresh在发出前已拦截，原失败保留。后继中央新登录33兑换200，普通用户13031；新会话Chromium只读UI34通过，权限、偏好、字典、session及未读通知五项GET均200，页面脚本异常0，业务写0。回执为树外`edge-candidate-01/browser-ui-34/receipt.private.json`；新前端与B02完整写入及unknown组合仍待验；整期和平台联合业务验收尚未通过。B02只读恢复与三个waiguan受众隔离profile已批准，登记依据见[现行认证契约](/media/user/数据盘/agent-platform/docs/contracts/independent-service-auth-v2.md)和整体设计§8.1。当前统一权限目标与唯一交接见[整体设计](/media/user/数据盘/agent-platform/docs/superpowers/specs/2026-10-28-unified-permissions-design.md)及[实施记录](/media/user/数据盘/agent-platform/docs/development-notes/unified-permissions-implementation-20261028.md)，应用分项见[实施状态](docs/implementation/phase1-status.md)。原正式入口失败/回滚、历史部署和未验范围各按原记录保留。缺少能力时明确不可用，不以静态页面或夹具替代。

## 源码与构建

固定上游 SHA、许可证和原始包摘要见 [upstream-lock.json](upstream-lock.json)；原工程许可证保留在 backend、frontend。后端要求 Java17/Maven3.9，前端使用 Node26.7、pnpm10.15.1 验证。

```bash
mvn -f backend/pom.xml -B -ntp verify
cd frontend
cp .env.example .env
pnpm install --frozen-lockfile
pnpm build:prod
node --test tests/waiguan/*.test.mjs
```

`.env`只留本地，不提交凭据。前端活动入口类型检查与全仓类型检查结论分开记录；全仓曾退出137，不能视为通过。

## 隔离运行与身份登记

后端默认使用 `waiguan` profile，仅本机绑定；MySQL/Redis须使用私有环境变量，不能加载旧共享配置。应用自有容器、端口、SQL迁移、启动步骤见[隔离运行](docs/development/isolated-runtime.md)。SQL依次审阅应用001—006，已应用版本不得修改后重放。

本部署固定Keycloak issuer，登记客户端、PKCE回调及受控scope/mapper；BFF在Keycloak标准token exchange取得单M03目标票，经M01精确助手入口原票透传。普通M01 API的aud独立；BFF初始票可能多aud，不代签所有工程/API迁移。M01按完整APISIX部署，不预设新增SQL业务库；Keycloak、BFF及M03按各自Provider使用独立最小账号与适用存储，BFF隔离MySQL与M03原生PG保留。详见[本轮修订](/media/user/数据盘/agent-platform/docs/development-notes/keycloak-gateway-sso-20261028.md)，可信首次绑定与既有绑定的新部署管理guard初始化分别按[身份合同](docs/contracts/auth-bff.md)处理，SS03工程私有新契约实施中，不据原Runner推导已支持当前初始化。平台令牌和加密密钥只存在受保护服务端配置；没有原生密码登录旁路。

本机HTTP验证驱动 `tools/dev/application-http.py` 使用**显式合成M01边界**与真实应用/数据库；只用于应用合同验证，不代表CAS或底座实链通过。真实底座固定制品需求见[M01交接](docs/development/m01-isolated-integration.md)。

## 功能与迁移

- [一期方案与文档导航](docs/README.md)
- [固定DeerFlow操作盘点](docs/contracts/deerflow-inventory.md)
- [助手公开消费合同](docs/contracts/assistant-bff.md)
- [旧用户/机构迁移](docs/migration/README.md)

正式迁移须受审身份映射和原生权限映射，不复制旧密码/令牌，不按姓名合并或自动授超级管理员。原始失败、分轮命令与退出码留在被忽略的私有runtime；版本化交付记录只收脱敏结论与摘要。