语言技术
TypeScript系统类型
小程序轻应用行业分类
内容平台
### 1. 立项原因（解决的产品问题）
调研发现，市场上不存在将五险一金、劳动合同、租房购房、税务、保险、职场权益整合在一起的「一站式社会常识指南」：现有产品多为孤立的**单点工具**（如五险一金计算器、社保查询），缺乏系统性；而相关政策法规又晦涩难懂、网上信息碎片化且准确度参差。本项目旨在填补这一空白，把走出校园后「必须知道却没人教」的硬性常识，翻译成系统、通俗的图文指南，并配套计算工具、政策查询与 AI 答疑，帮助应届生一站式补齐盲区、少踩坑。
### 2. 行业场景与业务背景
每年数百万应届毕业生集中步入职场，签第一份劳动合同、交第一次社保、算第一笔个税、租第一套房、处理第一次劳动纠纷等高频刚需场景中，普遍缺乏顺手的常识工具；且这一需求随毕业季**每年周期性复现、永不过时**。目标用户为权益意识渐强但相关知识薄弱的年轻职场人，微信小程序「即用即走、易于社交分享」的特性天然契合这种轻量、场景化的诉求；而政策类内容（如个税新标准、各地毕业生补贴政策）也要求产品具备持续更新的能力。
### 1. 功能模块
- **首页导览**：5 大分类（入职必看 / 薪资税务 / 社保公积金 / 权益保护 / 生活常识）卡片入口，配「每日常识」按天轮换的法律条款。
- **图文指南**：分类详情页按类型（工具 / 卡片 / 清单 / 文章）分组；文章列表支持子分类标签筛选、下拉刷新与分页，详情页富文本渲染并统计浏览量。
- **实用工具**（3 个）：个税计算器（7 级累进 + 专项附加扣除）、五险一金指南（6 险种、比例可编辑实时重算）、毕业生补贴查询（5 城 × 5 类政策，云端数据 + 官方申报链接）。
- **知识库**（9 页）：试用期、薪资常识、医保、公积金、离职补偿、维权仲裁、租房、信用贷款、离职清单。
- **AI 问答助手**：基于智谱 GLM 的职场常识答疑，支持多轮上下文记忆与会话历史。
- **关于 / 协议**：版本与联系方式、《隐私政策》《用户协议》双 Tab。
### 2. 主要功能描述
围绕应届生从校园步入社会的常识盲区，产品以「图文指南 + 实用工具 + 政策查询 + AI 答疑」四位一体组织内容：用户在首页按场景进入分类，阅读劳动合同、五险一金、租房维权等结构化文章，用计算器即时估算收入，查询所在城市的毕业生补贴政策，遇到具体问题可向 AI 助手提问获得结合中国现行政策的通俗解答，形成「学—算—查—问」的闭环。
### 1. 我负责的工作（独立完成全栈开发）
- **小程序前端**：全部页面（主包 5 页 + 3 个分包共 15 页）、9 个自研组件、设计令牌样式系统的开发。
- **云开发后端**：7 个云函数、5 个云数据库集合设计、AI 集成与多重安全护栏、数据种子脚本均独立实现。
### 2. 技术栈
- 微信原生小程序 + TypeScript（strict 模式）；微信云开发（云函数 / 云数据库 / 云存储 / 云调用 openapi）；智谱 GLM-4-flash 大模型；无第三方 UI 框架，组件全部自研。
### 3. 架构
`前端 → callCloud 统一封装 → action 分派云函数 → 云数据库`：所有云函数单一入口按 `event.action` 路由到 handler 并返回 `{code,data,message}` 统一信封；集中式配置文件作为分类 / 标签 / 城市等数据的单一数据源；样式由全局 CSS 变量驱动。
### 4. 亮点与难点
- **AI 工程化护栏**：输入校验 → 双向内容安全检测（故障降级放行，避免单点故障）→ 双层频次限制（分钟 / 日，原子占位 + 失败回滚保证额度精确）→ GLM 调用 → 输出安全检测 → 历史裁剪存储，错误细节不透传前端。
- **成本与增长控制**：频次统计表 30 天定时清理、GLM 失败回滚额度、单会话历史封顶 40 条。
- **越权防护**：AI 会话按 openId 校验归属，越权访问不泄露会话存在性。
- **文章分类隔离**：标签栏可见项与查询参数双重约束，防止文章跨分类泄露。
- **自定义导航栏**：动态适配异形屏状态栏，并处理分享冷启动直接进入详情页时的「返回首页」逃生口。
- **分包与性能**：按入口预加载分包 + 按需注入缩小主包；AI 对话用局部路
评论