NFarms 前端平台文档（docs）¶
NFarms 前端由 8 个独立静态站点组成，托管于
nfarms/目录， 各站点一份平台级说明，位于本目录（与站点一一对应）。
平台地图¶
| 站点 | 目录 | 域名规划 | 平台定位 | 文档 |
|---|---|---|---|---|
| 门户 | index/ |
index.nfarms.cn | 山水田园 · 智慧农业平台（首页门户） | index.md |
| 运维控制台 | console/ |
console.nfarms.cn | 综合运维管控平台（命令/监控/零信任/商城） | console.md |
| 物联网平台 | online/ |
online.nfarms.cn | 智慧物联网管理平台（端-边-云协同） | online.md |
| 商城平台 | store/ |
store.nfarms.cn | 智慧双端商城平台（Web + 微信小程序） | store.md |
| 资源中心 | hub/ |
hub.nfarms.cn | NFarmsHUB 资源聚合平台（脚本/软件/媒体） | hub.md |
| 模型平台 | zerolink/ |
zerolink.nfarms.cn | MCP 模型上下文协议管理平台（原 mcp，含公开对时 /time） | zerolink.md |
| 工具平台 | tools/ |
tools.nfarms.cn | 在线工具平台（ITtools/Bili 等） | tools.md |
| 内容页 | pages/ |
（子页直接访问） | 静态内容页合集（kimi 子站等） | pages.md |
统一架构约定¶
- 技术栈：纯静态 SPA —— vanilla JavaScript + localStorage，无构建工具、无框架依赖；
各站点
index.html按顺序加载js/config.js → auth.js → api.js → store.js → ui.js → charts.js → app.js → js/pages/*。 - 后端接入：统一经
js/api.js调用 nfarmsd（默认http://127.0.0.1:9600）， 注入身份头X-User-ID/X-User-Roles（与 nfarmsd 网关注入模型一致）； 本地联调需 nfarmsd 开启cors_enabled=true，生产建议 Nginx 反代/api/并注入真实网关身份头。 - 账号体系：各平台演示账号角色与 nfarmsd 角色一致（admin/devops/service/auditor 等），
演示密码均为
123456；跨平台账号主数据见 online 平台 SSO 账号中心。 - 本地存储：各平台使用独立 localStorage 前缀（
nf.*/nfarms.*/nfhub.*等）存放业务数据与种子数据。
统一部署（服务器）¶
前端根：/opt/Cy/NFarms （8 站点平铺于该目录）
资源目录：/opt/Cy/NFarms/hub （hub 资源库 media/package 等）
Nginx：/opt/Cy/services/nginx.d/nfarms-site.conf
root /opt/Cy/NFarms;
location /api/ -> 反代 127.0.0.1:9600（nfarmsd api 模块）
location /vpn/ws -> 反代 127.0.0.1:9994（nfarmsd gateway 模块）
部署脚本见仓库 scripts/deploy/（20-frontend.sh 将 nfarms/ 全量同步到 /opt/Cy/NFarms）。