tiku-saas-web/README.md

Tiku SaaS Web

租户建站与学生端前端。项目是单应用双 Shell：学生端使用 Tailwind CSS，租户后台使用 Ant Design。当前版本优先完成一次性 Owner 激活、建站引导、主题和首页模块配置、预览与发布闭环。

开发

要求 Node.js 24+ 与 npm 11+。

npm install
npm run dev

默认访问 http://localhost:5180/__demo，创建或重置租户并复制一次性激活链接。Mock 数据按开发模拟 Host 保存在浏览器 localStorage，刷新页面不会丢失。

npm test
npm run check:production

数据模式

复制 .env.example 为 .env.local：

VITE_DATA_MODE=mock
VITE_API_BASE_URL=

• mock：仅 Development 动态加载 MSW；生产构建不会包含 Worker、启动器、示例 Token 或 Mock 状态。
• api：使用同源 /api，也可在开发期通过 VITE_API_BASE_URL 代理到 .NET API。

页面只能调用 src/api 下的领域 Client，不能直接调用 fetch。前端请求不携带任意 tenantId；真实租户由 Host 与受保护 Session 决定。

路由和权限

路由	行为
/	学生端；根据 Runtime 的站点状态显示内容、筹备、暂停或域名接入页面
/activate/:activationId#token=...	一次性 Owner 激活；Token 读入后立即从地址栏移除
/manage/login	租户后台登录
/manage/*	必须通过租户 Backoffice Bootstrap；无 Permission 的账号统一显示 404
/__demo	仅开发环境存在的生命周期启动器

后台菜单来自 GET /api/backoffice/tenant/bootstrap。进入站点设计还必须包含 tenant:settings:manage，前端隐藏菜单不能替代后端 401/403。

前后端契约

当前前端 Facade 对齐以下接口：

• GET /api/runtime/bootstrap
• POST /api/browser-auth/activation/complete
• POST /api/browser-auth/login/password
• GET /api/backoffice/tenant/bootstrap
• GET /api/tenant-onboarding/status
• GET|PUT|POST /api/tenant-admin/frontend-config/**

后端目前已有 /api/auth/activation/complete，但只返回 204。目标 Browser Auth 激活接口需要在完成密码设置后签发 HttpOnly Session Cookie，并返回当前用户摘要，前端才能安全地自动进入建站向导。

与旧系统的边界

旧 tiki-web 仅作为学生业务页面、响应式布局和交互体验的功能参考。本仓库不得引入 PocketBase、MockBackend、tenant.config.ts，也不得在浏览器保存支付、短信或对象存储 Secret。Logo 的本地 Data URL 仅用于当前前端原型；真实接入时改为后端签发的上传凭证或预签名 URL。