如何写好一篇技术方案

简介: 本文档为项目需求说明模板,涵盖背景目标、功能模块、流程图、UML设计、API与数据库设计等内容,支持表格、思维导图、时序图等多种视图,便于团队协作与排期管理,提升产研效率。

变更记录
记录每次修订的内容,方便追溯。
表格视图
项目背景
对本次项目的背景以及目标进行描述,方便开发者理解需求,对齐上下文。
知识库基础能力的升级,解决以下问题:
目录与文档管理分布在不同的页面,用户无法区分两者区别。
目录拖拽体验不够流畅,交互细节体验不佳。
相关资料
PRD、设计稿等相关资料,可以通过插入“语雀内容”卡片快速引入关联的语雀文档
也可以通过“本地文件”、“附件”上传其他资料。

📑 产品需求文档
变更记录记录每次修订的内容,方便追溯。版本号作者修订内容发布日期1.1...去除需求 1.0,增加需求 3.02022-01-301.0...发布 prd 1.0 需求宣讲2021-12-311. 背景介绍1.1 业务背景对本次项目的背景以及目标进行描述,让产研团队了解本需求的价值和收益。1....
官方模板(新)
参与人
项目负责人
...
产品经理
...
设计师
...
工程师
...
功能模块
通过插入“思维图”卡片、“表格”卡片,描述本项目涉及到的功能与场景。
子功能二
子功能一
功能二
子功能三
场景二
场景一
子功能一
子功能二
功能一
产品功能
流程图
通过“流程图”卡片对系统流程进行梳理。
成员
决策者
项目经理
开始
提出想法

验证可行性
项目方案
风险评估



审批
通过
方案设计
审批

通过
项目预算

项目计划

结束
不通过
不通过

UML 图
通过“UML 图”卡片可以绘制类图、组件图等系统架构图,梳理系统架构。
<>
Shape

  • draw()
  • erase()
  • move()
  • resize()
    <>
    Circle
  • radius:float
  • center:unsigned int
  • area(in radius:float) + circum()
  • setCenter()
  • setRadius()

    <>
    Retangle

    <>
    Point

    <>
    Frame
    <>
    Window
  • open()
  • close()
  • move()
  • display()
  • handleEvent()
    <>
    Event
    <>
    ConsoleWindow
    <>
    DialogBox
    <>
    DataController

    <>
    DrawingContext
  • open()
  • close()
  • move()
  • display()
  • handleEvent()
    Note







    时序图
    通过“UML 图”卡片可以绘制时序图来梳理系统调用时序。




    alt
    : Search Page
    : Search Results Page
    : Customer
    : Catalog
    : Search Results



1: onSearch(author)
1.1: validateSearchCriteria()

1.2 : searchByAuthor(author)

1.2.1: create()


1.2.1.1 : display()
1.3: displayErrorMessage()


[author not entered]
数据库设计
API 设计
可以借鉴华为API:

查询产品_产品管理API应用侧API参考API参考设备接入 IoTDA-华为云
获取单篇文档
Plain Text
复制代码
1
GET /docs/:id?raw=0
请求参数
参数
类型
描述
id
Integer
文档 id
raw
Boolean
raw=1 返回文档最原始的格式
响应格式

{
"data": {
"id": 100,
"title": "标题",
"description": "描述",
"body": "文档正文内容",
"body_draft": "文档草稿内容",
"status": 0
}
}
排期
通过“日历卡片”或者“思维图”卡片的时间轴视图,对研发时间计划进行排期。

发布阶段
更新帮助文档
全量发布
12.15
灰度引流
12.10
编写帮助手册
内部验收
11.30
整体提测
11.15
服务端提测
10.30
服务端系分
前端系分
10.15
里程碑
前后端联调

需要完成自测

相关文章
|
13天前
|
数据采集 人工智能 安全
|
8天前
|
编解码 人工智能 自然语言处理
⚽阿里云百炼通义万相 2.6 视频生成玩法手册
通义万相Wan 2.6是全球首个支持角色扮演的AI视频生成模型,可基于参考视频形象与音色生成多角色合拍、多镜头叙事的15秒长视频,实现声画同步、智能分镜,适用于影视创作、营销展示等场景。
631 4
|
8天前
|
机器学习/深度学习 人工智能 前端开发
构建AI智能体:七十、小树成林,聚沙成塔:随机森林与大模型的协同进化
随机森林是一种基于决策树的集成学习算法,通过构建多棵决策树并结合它们的预测结果来提高准确性和稳定性。其核心思想包括两个随机性:Bootstrap采样(每棵树使用不同的训练子集)和特征随机选择(每棵树分裂时只考虑部分特征)。这种方法能有效处理大规模高维数据,避免过拟合,并评估特征重要性。随机森林的超参数如树的数量、最大深度等可通过网格搜索优化。该算法兼具强大预测能力和工程化优势,是机器学习中的常用基础模型。
348 164
|
7天前
|
机器学习/深度学习 自然语言处理 机器人
阿里云百炼大模型赋能|打造企业级电话智能体与智能呼叫中心完整方案
畅信达基于阿里云百炼大模型推出MVB2000V5智能呼叫中心方案,融合LLM与MRCP+WebSocket技术,实现语音识别率超95%、低延迟交互。通过电话智能体与座席助手协同,自动化处理80%咨询,降本增效显著,适配金融、电商、医疗等多行业场景。
358 155