如何写好一篇技术方案

简介: 本模板规范产品需求文档,涵盖项目背景、变更记录、功能模块、流程图、UML及时序图等核心内容,支持语雀卡片与附件,提升团队协作效率,确保产研上下文对齐。

变更记录
记录每次修订的内容,方便追溯。
表格视图
项目背景
对本次项目的背景以及目标进行描述,方便开发者理解需求,对齐上下文。
知识库基础能力的升级,解决以下问题:
目录与文档管理分布在不同的页面,用户无法区分两者区别。
目录拖拽体验不够流畅,交互细节体验不佳。
相关资料
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 返回文档最原始的格式
响应格式
JSON
复制代码
1
2
3
4
5
6
7
8
9
10
{
"data": {
"id": 100,
"title": "标题",
"description": "描述",
"body": "文档正文内容",
"body_draft": "文档草稿内容",
"status": 0
}
}
排期
通过“日历卡片”或者“思维图”卡片的时间轴视图,对研发时间计划进行排期。

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

需要完成自测

相关文章
|
2天前
|
数据采集 人工智能 安全
|
11天前
|
云安全 监控 安全
|
3天前
|
自然语言处理 API
万相 Wan2.6 全新升级发布!人人都能当导演的时代来了
通义万相2.6全新升级,支持文生图、图生视频、文生视频,打造电影级创作体验。智能分镜、角色扮演、音画同步,让创意一键成片,大众也能轻松制作高质量短视频。
999 151
|
3天前
|
编解码 人工智能 机器人
通义万相2.6,模型使用指南
智能分镜 | 多镜头叙事 | 支持15秒视频生成 | 高品质声音生成 | 多人稳定对话
|
16天前
|
机器学习/深度学习 人工智能 自然语言处理
Z-Image:冲击体验上限的下一代图像生成模型
通义实验室推出全新文生图模型Z-Image,以6B参数实现“快、稳、轻、准”突破。Turbo版本仅需8步亚秒级生成,支持16GB显存设备,中英双语理解与文字渲染尤为出色,真实感和美学表现媲美国际顶尖模型,被誉为“最值得关注的开源生图模型之一”。
1695 9
|
8天前
|
人工智能 自然语言处理 API
一句话生成拓扑图!AI+Draw.io 封神开源组合,工具让你的效率爆炸
一句话生成拓扑图!next-ai-draw-io 结合 AI 与 Draw.io,通过自然语言秒出架构图,支持私有部署、免费大模型接口,彻底解放生产力,绘图效率直接爆炸。
640 152
|
10天前
|
人工智能 安全 前端开发
AgentScope Java v1.0 发布,让 Java 开发者轻松构建企业级 Agentic 应用
AgentScope 重磅发布 Java 版本,拥抱企业开发主流技术栈。
609 14
|
9天前
|
人工智能 自然语言处理 API
Next AI Draw.io:当AI遇见Draw.io图表绘制
Next AI Draw.io 是一款融合AI与图表绘制的开源工具,基于Next.js实现,支持自然语言生成架构图、流程图等专业图表。集成多款主流大模型,提供智能绘图、图像识别优化、版本管理等功能,部署简单,安全可控,助力技术文档与系统设计高效创作。
684 151