diff --git a/.gitee/ISSUE_TEMPLATE.zh-CN.md b/.gitee/ISSUE_TEMPLATE.zh-CN.md deleted file mode 100644 index f09d98dde9597de75ffcdb237c2b580b8fffa3f9..0000000000000000000000000000000000000000 --- a/.gitee/ISSUE_TEMPLATE.zh-CN.md +++ /dev/null @@ -1,13 +0,0 @@ -### 该问题是怎么引起的？ - - - -### 重现步骤 - - - -### 报错信息 - - - - diff --git a/.gitignore b/.gitignore deleted file mode 100644 index 22c3a2f1b8b5d9339d560ea7c056e2003561b548..0000000000000000000000000000000000000000 --- a/.gitignore +++ /dev/null @@ -1,393 +0,0 @@ -# ============================================ -# 仿飞书应用项目 - Git 忽略文件配置 -# 适用：Vue 3 + Tailwind 前端 + .NET 10 + pgsql 后端 -# 维护：项目组 -# ============================================ - -# ============================================= -# 1. Node.js / 前端工程（pc-web / pc-client / mobile-h5 / mobile-app） -# ============================================= -node_modules/ -dist/ -build/ -.output/ -.cache/ -.parcel-cache/ -.vite/ -.turbo/ -.next/ -.nuxt/ -.svelte-kit/ -coverage/ -.nyc_output/ -*.log -npm-debug.log* -yarn-debug.log* -yarn-error.log* -pnpm-debug.log* -lerna-debug.log* -.pnpm-store/ -.pnp.* -.yarn/* -!.yarn/patches -!.yarn/plugins -!.yarn/releases -!.yarn/sdks -!.yarn/versions - -# 前端打包产物 -*.tsbuildinfo -*.local -.vite-cache/ - -# ============================================= -# 2. .NET 10 / 后端工程 -# ============================================= -bin/ -obj/ -out/ -publish/ -wwwroot/ -*.dll -*.exe -*.pdb -*.user -*.suo -*.userprefs -*.swp -*.tmp -*.cache -.vs/ -[Bb]in/ -[Oo]bj/ -[Dd]ebug/ -[Rr]elease/ -x64/ -x86/ -[Aa][Rr][Mm]/ -[Aa][Rr][Mm]64/ -bld/ -[Ll]og/ -[Ll]ogs/ -TestResults/ -*.coverage -*.coveragexml -coverage.*.xml -*.nupkg -*.snupkg -project.assets.json -project.nuget.cache -project.fragment.csproj.nuget.dgspec.json -project.fragment.csproj.nuget.props -packages/ -*.lock.json -!.nuget/packages - -# EF Core 相关 -*.mdf -*.ldf -*.ndf - -# 发布的可执行文件 -*.deps.json -*.runtimeconfig.json -*.runtimeconfig.dev.json - -# ============================================= -# 3. Uni-app / Taro（移动端 + 微信小程序） -# ============================================= -unpackage/ -.tmp/ -.terser_temp/ -.mini-*/project.config.json - -# 微信开发者工具 / 微信小程序 -miniprogram/ -miniprogram_npm/ -project.private.config.json -project.config.json -.wxae/ -.swan/ - -# Uni-app 编译产物（mp-weixin 输出目录） -unpackage/dist/dev/mp-weixin/ -unpackage/dist/build/mp-weixin/ -unpackage/dist/dev/ -unpackage/dist/build/ - -# 各小程序平台产物 -unpackage/dist/dev/mp-alipay/ -unpackage/dist/dev/mp-baidu/ -unpackage/dist/dev/mp-toutiao/ -unpackage/dist/dev/mp-xhs/ -unpackage/dist/dev/mp-kuaishou/ -unpackage/dist/dev/mp-qq/ -unpackage/dist/dev/mp-jd/ - -# Taro 编译产物 -.taro/ - -# 小程序 IDE 缓存 -.idea/workspace.xml -.vscode/launch.json - - -# ============================================= -# 4. Tauri（PC 客户端） -# ============================================= -src-tauri/target/ -src-tauri/gen/schemas/ -src-tauri/Cargo.lock - -# ============================================= -# 5. Electron（PC 客户端） -# ============================================= -dist_electron/ -release/ -*.app -*.exe -*.dmg -*.deb -*.snap -*.AppImage -*.blockmap -electron-builder-cache/ - -# ============================================= -# 6. 环境变量 / 密钥 / 敏感配置（绝对不能提交） -# ============================================= -.env -.env.local -.env.*.local -.env.development -.env.development.local -.env.production -.env.production.local -.env.test -.env.test.local -appsettings.Development.json -appsettings.Development.*.json -appsettings.Local.json -appsettings.Production.json -appsettings.Staging.json -appsettings.*.Local.json -secrets.json -*.pem -*.key -*.crt -*.pfx -*.p12 -keystore/ -keystore.*.jks -*.jks - -# ============================================= -# 7. 数据库相关 -# ============================================= -*.sql.backup -*.dump -*.db -*.sqlite -*.sqlite3 -*.bak -pgsql_data/ -pgdata/ -postgres-data/ -redis-data/ -mongo-data/ -minio-data/ - -# ============================================= -# 8. 日志文件 -# ============================================= -logs/ -*.log -log/ -serilog-*.json -nlog-*.txt -*.log.* -*.pid -*.seed -*.pid.lock - -# ============================================= -# 9. IDE / 编辑器 -# ============================================= -# VS Code（保留 extensions.json 和 settings.json.example） -.vscode/ -!.vscode/extensions.json -!.vscode/settings.json -!.vscode/launch.json -!.vscode/tasks.json -!.vscode/.gitignore - -# Visual Studio -.vs/ -*.user -*.suo -*.sln.docstates -*.userprefs -*.vsp -*.vspx -*.sap -*.sapcache -*.sln.metaproj -*.csproj.user -*.csproj.vspscc -*.vssscc - -# JetBrains Rider / IntelliJ / WebStorm -.idea/ -*.iml -*.iws -*.ipr -out/ - -# Cursor -.cursor/ - -# Trae -.trae/ - -# Aider -.aider* -.aider.chat.history.md -.aider.input.history - -# 通用 -*.swp -*.swo -*~ - -# ============================================= -# 10. 操作系统 -# ============================================= -# Windows -Thumbs.db -ehthumbs.db -ehthumbs_vista.db -Desktop.ini -$RECYCLE.BIN/ -$RECYCLE.BIN/ -*.lnk -System Volume Information/ - -# macOS -.DS_Store -.AppleDouble -.LSOverride -._* -.DocumentRevisions-V100 -.fseventsd -.Spotlight-V100 -.TemporaryItems -.Trashes -.VolumeIcon.icns -.com.apple.timemachine.donotpresent -.AppleDB -.AppleDesktop - -# Linux -*~ -.fuse_hidden* -.Trash-* -.nfs* - -# ============================================= -# 11. Office 临时文件 -# ============================================= -~$*.md -~$*.docx -~$*.doc -~$*.xlsx -~$*.xls -~$*.pptx -~$*.ppt -~$*.pdf - -# ============================================= -# 12. 测试 / 覆盖率 / 报告 -# ============================================= -coverage/ -.nyc_output/ -*.lcov -TestResults/ -playwright-report/ -playwright/.cache/ -allure-results/ -allure-report/ -cypress/videos/ -cypress/screenshots/ -junit.xml -report.*.xml - -# ============================================= -# 13. Docker / 部署 -# ============================================= -.docker/ -docker-compose.override.yml -docker-compose.*.override.yml -.deploy/ -deploy-keys/ - -# ============================================= -# 14. 上传 / 临时文件 -# ============================================= -uploads/ -tmp/ -temp/ -.cache/ -.tmp/ -*.tmp -*.bak -*.orig -*.rej -*.eslintcache -.stylelintcache -.history/ - -# ============================================= -# 15. 文档系统自动生成（保留手写的） -# ============================================= -# 注意：手写的 .md 不应该被忽略，仅忽略以下自动生成的文件 -.next/ -.nuxt/ -.cache/ -vuepress/.cache/ -docs/.vitepress/cache/ -docs/.vuepress/.cache/ - -# ============================================= -# 16. 依赖锁定（按需取消注释） -# ============================================= -# 如果使用 pnpm，可以跟踪 pnpm-lock.yaml -# 如果使用 npm，可以跟踪 package-lock.json -# 如果使用 yarn，可以跟踪 yarn.lock -# *.lock -!pnpm-lock.yaml -!package-lock.json -!yarn.lock -!Cargo.lock - -# ============================================= -# 17. 项目自身特殊文件 -# ============================================= -# 成员通讯录（隐私） -.team-contact.md -# 个人笔记 -notes/ -scratch/ -drafts/ - -# ============================================= -# 18. 不应忽略的例外（白名单） -# ============================================= -# 强制保留以下目录 -!docs/ -!docs/** -!frontend/ -!frontend/** -!backend/ -!backend/** -!deploy/ -!deploy/** diff --git "a/docs/00-\351\241\271\347\233\256\346\246\202\350\247\210/README.md" "b/docs/00-\351\241\271\347\233\256\346\246\202\350\247\210/README.md" deleted file mode 100644 index b2540e89b74d7787e66991e1053163a307eef905..0000000000000000000000000000000000000000 --- "a/docs/00-\351\241\271\347\233\256\346\246\202\350\247\210/README.md" +++ /dev/null @@ -1,23 +0,0 @@ -# 00 · 项目概览 - -> 本目录汇总项目立项、章程、范围等"基线"文档，是所有后续工作的起点。 - -## 📂 目录内容 - -| 文件 | 说明 | 状态 | -| :-- | :-- | :--: | -| [项目立项书.md](项目立项书.md) | 项目立项的正式文档 | ✅ 已就位 | - -## 📝 后续可补充 - -- 项目章程（Project Charter） -- 干系人登记册（Stakeholder Register） -- 假设与约束清单 -- 风险登记册（Risk Register） - -## 🖼 配图要求 - -本阶段文档配图 ≥ 3 张： -- 项目整体定位图 -- 干系人权力/利益方格 -- 里程碑甘特图 diff --git "a/docs/00-\351\241\271\347\233\256\346\246\202\350\247\210/\351\241\271\347\233\256\347\253\213\351\241\271\344\271\246.md" "b/docs/00-\351\241\271\347\233\256\346\246\202\350\247\210/\351\241\271\347\233\256\347\253\213\351\241\271\344\271\246.md" deleted file mode 100644 index e722d96937d7dff3e8788d87518888815c4a72dc..0000000000000000000000000000000000000000 --- "a/docs/00-\351\241\271\347\233\256\346\246\202\350\247\210/\351\241\271\347\233\256\347\253\213\351\241\271\344\271\246.md" +++ /dev/null @@ -1,306 +0,0 @@ -# 仿飞书应用项目立项书 - -| 项目编号 | FF-APP-C2G2-2026 | -| :--: | :--: | -| 项目名称 | 仿飞书应用-2班2组 | -| 所属班级 | 高职软件技术专业 2班 | -| 项目组别 | 第 2 组 | -| 项目周期 | 2026-07 ~ 2026-08（共 8 周 / 56 天） | -| 项目类型 | 全栈开发方向 · 暑期实习分组实战 | -| 项目状态 | ⏳ 立项阶段 | -| 文档版本 | v1.0 | -| 编写日期 | 2026-07-02 | -| 文档状态 | ✅ 待评审 | - ---- - -## 一、项目背景 - -### 1.1 行业背景 -随着远程办公与数字化协同需求的爆发，企业级协同办公平台（OA + IM + 协同文档）已成为各行各业的"基础设施"。字节跳动旗下 **飞书（Lark）**、腾讯 **企业微信**、阿里 **钉钉** 在国内市场形成三足鼎立格局，市场对相关技术人才的需求持续旺盛。 - -### 1.2 教学背景 -- 本项目为 **高职软件技术专业（全栈开发方向）暑期实习** 的分组实战项目 -- 组内成员同时涵盖 **全栈开发** 与 **实施运维** 两个方向，须双线并行 -- 项目旨在通过"准生产级"完整交付，检验同学们对前后端分离架构、企业级业务建模、文档规范与团队协作的综合能力 - -### 1.3 立项依据 -- 《高职软件技术专业人才培养方案（2024 版）》实习实训大纲 -- 暑期实习教学计划任务书（编号：JX-2026-SJ-01） -- 行业市场调研报告：协同办公平台人才需求分析 - ---- - -## 二、项目目标 - -### 2.1 业务目标 -**全量复刻飞书（Lark）核心业务功能**，覆盖 12 大业务模块，最终交付一个可在生产环境运行的 **企业级协同办公平台**。 - -| 目标维度 | 目标描述 | 验收标准 | -| :--: | :-- | :-- | -| 业务完整度 | 12 大模块全部实现 | 100% 模块通过功能验收 | -| 多端覆盖 | PC 网页端 + PC 客户端 + iOS + Android | 四端均可独立运行 | -| 性能 | 支持 100 并发用户在线 | 平均响应 < 500ms | -| 可交付 | 文档、源码、部署、运维手册齐全 | 通过校企联合验收 | - -### 2.2 能力培养目标 - -| 方向 | 培养目标 | -| :--: | :-- | -| 💻 全栈开发 | 掌握 Vue 3 + .NET 10 全栈开发流程；熟悉企业级业务建模；具备复杂模块的工程化交付能力 | -| 🔧 实施运维 | 掌握 CI/CD 流水线搭建；具备部署、监控、故障排查实战能力；具备客户对接与培训能力 | -| 👥 团队协作 | 具备 Git 协作、Code Review、文档输出、跨方向沟通能力 | - ---- - -## 三、项目范围 - -### 3.1 业务范围（12 大模块） - -| 序号 | 业务模块 | 优先级 | 负责方向 | -| :--: | :--: | :--: | :--: | -| 1 | 用户中心 | P0 | 全栈开发 | -| 2 | 通讯录 | P0 | 全栈开发 | -| 3 | 即时通讯（IM） | P0 | 全栈开发 | -| 4 | 协同文档 | P0 | 全栈开发 | -| 5 | 视频会议 | P1 | 全栈开发 | -| 6 | 日历 | P1 | 全栈开发 | -| 7 | 审批（OA） | P1 | 全栈开发 | -| 8 | 云盘 | P1 | 全栈开发 | -| 9 | 应用中心 | P2 | 全栈开发 | -| 10 | 消息通知 | P1 | 全栈开发 | -| 11 | 管理后台 | P0 | 全栈开发 | -| 12 | 开放平台 | P2 | 全栈开发 | - -### 3.2 技术范围 - -#### 前端 -- **PC 网页端**：Vue 3 + Vite + Tailwind CSS -- **PC 客户端**：Electron / Tauri -- **iOS / Android**：Uni-app / Taro -- **微信小程序**：Uni-app 编译输出（mp-weixin），支持微信开发者工具一键导入 - -#### 后端 -- .NET 10 + ASP.NET Core 10 + EF Core 10 -- PostgreSQL 16+ / Redis 7 / RabbitMQ / SignalR -- MinIO / Elasticsearch 8 - -#### 运维 -- Docker + Docker Compose -- Nginx + Prometheus + Grafana -- GitHub Actions / Gitee Go - -### 3.3 不在本期范围 -- 飞书 Marketplace 第三方应用市场对接 -- 海外多语言版本（仅简体中文） -- 移动端原生开发（采用跨端方案） - ---- - -## 四、技术方案 - -### 4.1 整体架构 -> 📌 **配图要求**：请使用 draw.io 绘制《系统整体架构图》，保存到 `docs/00-项目概览/images/项目架构图.png`，并在本文档下方引用。 - -``` -┌────────────────────────────────────────────────────┐ -│ 客户端（PC Web / PC Client / iOS / Android） │ -└──────────────────┬─────────────────────────────────┘ - │ HTTPS / WSS - ▼ -┌────────────────────────────────────────────────────┐ -│ Nginx 反向代理 │ -└──────────────────┬─────────────────────────────────┘ - │ - ┌──────────┴──────────┐ - ▼ ▼ -┌──────────────┐ ┌──────────────┐ -│ 前端静态资源 │ │ .NET 10 API 网关│ -└──────────────┘ └──────┬───────┘ - │ - ┌──────────────┼──────────────┐ - ▼ ▼ ▼ - ┌────────┐ ┌────────┐ ┌────────┐ - │pgsql │ │ Redis │ │ MinIO │ - └────────┘ └────────┘ └────────┘ -``` - -### 4.2 模块划分 -按业务域划分微服务/模块（单体先行，按需拆分）： - -| 模块 | 命名空间 | 负责人 | -| :--: | :--: | :--: | -| 用户中心 | `FF.App.User` | （待分配） | -| 通讯录 | `FF.App.Contacts` | （待分配） | -| IM | `FF.App.IM` | （待分配） | -| 协同文档 | `FF.App.Doc` | （待分配） | -| 视频会议 | `FF.App.Meeting` | （待分配） | -| 日历 | `FF.App.Calendar` | （待分配） | -| 审批 | `FF.App.Approval` | （待分配） | -| 云盘 | `FF.App.Drive` | （待分配） | -| 消息通知 | `FF.App.Notify` | （待分配） | -| 管理后台 | `FF.App.Admin` | （待分配） | -| 开放平台 | `FF.App.OpenAPI` | （待分配） | - ---- - -## 五、团队组成与分工 - -### 5.1 组内成员名单（占位，待填） - -| 序号 | 姓名 | 学号 | 方向 | 角色 | 负责模块 | -| :--: | :--: | :--: | :--: | :--: | :--: | -| 1 | （填写） | （填写） | 全栈开发 | 组长 / 后端主程 | （填写） | -| 2 | （填写） | （填写） | 全栈开发 | 前端主程 | （填写） | -| 3 | （填写） | （填写） | 全栈开发 | 后端工程师 | （填写） | -| 4 | （填写） | （填写） | 全栈开发 | 前端工程师 | （填写） | -| 5 | （填写） | （填写） | 实施运维 | 实施工程师 | （填写） | -| 6 | （填写） | （填写） | 实施运维 | 运维工程师 | （填写） | - -> ⚠️ **硬性要求**：全栈开发与实施运维两个方向必须都有明确任务，单方向学生数 ≥ 2。 - -### 5.2 双线分工表 - -| 周次 | 全栈开发线 | 实施运维线 | -| :--: | :-- | :-- | -| W1 | 需求评审、技术选型、原型设计 | 客户调研、需求收集、文档整理 | -| W2 | 架构设计、数据库设计、接口设计 | 客户环境调研、服务器选型 | -| W3-W4 | 用户中心、通讯录开发 | 测试环境部署、数据初始化脚本 | -| W5-W6 | IM、协同文档开发 | CI/CD 流水线搭建、监控告警 | -| W7-W8 | 视频会议、日历开发 | 生产环境部署、压力测试 | -| W9-W10 | 审批、云盘、消息通知 | 用户培训、使用手册编写 | -| W11-W12 | 联调、Bug 修复、回归 | 试运行支持、问题收集与反馈 | -| W13-W14 | 性能优化、文档完善 | 项目验收、运维交接文档 | - ---- - -## 六、项目里程碑 - -| 阶段 | 时间 | 交付物 | 验收方 | -| :--: | :--: | :-- | :--: | -| 立项 | W1 | 立项书（本文档） | 指导老师 | -| 需求 | W1 末 | 需求规格说明书、原型图 | 指导老师 | -| 设计 | W2 末 | 架构图、数据库 ER、接口文档 | 指导老师 | -| 第一轮开发 | W6 末 | 用户中心、通讯录、IM 跑通 | 组内自测 | -| 第二轮开发 | W10 末 | 文档、会议、日历、审批、云盘 | 组内自测 | -| 联调 | W12 末 | 联调报告、测试报告 | 指导老师 | -| 部署 | W13 末 | 生产环境部署、试运行 | 指导老师 | -| 验收 | W14 末 | 验收报告、运维手册、源码 | 校企联合 | - ---- - -## 七、资源需求 - -### 7.1 软件环境 -| 类别 | 工具/版本 | 用途 | -| :-- | :-- | :-- | -| 代码托管 | Gitee / GitHub | 仓库管理 | -| IDE | VS Code / Visual Studio 2022 / Rider | 开发 | -| 数据库 | PostgreSQL 16+ | 主存储 | -| 缓存 | Redis 7 | 缓存 | -| 消息队列 | RabbitMQ | 异步 | -| 容器 | Docker 24+ | 容器化 | -| 监控 | Prometheus + Grafana | 监控 | -| 设计 | Figma / 墨刀 / draw.io | 原型 / 架构图 | -| 文档 | Markdown + 语雀 / Notion | 文档协作 | - -### 7.2 硬件环境 -| 角色 | 配置 | 数量 | -| :-- | :-- | :--: | -| 开发机 | i5 / 16G / 512G | 每人 1 台 | -| 测试服务器 | 4C8G / 100G SSD | 1 台 | -| 生产服务器 | 8C16G / 500G SSD | 1 台 | - -### 7.3 预算 -- 服务器租赁：约 ¥xxx -- 第三方服务：约 ¥xxx -- 合计：约 ¥xxx（按实际填写） - ---- - -## 八、风险评估与应对 - -| 风险项 | 等级 | 影响 | 应对措施 | -| :--: | :--: | :--: | :-- | -| 人员流动（组员退出） | 🟡 中 | 进度延误 | 关键模块至少 2 人熟悉；文档强制齐全 | -| 技术难点（WebRTC / 协同编辑） | 🔴 高 | 模块延期 | 提前预研；备选方案；求助老师 | -| 进度延期 | 🟡 中 | 验收不通过 | 周报跟踪；滞后任务加资源 | -| 需求变更 | 🟢 低 | 返工 | 变更走正式流程，组长审批 | -| 服务器故障 | 🟢 低 | 部署延期 | 云厂商多可用区；本地有备份 | - ---- - -## 九、交付物清单 - -### 9.1 源码类 -- [ ] 前端工程：pc-web / pc-client / mobile-app -- [ ] 后端工程：.NET 10 Web API -- [ ] 数据库脚本：pgsql DDL + 初始化数据 -- [ ] 部署脚本：docker-compose / k8s manifest - -### 9.2 文档类（每个过程必须有 md 文档 + 配图） -- [ ] 00-项目概览：项目立项书、本文档 -- [ ] 01-需求分析：需求规格说明书、用户故事、流程图 -- [ ] 02-原型设计：高保真原型图 -- [ ] 03-技术选型：选型对比文档 -- [ ] 04-数据库设计：ER 图、表结构、字段说明 -- [ ] 05-接口设计：Swagger / OpenAPI 文档 -- [ ] 06-前端开发：每个组件 / 页面 / 模块的 md -- [ ] 07-后端开发：每个接口 / 服务的 md -- [ ] 08-联调测试：测试报告、Bug 清单 -- [ ] 09-部署上线：部署手册、回滚方案 -- [ ] 10-运维手册：监控、告警、故障处理 -- [ ] 11-周报与复盘：周报、复盘总结 - -### 9.3 演示类 -- [ ] 系统演示视频（每个核心模块一段） -- [ ] PPT 汇报材料 -- [ ] 海报 / 易拉宝设计稿 - ---- - -## 十、项目评审与签字 - -### 10.1 评审记录 - -| 评审轮次 | 时间 | 评审人 | 评审结论 | 备注 | -| :--: | :--: | :--: | :--: | :--: | -| 第 1 轮 | （填写） | 指导老师 | （填写） | （填写） | -| 第 2 轮 | （填写） | 校企联合 | （填写） | （填写） | - -### 10.2 签字栏 - -| 角色 | 姓名 | 签字 | 日期 | -| :--: | :--: | :--: | :--: | -| 组长 | （填写） | | | -| 指导老师 | （填写） | | | -| 专业负责人 | （填写） | | | - ---- - -## 附录 - -### 附录 A：术语表 -| 术语 | 解释 | -| :-- | :-- | -| IM | Instant Messaging，即时通讯 | -| OA | Office Automation，办公自动化 | -| SSO | Single Sign On，单点登录 | -| WebRTC | Web Real-Time Communication，网页实时通信 | -| DDL | Data Definition Language，数据定义语言 | -| pgsql | PostgreSQL 数据库 | -| SignalR | .NET 实时通信库 | -| Webhook | HTTP 回调机制 | - -### 附录 B：参考文档 -- 飞书官方文档：https://open.feishu.cn/document -- Vue 3 官方文档：https://cn.vuejs.org/ -- .NET 10 官方文档：https://learn.microsoft.com/zh-cn/dotnet/ -- PostgreSQL 官方文档：https://www.postgresql.org/docs/ - -### 附录 C：文档修订历史 - -| 版本 | 日期 | 修订人 | 修订内容 | -| :--: | :--: | :--: | :-- | -| v1.0 | 2026-07-02 | （填写） | 初版立项书 | -| | | | | diff --git "a/docs/01-\351\234\200\346\261\202\345\210\206\346\236\220/README.md" "b/docs/01-\351\234\200\346\261\202\345\210\206\346\236\220/README.md" deleted file mode 100644 index 378f915af156bf91c4c5e60a78fd29d1bc61f24c..0000000000000000000000000000000000000000 --- "a/docs/01-\351\234\200\346\261\202\345\210\206\346\236\220/README.md" +++ /dev/null @@ -1,82 +0,0 @@ -# 01 · 需求分析 - -## 🎯 阶段目标 - -通过用户调研、竞品分析、业务梳理，输出**完整、可追溯、可验证**的需求规格说明书（SRS），为后续设计、开发和测试提供基线。 - -## 📝 必含章节（每篇需求文档） - -| 章节 | 说明 | 必含配图 | -| :--: | :-- | :--: | -| 一、需求背景 | 业务痛点、用户场景 | ✅ | -| 二、用户角色 | 角色清单与画像 | ✅ | -| 三、用户故事 | User Story + 验收标准（Given/When/Then） | ❌ | -| 四、业务流程 | 端到端流程（业务流程图） | ✅ | -| 五、功能需求 | FR 清单（功能 ID + 描述 + 优先级） | ❌ | -| 六、非功能需求 | 性能 / 安全 / 可用性 / 兼容性 | ❌ | -| 七、需求追溯矩阵 | RTM（需求 → 设计 → 代码 → 测试） | ✅ | -| 八、变更记录 | 需求变更与版本历史 | ❌ | - -## 📂 命名规范 - -``` -01-需求分析-<模块名>-<文档名>.md -``` - -示例： -- `01-需求分析-IM-消息已读未读.md` -- `01-需求分析-审批-自定义表单.md` - -## 🖼 配图要求 - -- 每篇文档 **≥ 5 张配图**（业务流程图、状态机图、界面原型草图） -- 存放：`docs/01-需求分析/images/` 子目录 -- 推荐工具：draw.io / ProcessOn / Visio - -## 📦 产出物清单 - -- [ ] 需求规格说明书（SRS） -- [ ] 用户故事地图（User Story Map） -- [ ] 业务流程图（每模块 1 张） -- [ ] 需求追溯矩阵（RTM） -- [ ] 竞品分析报告（飞书 / 钉钉 / 企业微信 对比） - -## ✍️ 文档模板（复制后填写） - -```markdown -# <模块名> - <需求主题> - -## 一、需求背景 -（业务痛点、为什么要做、用户场景） - -## 二、用户角色 -| 角色 | 描述 | 关键诉求 | -| :--: | :-- | :-- | - -## 三、用户故事 -- 作为 <角色>，我希望 <目标>，以便 <价值> - - 验收标准： - - Given <前置> - - When <动作> - - Then <结果> - -## 四、业务流程 -（插入业务流程图） - -## 五、功能需求 -| FR-ID | 描述 | 优先级 | 验收标准 | -| :--: | :-- | :--: | :-- | - -## 六、非功能需求 -- 性能：QPS / 响应时间 -- 安全：鉴权 / 加密 / 审计 -- 可用性：SLA / 故障恢复 -- 兼容性：浏览器 / 设备 / 系统 - -## 七、需求追溯矩阵 -| FR-ID | 设计文档 | 代码入口 | 测试用例 | -| :--: | :-- | :-- | :-- | - -## 八、变更记录 -| 版本 | 日期 | 修改人 | 变更内容 | -``` diff --git "a/docs/02-\345\216\237\345\236\213\350\256\276\350\256\241/README.md" "b/docs/02-\345\216\237\345\236\213\350\256\276\350\256\241/README.md" deleted file mode 100644 index 9978e286835956747be9f2f0c34c62604a53c1b7..0000000000000000000000000000000000000000 --- "a/docs/02-\345\216\237\345\236\213\350\256\276\350\256\241/README.md" +++ /dev/null @@ -1,71 +0,0 @@ -# 02 · 原型设计 - -## 🎯 阶段目标 - -基于需求文档，输出**高保真可交互原型**，明确页面布局、交互逻辑、视觉规范，作为前端开发的"施工图"。 - -## 📝 必含章节（每篇原型文档） - -| 章节 | 说明 | 必含配图 | -| :--: | :-- | :--: | -| 一、设计目标 | 解决什么问题、参考产品 | ✅ | -| 二、页面清单 | 页面树状图、路由对应 | ✅ | -| 三、关键页面 | 核心页面的高保真原型 | ✅ | -| 四、交互说明 | 状态机、转场动效、异常态 | ✅ | -| 五、设计规范 | 颜色、字体、间距、组件库 | ✅ | -| 六、组件库清单 | 自研 / 复用组件清单 | ❌ | -| 七、设计交付物 | 切图、标注、设计稿链接 | ❌ | - -## 📂 命名规范 - -``` -02-原型设计-<模块名>-<页面名>.md -``` - -示例： -- `02-原型设计-IM-聊天窗口.md` -- `02-原型设计-通讯录-组织架构.md` - -## 🖼 配图要求 - -- **核心页**：每页 1 张高保真图 + 多状态截图（加载/空/错误/成功） -- **总数量**：每篇文档 **≥ 8 张**（设计图比需求图更多） -- 存放：`docs/02-原型设计/images/` 子目录 - -## 📦 产出物清单 - -- [ ] 高保真原型（Figma / 墨刀 / Axure 源文件） -- [ ] 交互说明文档 -- [ ] 设计规范（颜色/字体/组件） -- [ ] 切图与标注（Zeplin / 蓝湖） -- [ ] 四端适配说明（PC Web / PC Client / iOS / Android） - -## ✍️ 文档模板 - -```markdown -# <模块名> - <页面名> 原型设计 - -## 一、设计目标 -（设计要解决的问题、参考产品截图） - -## 二、页面清单 -| 页面 | 路由 | 权限 | 备注 | -| :--: | :--: | :--: | :-- | - -## 三、关键页面 -（插入高保真原型图，多状态：默认/悬停/激活/禁用/空/加载/错误） - -## 四、交互说明 -| 元素 | 触发 | 行为 | 转场 | -| :--: | :--: | :-- | :-- | - -## 五、设计规范 -- 主色：#3370FF -- 字体：PingFang SC / Microsoft YaHei -- 间距：4 / 8 / 12 / 16 / 24 / 32 -- 圆角：4 / 8 / 16 - -## 六、组件库 -| 组件 | 来源 | 备注 | -| :--: | :-- | :-- | -``` diff --git "a/docs/03-\346\212\200\346\234\257\351\200\211\345\236\213/README.md" "b/docs/03-\346\212\200\346\234\257\351\200\211\345\236\213/README.md" deleted file mode 100644 index 42c77969161880f0de8028d5305adafc57f2be3d..0000000000000000000000000000000000000000 --- "a/docs/03-\346\212\200\346\234\257\351\200\211\345\236\213/README.md" +++ /dev/null @@ -1,85 +0,0 @@ -# 03 · 技术选型 - -## 🎯 阶段目标 - -通过系统化的技术调研、对比、PoC 验证，输出**可决策、可追溯**的技术选型清单（ADR - Architecture Decision Record）。 - -## 📝 必含章节（每篇选型文档） - -| 章节 | 说明 | 必含配图 | -| :--: | :-- | :--: | -| 一、选型背景 | 要解决什么问题、约束条件 | ✅ | -| 二、候选方案 | 不少于 3 个候选方案 | ❌ | -| 三、对比维度 | 性能 / 生态 / 学习成本 / 团队契合度 / 长期维护 | ✅ | -| 四、对比矩阵 | 量化打分 + 加权总分 | ✅ | -| 五、PoC 验证 | 关键路径代码示例与结论 | ✅ | -| 六、决策结论 | 选 X 不选 Y 的理由 | ❌ | -| 七、风险与回退 | 选型风险 + 回退方案 | ❌ | - -## 📂 命名规范 - -``` -03-技术选型-<主题>.md -``` - -示例： -- `03-技术选型-前端框架.md` -- `03-技术选型-IM通信方案.md` -- `03-技术选型-数据库.md` - -## 🖼 配图要求 - -- 候选方案架构图（每个方案 1 张） -- 对比雷达图 / 柱状图 -- PoC 关键代码截图 -- **≥ 5 张配图** - -## 📦 产出物清单 - -- [ ] 前端框架选型 -- [ ] 后端框架选型 -- [ ] 数据库选型 -- [ ] 中间件选型（缓存 / MQ / 搜索 / 对象存储） -- [ ] 部署方案选型 -- [ ] 监控方案选型 -- [ ] ADR 决策记录汇总（`03-技术选型-ADR汇总.md`） - -## ✍️ 文档模板 - -```markdown -# <技术主题> 选型 - -## 一、选型背景 -（业务诉求、技术约束、团队现状） - -## 二、候选方案 -| 方案 | 简介 | 社区活跃度 | 主要优势 | 主要劣势 | -| :--: | :-- | :--: | :-- | :-- | - -## 三、对比维度与权重 -| 维度 | 权重 | 说明 | -| :--: | :--: | :-- | -| 性能 | 25% | | -| 生态 | 20% | | -| 学习成本 | 15% | | -| 团队契合 | 25% | | -| 长期维护 | 15% | | - -## 四、对比矩阵 -| 维度 | 方案A | 方案B | 方案C | -| :--: | :--: | :--: | :--: | -| 性能 | 8 | 9 | 7 | -| 生态 | 9 | 7 | 8 | -| **加权总分** | **8.1** | **7.6** | **7.8** | - -## 五、PoC 验证 -（关键代码 + 性能测试截图 + 结论） - -## 六、决策结论 -✅ 选择 **方案 X**，理由： -1. ... -2. ... - -## 七、风险与回退 -| 风险 | 等级 | 应对 | 回退方案 | -``` diff --git "a/docs/04-\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241/README.md" "b/docs/04-\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241/README.md" deleted file mode 100644 index 3ed3c5a6f0bc849304923cfad5ac0c07e13e396f..0000000000000000000000000000000000000000 --- "a/docs/04-\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241/README.md" +++ /dev/null @@ -1,84 +0,0 @@ -# 04 · 数据库设计 - -## 🎯 阶段目标 - -输出符合 3NF、可扩展、高性能的 PostgreSQL 数据库 schema，包含 ER 图、表结构、索引、约束、迁移脚本与种子数据。 - -## 📝 必含章节（每篇库表设计文档） - -| 章节 | 说明 | 必含配图 | -| :--: | :-- | :--: | -| 一、设计原则 | 命名、字符集、时区、3NF / 反范式决策 | ❌ | -| 二、ER 图 | 核心实体关系图 | ✅ | -| 三、表结构 | 字段、类型、约束、默认值、注释 | ✅ | -| 四、索引设计 | 主键 / 唯一 / 普通 / 复合 / 部分 / GIN | ✅ | -| 五、关联关系 | 外键策略、级联、软删除 | ✅ | -| 六、DDL 脚本 | PostgreSQL DDL，可直接执行 | ❌ | -| 七、迁移方案 | EF Core Migration / Flyway 流程 | ✅ | -| 八、初始化数据 | 种子数据脚本 | ❌ | - -## 📂 命名规范 - -``` -04-数据库设计-<模块名>-<表名>.md -``` - -示例： -- `04-数据库设计-IM-消息表.md` -- `04-数据库设计-用户中心-用户表.md` - -## 🖼 配图要求 - -- ER 图（每模块 1 张总图 + 关键关系放大图） -- 字段含义表 -- 索引设计图 -- **≥ 5 张配图** - -## 📦 产出物清单 - -- [ ] 全局 ER 图（`04-数据库设计-全局ER图.md`） -- [ ] 各模块表结构文档 -- [ ] PostgreSQL DDL 脚本（`backend/scripts/sql/*.sql`） -- [ ] EF Core Migration 文件 -- [ ] 种子数据脚本 -- [ ] 数据库设计评审报告 - -## ✍️ 文档模板 - -```markdown -# <模块名> - <表名> 设计 - -## 一、所属模块 -## 二、表用途 - -## 三、字段说明 -| 字段 | 类型 | 必填 | 默认 | 注释 | -| :--: | :--: | :--: | :--: | :--: | -| id | uuid | ✅ | gen_random_uuid() | 主键 | -| created_at | timestamptz | ✅ | now() | 创建时间 | -| updated_at | timestamptz | ✅ | now() | 更新时间 | -| is_deleted | boolean | ✅ | false | 软删除 | - -## 四、索引 -| 索引名 | 字段 | 类型 | 用途 | -| :-- | :-- | :--: | :-- | -| pk_xxx | id | 主键 | | -| idx_xxx_created | created_at desc | B-Tree | 列表分页 | - -## 五、关联关系 -| 关联表 | 关系 | 外键 | 级联 | -| :--: | :--: | :--: | :--: | -| user | 多对一 | user_id | SET NULL | - -## 六、DDL -```sql -CREATE TABLE xxx ( - id uuid PRIMARY KEY DEFAULT gen_random_uuid(), - created_at timestamptz NOT NULL DEFAULT now(), - updated_at timestamptz NOT NULL DEFAULT now(), - is_deleted boolean NOT NULL DEFAULT false -); -``` - -## 七、变更记录 -``` diff --git "a/docs/05-\346\216\245\345\217\243\350\256\276\350\256\241/README.md" "b/docs/05-\346\216\245\345\217\243\350\256\276\350\256\241/README.md" deleted file mode 100644 index ea74ed5a5b94372306499c731382813129cb713a..0000000000000000000000000000000000000000 --- "a/docs/05-\346\216\245\345\217\243\350\256\276\350\256\241/README.md" +++ /dev/null @@ -1,94 +0,0 @@ -# 05 · 接口设计 - -## 🎯 阶段目标 - -基于需求与数据库设计，输出**RESTful 风格、版本化、统一错误码**的 OpenAPI 3.0 接口契约，前端联调与后端开发均以此为基线。 - -## 📝 必含章节（每篇接口设计文档） - -| 章节 | 说明 | 必含配图 | -| :--: | :-- | :--: | -| 一、接口概述 | 模块 / 资源 / 路径 | ✅ | -| 二、统一规范 | 鉴权 / 响应结构 / 错误码 / 分页 | ✅ | -| 三、接口列表 | Method + Path + 鉴权 + 限流 | ❌ | -| 四、字段定义 | 请求/响应字段（嵌套结构用表格） | ✅ | -| 五、时序图 | 关键接口的时序图 | ✅ | -| 六、错误场景 | 错误码 + 触发条件 + 提示文案 | ❌ | -| 七、Mock 数据 | 示例请求/响应 | ❌ | - -## 📂 命名规范 - -``` -05-接口设计-<模块名>-<资源名>.md -``` - -示例： -- `05-接口设计-IM-消息.md` -- `05-接口设计-用户中心-认证.md` - -## 🖼 配图要求 - -- 接口调用时序图 -- 状态机图 -- 字段嵌套结构图 -- **≥ 5 张配图** - -## 📦 产出物清单 - -- [ ] 全局接口规范（`05-接口设计-全局规范.md`） -- [ ] 各模块接口详细设计 -- [ ] OpenAPI 3.0 YAML（`backend/src/FF.App.Api/openapi.yaml`） -- [ ] Swagger UI 部署 -- [ ] Mock 服务（Apifox / YApi / json-server） - -## ✍️ 文档模板 - -```markdown -# <模块名> - <资源名> 接口设计 - -## 一、接口概述 -- 资源：xxx -- 路径前缀：/api/v1/xxx -- 鉴权：JWT Bearer -- 限流：100 QPS / 用户 - -## 二、接口列表 -| Method | Path | 鉴权 | 限流 | 说明 | -| :--: | :--: | :--: | :--: | :-- | - -## 三、统一响应结构 -```json -{ - "code": 0, - "message": "ok", - "data": { }, - "traceId": "abc123" -} -``` - -## 四、字段定义 -### 请求 -| 字段 | 类型 | 必填 | 说明 | -| :--: | :--: | :--: | :-- | - -### 响应 -| 字段 | 类型 | 说明 | -| :--: | :--: | :-- | - -## 五、时序图 -（绘制关键接口的时序图） - -## 六、错误码 -| code | 含义 | 触发条件 | 提示文案 | -| :--: | :--: | :--: | :-- | -| 0 | 成功 | - | ok | -| 40101 | 未登录 | token 缺失/失效 | 请重新登录 | -| 40301 | 无权限 | RBAC 拒绝 | 无权访问 | - -## 七、Mock 示例 -```bash -curl -X POST https://api.xxx/v1/xxx \ - -H "Authorization: Bearer xxx" \ - -d '{ "key": "value" }' -``` -``` diff --git "a/docs/06-\345\211\215\347\253\257\345\274\200\345\217\221/README.md" "b/docs/06-\345\211\215\347\253\257\345\274\200\345\217\221/README.md" deleted file mode 100644 index 0444729635926033d4129e9bb498fe38ddfac078..0000000000000000000000000000000000000000 --- "a/docs/06-\345\211\215\347\253\257\345\274\200\345\217\221/README.md" +++ /dev/null @@ -1,91 +0,0 @@ -# 06 · 前端开发 - -## 🎯 阶段目标 - -按模块/页面/组件**逐个交付** Vue 3 + Tailwind CSS 实现，每个产出物必须配套**完整、详实、带配图**的开发文档。 - -## 📝 必含章节（每篇前端开发文档） - -| 章节 | 说明 | 必含配图 | -| :--: | :-- | :--: | -| 一、功能概述 | 实现哪个需求（关联需求文档） | ❌ | -| 二、技术方案 | 组件拆分、状态管理、路由设计 | ✅ | -| 三、目录结构 | 文件树、命名说明 | ✅ | -| 四、核心实现 | 关键代码 + 注释 | ✅ | -| 五、组件复用 | 复用了哪些组件 / 工具 | ❌ | -| 六、运行截图 | 主要功能截图（多状态） | ✅ | -| 七、性能优化 | 懒加载 / 防抖 / 缓存 / 骨架屏 | ✅ | -| 八、踩坑与复盘 | 问题 + 解决方案 | ❌ | - -## 📂 命名规范 - -``` -06-前端开发-<模块名>-<组件/页面/模块名>.md -``` - -示例： -- `06-前端开发-IM-消息列表组件.md` -- `06-前端开发-登录-SSO接入.md` -- `06-前端开发-PC客户端-Electron打包.md` - -## 🖼 配图要求 - -- 组件结构图 / 状态流转图 -- 代码截图（关键逻辑，红框标注） -- **运行截图 ≥ 3 张**（多状态：加载/成功/空/错误） -- 移动端需含 iOS + Android 真机截图 -- **每篇 ≥ 8 张配图**（前端文档配图要求最高） - -## 📦 产出物清单 - -- [ ] PC 网页端（`frontend/pc-web/`） -- [ ] PC 客户端（`frontend/pc-client/`，Electron / Tauri） -- [ ] 移动 H5（`frontend/mobile-h5/`） -- [ ] 移动 App（`frontend/mobile-app/`，Uni-app / Taro 编译 iOS + Android） -- [ ] 自研组件库（`frontend/packages/ui/`） -- [ ] 公共工具 / Hooks（`frontend/packages/utils/`） - -## ✍️ 文档模板 - -```markdown -# <模块名> - <组件/页面/功能> - -## 一、功能概述 -- 关联需求：[01-需求分析-xxx.md](../01-需求分析/xxx.md) -- 关联原型：[02-原型设计-xxx.md](../02-原型设计/xxx.md) -- 关联接口：[05-接口设计-xxx.md](../05-接口设计/xxx.md) - -## 二、技术方案 -（插入组件树 / 状态流转图） - -## 三、目录结构 -``` -frontend/pc-web/src/views/xxx/ -├── index.vue -├── components/ -│ ├── XxxList.vue -│ └── XxxForm.vue -├── composables/ -│ └── useXxx.ts -└── stores/ - └── xxx.ts -``` - -## 四、核心实现 -（关键代码 + 红框截图） - -## 五、组件复用 -- [XxxButton](../components/XxxButton.md) - 通用按钮 -- [useRequest](../composables/useRequest.md) - 请求 hook - -## 六、运行截图 -（多状态截图：默认/加载/空/错误） - -## 七、性能优化 -- 列表虚拟滚动：使用 vue-virtual-scroller -- 图片懒加载：IntersectionObserver -- 防抖搜索：300ms - -## 八、踩坑与复盘 -| 问题 | 原因 | 解决方案 | -``` diff --git "a/docs/07-\345\220\216\347\253\257\345\274\200\345\217\221/README.md" "b/docs/07-\345\220\216\347\253\257\345\274\200\345\217\221/README.md" deleted file mode 100644 index db8fc130d2cf87c5a4b1a9aef4f75976d81b1402..0000000000000000000000000000000000000000 --- "a/docs/07-\345\220\216\347\253\257\345\274\200\345\217\221/README.md" +++ /dev/null @@ -1,93 +0,0 @@ -# 07 · 后端开发 - -## 🎯 阶段目标 - -按模块/服务/接口**逐个交付** .NET 10 + ASP.NET Core + EF Core 实现，每个产出物必须配套完整开发文档。 - -## 📝 必含章节（每篇后端开发文档） - -| 章节 | 说明 | 必含配图 | -| :--: | :-- | :--: | -| 一、功能概述 | 实现哪个需求、接口 | ❌ | -| 二、技术方案 | 分层、依赖、设计模式 | ✅ | -| 三、目录结构 | 项目结构、命名空间 | ✅ | -| 四、领域模型 | 实体、值对象、聚合根 | ✅ | -| 五、核心实现 | Controller / Service / Repository 关键代码 | ✅ | -| 六、数据库操作 | EF Core 迁移、查询优化 | ✅ | -| 七、单元测试 | 测试用例与覆盖率 | ✅ | -| 八、踩坑与复盘 | 问题 + 解决方案 | ❌ | - -## 📂 命名规范 - -``` -07-后端开发-<模块名>-<服务/接口名>.md -``` - -示例： -- `07-后端开发-IM-消息服务.md` -- `07-后端开发-用户中心-认证服务.md` - -## 🖼 配图要求 - -- 分层架构图 -- 领域模型类图 -- 时序图 -- 代码截图（关键逻辑） -- Swagger 接口截图 -- 单元测试覆盖率截图 -- **每篇 ≥ 6 张配图** - -## 📦 产出物清单 - -- [ ] API 网关（`backend/src/FF.App.Api/`） -- [ ] 各业务模块（`backend/src/FF.App./`） -- [ ] 共享内核（`backend/src/FF.App.Shared/`） -- [ ] 数据库迁移（`backend/src/FF.App.Api/Migrations/`） -- [ ] 单元测试（覆盖率 ≥ 60%） -- [ ] 集成测试 - -## ✍️ 文档模板 - -```markdown -# <模块名> - <服务/接口> - -## 一、功能概述 -- 关联需求：[01-需求分析-xxx.md](../01-需求分析/xxx.md) -- 关联接口：[05-接口设计-xxx.md](../05-接口设计/xxx.md) -- 关联表结构：[04-数据库设计-xxx.md](../04-数据库设计/xxx.md) - -## 二、技术方案 -（分层架构图 + 关键模式说明） - -## 三、目录结构 -``` -backend/src/FF.App./ -├── Controllers/ -├── Services/ -│ ├── Interfaces/ -│ └── Implementations/ -├── Repositories/ -├── Entities/ -├── DTOs/ -└── Validators/ -``` - -## 四、领域模型 -（类图） - -## 五、核心实现 -（关键代码片段） - -## 六、数据库操作 -（EF Core 迁移 + 查询示例） - -## 七、单元测试 -| 测试类 | 用例数 | 覆盖率 | -| :--: | :--: | :--: | -| XxxServiceTests | 12 | 85% | - -（插入覆盖率截图） - -## 八、踩坑与复盘 -| 问题 | 原因 | 解决方案 | -``` diff --git "a/docs/08-\350\201\224\350\260\203\346\265\213\350\257\225/README.md" "b/docs/08-\350\201\224\350\260\203\346\265\213\350\257\225/README.md" deleted file mode 100644 index 3a7acbcb79d555ddd96270c4196a5a6eab9843e7..0000000000000000000000000000000000000000 --- "a/docs/08-\350\201\224\350\260\203\346\265\213\350\257\225/README.md" +++ /dev/null @@ -1,79 +0,0 @@ -# 08 · 联调测试 - -## 🎯 阶段目标 - -通过**功能测试、接口测试、UI 自动化、压力测试**多维度验证系统质量，输出可追溯的测试报告与 Bug 清单。 - -## 📝 必含章节（每篇测试文档） - -| 章节 | 说明 | 必含配图 | -| :--: | :-- | :--: | -| 一、测试范围 | 本轮测试覆盖的模块 | ✅ | -| 二、测试策略 | 测试类型 + 工具 + 准入准出 | ✅ | -| 三、测试用例 | 编号 + 步骤 + 预期 + 实际 | ✅ | -| 四、缺陷清单 | Bug ID + 等级 + 状态 | ✅ | -| 五、性能测试 | QPS / 响应时间 / 资源占用 | ✅ | -| 六、回归测试 | 修复后回归范围与结果 | ✅ | -| 七、风险与遗留 | 已知问题 + 后续计划 | ❌ | - -## 📂 命名规范 - -``` -08-联调测试-<轮次>-<范围>.md -``` - -示例： -- `08-联调测试-第1轮-用户中心.md` -- `08-联调测试-性能测试-IM.md` - -## 🖼 配图要求 - -- 测试用例执行截图 -- Bug 截图（带红框） -- 性能曲线图（JMeter / Locust 报告） -- 覆盖率报告 -- **每篇 ≥ 6 张配图** - -## 📦 产出物清单 - -- [ ] 测试计划 -- [ ] 测试用例库（TestLink / 飞书表格） -- [ ] 缺陷清单（Bug 跟踪表） -- [ ] 性能测试报告 -- [ ] 测试报告（`08-联调测试-总结报告.md`） -- [ ] 自动化测试脚本（`backend/tests/`、`frontend/tests/`） - -## ✍️ 文档模板 - -```markdown -# <测试轮次> - <测试范围> - -## 一、测试范围 -| 模块 | 用例数 | 负责人 | -| :--: | :--: | :--: | - -## 二、测试策略 -- 功能测试：手工 + Playwright -- 接口测试：Postman + Newman -- 性能测试：JMeter -- 覆盖率门槛：后端 ≥ 60% - -## 三、测试用例 -| TC-ID | 标题 | 前置 | 步骤 | 预期 | 实际 | 结果 | -| :--: | :-- | :--: | :-- | :-- | :-- | :--: | - -## 四、缺陷清单 -| Bug-ID | 标题 | 等级 | 状态 | 修复人 | -| :--: | :-- | :--: | :--: | :--: | -| BUG-001 | 消息发送失败 | P0 | 已修复 | 张三 | - -## 五、性能测试 -（插入 JMeter 聚合报告 + 响应时间曲线） - -## 六、回归测试 -| Bug-ID | 回归结果 | 验证人 | -| :--: | :--: | :--: | - -## 七、风险与遗留 -| 风险 | 影响 | 后续计划 | -``` diff --git "a/docs/09-\351\203\250\347\275\262\344\270\212\347\272\277/README.md" "b/docs/09-\351\203\250\347\275\262\344\270\212\347\272\277/README.md" deleted file mode 100644 index f0feddda77cb8671b7b2c9aecf1c2a22674a33fe..0000000000000000000000000000000000000000 --- "a/docs/09-\351\203\250\347\275\262\344\270\212\347\272\277/README.md" +++ /dev/null @@ -1,116 +0,0 @@ -# 09 · 部署上线 - -## 🎯 阶段目标 - -输出一键可执行的部署手册、回滚方案、CI/CD 流水线，保证系统从**测试环境 → 预发布 → 生产**的稳定交付。 - -## 📝 必含章节 - -| 章节 | 说明 | 必含配图 | -| :--: | :-- | :--: | -| 一、部署架构 | 拓扑、组件、端口、依赖 | ✅ | -| 二、环境清单 | dev / staging / prod 配置差异 | ✅ | -| 三、Docker 镜像 | Dockerfile、镜像构建、推送到哪 | ✅ | -| 四、Docker Compose | 多容器编排 | ❌ | -| 五、CI/CD 流水线 | GitHub Actions / Gitee Go 配置 | ✅ | -| 六、部署步骤 | 从 0 到 1 完整步骤 | ✅ | -| 七、回滚方案 | 触发条件、回滚步骤 | ✅ | -| 八、验证清单 | 部署后 smoke test | ❌ | - -## 📂 命名规范 - -``` -09-部署上线-<环境>-<主题>.md -``` - -示例： -- `09-部署上线-生产-Docker部署.md` -- `09-部署上线-生产-回滚方案.md` -- `09-部署上线-CI-CD流水线.md` - -## 🖼 配图要求 - -- 部署架构拓扑图 -- CI/CD 流水线图 -- Docker 镜像构建过程截图 -- 部署命令执行截图 -- **每篇 ≥ 6 张配图** - -## 📦 产出物清单 - -- [ ] 部署架构图 -- [ ] Dockerfile（前端 + 后端 + 各个微服务） -- [ ] docker-compose.yml（dev / prod） -- [ ] Nginx 配置（`deploy/nginx/`） -- [ ] CI/CD 配置（`.github/workflows/` 或 `.gitee/`） -- [ ] 部署手册 -- [ ] 回滚手册 -- [ ] 监控告警配置 - -## ✍️ 文档模板 - -```markdown -# <环境> - <主题> 部署 - -## 一、部署架构 -（插入部署拓扑图：Nginx / API / Worker / DB / Cache / MQ / Storage） - -## 二、环境清单 -| 环境 | 域名 | 服务器 | 数据库 | 备注 | -| :--: | :--: | :--: | :--: | :--: | -| dev | dev.xxx.com | 192.168.1.10 | pgsql-dev | | -| staging | staging.xxx.com | 192.168.1.20 | pgsql-stg | | -| prod | xxx.com | 192.168.1.30 | pgsql-prod | 主从 | - -## 三、Docker 镜像 -```dockerfile -FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS base -WORKDIR /app -EXPOSE 5000 - -FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build -WORKDIR /src -COPY . . -RUN dotnet publish -c Release -o /app/publish - -FROM base AS final -WORKDIR /app -COPY --from=build /app/publish . -ENTRYPOINT ["dotnet", "FF.App.Api.dll"] -``` - -## 四、Docker Compose -（关键片段） - -## 五、CI/CD 流水线 -（插入流水线图 + GitHub Actions YAML 关键配置） - -## 六、部署步骤 -```bash -# 1. 拉取代码 -git pull origin main - -# 2. 构建镜像 -docker compose -f deploy/docker/docker-compose.prod.yml build - -# 3. 启动服务 -docker compose -f deploy/docker/docker-compose.prod.yml up -d - -# 4. 数据库迁移 -docker compose exec api dotnet ef database update - -# 5. 验证 -curl https://xxx.com/health -``` - -## 七、回滚方案 -| 触发条件 | 响应时限 | 回滚步骤 | -| :--: | :--: | :-- | -| 5xx > 1% | 5min | git revert + 重新部署 | - -## 八、验证清单 -- [ ] 健康检查通过 -- [ ] 关键接口 200 -- [ ] 数据库连接正常 -- [ ] 静态资源 200 -``` diff --git "a/docs/10-\350\277\220\347\273\264\346\211\213\345\206\214/README.md" "b/docs/10-\350\277\220\347\273\264\346\211\213\345\206\214/README.md" deleted file mode 100644 index 3c432f568cdb52f61dd4a55ac3555f7e4c57df07..0000000000000000000000000000000000000000 --- "a/docs/10-\350\277\220\347\273\264\346\211\213\345\206\214/README.md" +++ /dev/null @@ -1,66 +0,0 @@ -# 10 · 运维手册 - -## 🎯 阶段目标 - -为实施运维方向的同学提供**日常运维、监控告警、故障处理、备份恢复**的完整 SOP，确保系统"长期可运行"。 - -## 📝 必含章节 - -| 章节 | 说明 | 必含配图 | -| :--: | :-- | :--: | -| 一、运维职责 | 7×24 值班清单 | ❌ | -| 二、监控大盘 | Prometheus + Grafana 配置 | ✅ | -| 三、告警规则 | 阈值、通知渠道、升级策略 | ✅ | -| 四、故障处理 Runbook | 常见故障的处置流程 | ✅ | -| 五、备份与恢复 | 备份策略、恢复演练 | ✅ | -| 六、安全运维 | 漏洞扫描、密钥轮转 | ❌ | -| 七、容量规划 | 性能基线、扩容策略 | ✅ | -| 八、应急响应 | 故障等级、汇报流程 | ❌ | - -## 📂 命名规范 - -``` -10-运维手册-<主题>.md -``` - -示例： -- `10-运维手册-监控告警.md` -- `10-运维手册-故障处理Runbook.md` -- `10-运维手册-备份恢复.md` -- `10-运维手册-应急响应.md` - -## 🖼 配图要求 - -- 监控大盘截图（多个 Dashboard） -- 告警规则配置截图 -- 故障处理流程图 -- 备份脚本执行截图 -- **每篇 ≥ 5 张配图** - -## 📦 产出物清单 - -- [ ] 运维值班表 -- [ ] 监控大盘配置（`deploy/grafana/dashboards/`） -- [ ] 告警规则（`deploy/prometheus/rules/`） -- [ ] 故障 Runbook（按模块归档） -- [ ] 备份脚本（`deploy/backup/`） -- [ ] 应急响应预案 - -## ✍️ 文档模板 - -```markdown -# <主题> - -## 一、职责/目标 - -## 二、操作步骤 -（详细命令 + 截图） - -## 三、常见问题 -| 现象 | 原因 | 解决方案 | -| :--: | :--: | :-- | - -## 四、值班记录 -| 日期 | 值班人 | 事件 | 处理 | -| :--: | :--: | :--: | :--: | -``` diff --git "a/docs/11-\345\221\250\346\212\245\344\270\216\345\244\215\347\233\230/README.md" "b/docs/11-\345\221\250\346\212\245\344\270\216\345\244\215\347\233\230/README.md" deleted file mode 100644 index d50d83b50557b61827eb6d4772fe1a437bd31a9e..0000000000000000000000000000000000000000 --- "a/docs/11-\345\221\250\346\212\245\344\270\216\345\244\215\347\233\230/README.md" +++ /dev/null @@ -1,125 +0,0 @@ -# 11 · 周报与复盘 - -## 🎯 阶段目标 - -通过**日报、周报、阶段复盘**持续跟踪项目状态、沉淀经验教训、形成组织过程资产。 - -## 📝 必含章节 - -| 文档 | 必含内容 | 必含配图 | -| :--: | :-- | :--: | -| 日报 | 今日完成 / 今日计划 / 阻塞 | 进度截图 | -| 周报 | 本周亮点 / 数据 / 下周计划 | 燃尽图 | -| 月报 | 月度总结 + 关键指标 | 仪表盘 | -| 复盘 | 做得好的 / 改进的 / 行动项 | 不需要 | - -## 📂 命名规范 - -``` -日报-YYYY-MM-DD.md -周报-W{n}-YYYY.md -复盘-<阶段名>.md -``` - -示例： -- `日报-2026-07-15.md` -- `周报-W3-2026.md` -- `复盘-需求阶段.md` - -## 🖼 配图要求 - -- 燃尽图（Burndown Chart） -- 进度截图（任务看板） -- 仪表盘（完成率、工时分布） -- 复盘文档可不配图 - -## 📦 产出物清单 - -- [ ] 每日日报（每人 1 份，共 14 周） -- [ ] 每周周报（每组 1 份，共 14 份） -- [ ] 阶段复盘（需求 / 开发 / 联调 / 上线 各 1 份） -- [ ] 项目总复盘（结项前） - -## ✍️ 日报模板 - -```markdown -# 日报 - YYYY-MM-DD - -**成员**：XXX（全栈开发 / 实施运维） - -## 今日完成 -- [x] 任务1（关联 issue 链接） -- [x] 任务2 - -## 今日计划 -- [ ] 任务3 -- [ ] 任务4 - -## 阻塞与求助 -- 无 / 阻塞点：xxx，需要 xxx 支持 - -## 明日计划 -- [ ] 任务5 -- [ ] 任务6 - -## 进度截图 -（插入任务看板截图） -``` - -## ✍️ 周报模板 - -```markdown -# 周报 - W{n} - YYYY - -**组别**：1班1组 -**周期**：YYYY-MM-DD ~ YYYY-MM-DD -**撰写人**：（填写） - -## 一、本周亮点 -- ... - -## 二、关键数据 -| 指标 | 本周 | 累计 | -| :--: | :--: | :--: | -| 完成任务 | 12 | 56 | -| 新增 Bug | 3 | 18 | -| 修复 Bug | 5 | 15 | -| 文档产出 | 8 | 32 | - -## 三、燃尽图 -（插入 sprint 燃尽图） - -## 四、本周明细 -| 成员 | 完成任务 | 文档 | 工时 | -| :--: | :-- | :-- | :--: | - -## 五、风险与求助 -| 风险 | 等级 | 求助 | -| :--: | :--: | :--: | - -## 六、下周计划 -| 任务 | 负责人 | 验收标准 | -| :--: | :--: | :-- | -``` - -## ✍️ 复盘模板 - -```markdown -# 复盘 - <阶段名> - -**时间**：YYYY-MM-DD -**参与人**：（填写） - -## 一、做得好的（Keep） -- ... - -## 二、做得不好的（Problem） -- ... - -## 三、改进的（Try） -- ... - -## 四、行动项 -| 行动 | 负责人 | 截止日期 | 状态 | -| :--: | :--: | :--: | :--: | -``` diff --git a/docs/README.md b/docs/README.md deleted file mode 100644 index 2b54dbe74cdb5c69ac68b88990606ee6ffd06a6c..0000000000000000000000000000000000000000 --- a/docs/README.md +++ /dev/null @@ -1,248 +0,0 @@ -# 📚 项目文档总索引 - -> 本目录是 **仿飞书应用** 项目的**文档总入口**，按"项目生命周期 12 阶段"组织。 -> 所有过程性文档**必须**遵循"md + 完整配图"的硬性要求（详见 [README.md 文档规范](../README.md#-文档规范强约束)）。 - ---- - -## 一、文档体系总览 - -``` -docs/ -├── README.md ← 📍 你在这里（文档总索引） -│ -├── 00-项目概览/ 基线文档：立项、章程、范围 -├── 01-需求分析/ SRS、用户故事、业务流程 -├── 02-原型设计/ 高保真原型、交互说明、设计规范 -├── 03-技术选型/ ADR、对比矩阵、PoC 验证 -├── 04-数据库设计/ ER 图、表结构、索引、DDL -├── 05-接口设计/ OpenAPI、时序图、错误码 -├── 06-前端开发/ 组件/页面/模块的实现文档 -├── 07-后端开发/ 服务/接口/领域的实现文档 -├── 08-联调测试/ 测试用例、Bug 清单、性能报告 -├── 09-部署上线/ Dockerfile、CI/CD、回滚方案 -├── 10-运维手册/ 监控、告警、Runbook、备份恢复 -└── 11-周报与复盘/ 日报、周报、阶段复盘 -``` - -> 🖼 **配图要求**：每个阶段目录下的 `README.md` 顶部都明确标注了本阶段文档的 **最小配图数**（5 ~ 8 张），请严格遵守。 - ---- - -## 二、12 阶段快速导航 - -| 阶段 | 目录 | 核心产出 | 最小配图 | 负责人方向 | -| :--: | :-- | :-- | :--: | :--: | -| 00 | [项目概览](00-项目概览/) | 项目立项书、章程、干系人 | ≥ 3 | 组长 + 全栈 + 运维 | -| 01 | [需求分析](01-需求分析/) | SRS、用户故事、流程图 | ≥ 5 | 全栈开发 | -| 02 | [原型设计](02-原型设计/) | 高保真原型、交互说明 | ≥ 8 | 全栈开发（前端） | -| 03 | [技术选型](03-技术选型/) | ADR、对比矩阵、PoC | ≥ 5 | 全栈开发 | -| 04 | [数据库设计](04-数据库设计/) | ER 图、表结构、DDL | ≥ 5 | 全栈开发（后端） | -| 05 | [接口设计](05-接口设计/) | OpenAPI、时序图、错误码 | ≥ 5 | 全栈开发 | -| 06 | [前端开发](06-前端开发/) | 每组件/页面的实现文档 | **≥ 8** | 全栈开发 | -| 07 | [后端开发](07-后端开发/) | 每服务/接口的实现文档 | ≥ 6 | 全栈开发 | -| 08 | [联调测试](08-联调测试/) | 测试报告、Bug 清单 | ≥ 6 | 全栈开发 | -| 09 | [部署上线](09-部署上线/) | 部署手册、CI/CD、回滚 | ≥ 6 | **实施运维** | -| 10 | [运维手册](10-运维手册/) | 监控、告警、Runbook | ≥ 5 | **实施运维** | -| 11 | [周报与复盘](11-周报与复盘/) | 日报、周报、复盘 | 视情况 | 全员 | - -> 💡 **双线提示**：阶段 09、10 偏重"实施运维方向"，阶段 06、07 偏重"全栈开发方向"，阶段 11 是全员必做。 - ---- - -## 二·、多端覆盖一览 - -> 仿飞书应用 **6 端同步交付**，前端代码统一出自 `frontend/` 下的 5 个子工程。 - -| 端 | 形态 | 输出目录 | 编译工具 | -| :--: | :--: | :--: | :--: | -| 💻 PC 网页端 | Web | `frontend/pc-web/` | Vite | -| 🖥️ PC 客户端 | Desktop | `frontend/pc-client/` | Electron / Tauri | -| 📱 移动 H5 | Web | `frontend/mobile-h5/` | Uni-app | -| 📲 微信小程序 | Mini Program | `frontend/mini-program/` | Uni-app 编译 → 微信开发者工具 | -| 🍎 iOS App | App | `frontend/mobile-app/` | Uni-app 编译 | -| 🤖 Android App | App | `frontend/mobile-app/` | Uni-app 编译 | - -> 💡 **小程序特别说明**：微信小程序有自己的一套 API（`wx.*`），与 H5/App 不完全通用。Uni-app 抹平了大部分差异，但**部分原生能力**（如蓝牙、扫码）仍需用条件编译 `#ifdef MP-WEIXIN` 单独处理。 - -## 三、文档完成度跟踪表 - -> 📌 各组在每周周报中同步本表进度。`[ ]` 未开始 / `[~]` 进行中 / `[x]` 已完成。 - -### 3.1 阶段文档（每个阶段必须有 `README.md` + 至少 1 篇正文） - -| 阶段 | 状态 | 文档数 | 配图数 | 最近更新 | -| :--: | :--: | :--: | :--: | :-- | -| 00 项目概览 | [x] | / | / | 立项时 | -| 01 需求分析 | [ ] | 0 | 0 | | -| 02 原型设计 | [ ] | 0 | 0 | | -| 03 技术选型 | [ ] | 0 | 0 | | -| 04 数据库设计 | [ ] | 0 | 0 | | -| 05 接口设计 | [ ] | 0 | 0 | | -| 06 前端开发 | [ ] | 0 | 0 | | -| 07 后端开发 | [ ] | 0 | 0 | | -| 08 联调测试 | [ ] | 0 | 0 | | -| 09 部署上线 | [ ] | 0 | 0 | | -| 10 运维手册 | [ ] | 0 | 0 | | -| 11 周报与复盘 | [ ] | 0 | 0 | | - -### 3.2 业务模块文档覆盖度（按 12 业务模块跟踪） - -| 业务模块 | 需求 | 原型 | 选型 | 库表 | 接口 | 前端 | 后端 | 测试 | 部署 | -| :-- | :--: | :--: | :--: | :--: | :--: | :--: | :--: | :--: | :--: | -| 用户中心 | [ ] | [ ] | - | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | -| 通讯录 | [ ] | [ ] | - | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | -| 即时通讯 IM | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | -| 协同文档 | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | -| 视频会议 | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | -| 日历 | [ ] | [ ] | - | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | -| 审批 OA | [ ] | [ ] | - | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | -| 云盘 | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | -| 应用中心 | [ ] | [ ] | - | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | -| 消息通知 | [ ] | [ ] | - | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | -| 管理后台 | [ ] | [ ] | - | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | -| 开放平台 | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | - -> 💡 技术选型（03）和部署（09）通常是"通用型"全局文档，不一定每个模块单独写；具体看各阶段 README 模板说明。 - -### 3.3 整体进度 - -- **当前阶段**：W1 - 立项阶段 -- **总文档目标**：≥ 80 篇（按 12 模块 × 6 关键阶段估算） -- **已完成**：0 篇 -- **完成率**：0 % - ---- - -## 四、文档命名规范总则 - -### 4.1 通用规则 - -``` -<阶段编号>-<阶段名>-<模块名>-<文档主题>.md -``` - -示例： -- `01-需求分析-IM-消息已读未读.md` -- `04-数据库设计-用户中心-用户表.md` -- `06-前端开发-IM-消息列表组件.md` - -### 4.2 特殊命名 - -| 类型 | 命名 | 示例 | -| :-- | :-- | :-- | -| 阶段索引 | `<编号>-<阶段名>/README.md` | `01-需求分析/README.md` | -| 全局文档 | `<编号>-<阶段名>-<主题>.md` | `04-数据库设计-全局ER图.md` | -| 阶段总结 | `<编号>-<阶段名>-总结报告.md` | `08-联调测试-总结报告.md` | -| 日报 | `日报-YYYY-MM-DD.md` | `日报-2026-07-15.md` | -| 周报 | `周报-W{n}-YYYY.md` | `周报-W3-2026.md` | -| 复盘 | `复盘-<阶段名>.md` | `复盘-需求阶段.md` | - -### 4.3 命名禁忌 - -- ❌ 不要用中文空格、特殊符号（`!@#$%^&*`） -- ❌ 不要用纯中文标题（如 `消息列表组件.md`）→ 应是 `06-前端开发-IM-消息列表组件.md` -- ❌ 不要把"日志/笔记"放进 `docs/`，应放到 `docs/11-周报与复盘/` - ---- - -## 五、文档配图规范总则 - -### 5.1 配图硬性要求 - -- **每个过程**都必须有**完整、具体**的配图 -- 截图必须**清晰**（1080P+），关键位置用**红框/箭头**标注 -- 每篇文档**最少配图数**见上表第二列（5 ~ 8 张） - -### 5.2 配图存放 - -``` -docs/<阶段>/images/<文档同名>.png -``` - -示例： -- `docs/01-需求分析/images/01-需求分析-IM-消息已读未读-业务流程.png` -- `docs/06-前端开发/images/06-前端开发-IM-消息列表组件-运行截图.png` - -### 5.3 配图类型与推荐工具 - -| 类型 | 用途 | 推荐工具 | -| :--: | :-- | :--: | -| 架构图 | 系统/模块整体架构 | draw.io / ProcessOn | -| 流程图 | 业务流程、状态机 | draw.io / Visio | -| 时序图 | 接口调用、消息流转 | draw.io / PlantUML | -| 类图 | 领域模型、UML | draw.io / StarUML | -| ER 图 | 数据库表关系 | DBeaver / Navicat / draw.io | -| 界面截图 | 高保真原型、运行效果 | Snipaste / FSCapture | -| 代码截图 | 关键逻辑 | VS Code / 微信截图 | -| 监控截图 | Grafana Dashboard | Grafana 自带 | -| 性能曲线 | JMeter / Locust 报告 | JMeter / Locust | - -### 5.4 配图禁忌 - -- ❌ 不要用手机随手拍电脑屏幕（模糊不清） -- ❌ 不要把图片直接贴到飞书/语雀再导出（会失真） -- ❌ 不要省略对图片的说明文字（每张图下方要有一句话解释） - ---- - -## 六、文档评审流程 - -### 6.1 评审触发 - -- 每个阶段结束时（建议 W2、W4、W6、W8、W10、W12、W14） -- 每个业务模块 PR 合并前 -- 每次重大变更后 - -### 6.2 评审检查清单 - -每篇文档评审时，评审人必须对照以下清单： - -- [ ] 文件名是否符合命名规范 -- [ ] 是否包含本阶段 README 模板中的所有必含章节 -- [ ] 配图是否齐全（达到最小配图数） -- [ ] 配图是否清晰、有标注 -- [ ] 关键代码是否有注释 -- [ ] 关联文档（需求 → 设计 → 代码 → 测试）是否在文末给出链接 -- [ ] 变更记录是否更新 - -### 6.3 评审人 - -| 文档类型 | 一审 | 二审 | -| :-- | :--: | :--: | -| 需求文档 | 全栈开发组员互审 | 组长 | -| 前端文档 | 全栈开发组员互审 | 组长 | -| 后端文档 | 全栈开发组员互审 | 组长 | -| 部署/运维文档 | 实施运维组员互审 | 组长 | -| 立项/章程/周报 | 组长 | 指导老师 | - ---- - -## 七、文档贡献者（占位，待填） - -> 每位组员维护自己的"文档贡献清单"，每周五周报同步。 - -| 序号 | 姓名 | 方向 | 负责模块 | 累计文档数 | 累计配图数 | -| :--: | :--: | :--: | :--: | :--: | :--: | -| 1 | （填写） | 全栈开发 | （填写） | 0 | 0 | -| 2 | （填写） | 全栈开发 | （填写） | 0 | 0 | -| 3 | （填写） | 全栈开发 | （填写） | 0 | 0 | -| 4 | （填写） | 全栈开发 | （填写） | 0 | 0 | -| 5 | （填写） | 实施运维 | （填写） | 0 | 0 | -| 6 | （填写） | 实施运维 | （填写） | 0 | 0 | - ---- - -## 八、文档更新日志 - -| 版本 | 日期 | 更新人 | 更新内容 | -| :--: | :--: | :-- | :-- | -| v1.0 | 2026-07-02 | 系统生成 | 创建文档总索引 | - ---- - -## 九、相关链接 - -- [项目 README](../README.md) -- [项目立项书](00-项目概览/项目立项书.md) -- [Gitee Issues](https://gitee.com/) ← 反馈 / 提问入口 diff --git "a/\345\206\257\345\271\277\346\201\272/20260706.md" "b/\345\206\257\345\271\277\346\201\272/20260706.md" new file mode 100644 index 0000000000000000000000000000000000000000..e10a64ef7c33a96719a17371090377661af31733 --- /dev/null +++ "b/\345\206\257\345\271\277\346\201\272/20260706.md" @@ -0,0 +1,4 @@ +# 工作进度 + + +## 今天完成了飞书系统的大量功能。并且都有效果实现，但因为前端效果太朴素，今天大部分时间重现对于前端页面的美化制作，利于了ai和图形处理工具，以及Claude code 工具，因为对于图形工具还不够熟练，只完成项目的一半进度 \ No newline at end of file diff --git "a/\345\206\257\345\271\277\346\201\272/20260707.md" "b/\345\206\257\345\271\277\346\201\272/20260707.md" new file mode 100644 index 0000000000000000000000000000000000000000..c4be533dfc0317e34a42c1d0702c5db8111fa460 --- /dev/null +++ "b/\345\206\257\345\271\277\346\201\272/20260707.md" @@ -0,0 +1,10 @@ +# 今日份报告 + + + + +## 今天利用豆包，deepseek，minimax我将前端的页面已经全部完成，并且远达预期，非常美观。 在组长的鼓舞下，我将尝试后端的接入，并且已经着手去做了 + +### ![今日任务](冯广恺\日报图片\屏幕截图 2026-07-07 172723.png) +### ![今日任务](冯广恺\日报图片\屏幕截图 2026-07-07 172736.png) +### ![今日任务](冯广恺\日报图片\屏幕截图 2026-07-07 172745.png) diff --git "a/\345\206\257\345\271\277\346\201\272/\346\227\245\346\212\245\345\233\276\347\211\207/\345\261\217\345\271\225\346\210\252\345\233\276 2026-07-07 172723.png" "b/\345\206\257\345\271\277\346\201\272/\346\227\245\346\212\245\345\233\276\347\211\207/\345\261\217\345\271\225\346\210\252\345\233\276 2026-07-07 172723.png" new file mode 100644 index 0000000000000000000000000000000000000000..5a7d77954629d5bec0f90282466bda81c48e2509 Binary files /dev/null and "b/\345\206\257\345\271\277\346\201\272/\346\227\245\346\212\245\345\233\276\347\211\207/\345\261\217\345\271\225\346\210\252\345\233\276 2026-07-07 172723.png" differ diff --git "a/\345\206\257\345\271\277\346\201\272/\346\227\245\346\212\245\345\233\276\347\211\207/\345\261\217\345\271\225\346\210\252\345\233\276 2026-07-07 172736.png" "b/\345\206\257\345\271\277\346\201\272/\346\227\245\346\212\245\345\233\276\347\211\207/\345\261\217\345\271\225\346\210\252\345\233\276 2026-07-07 172736.png" new file mode 100644 index 0000000000000000000000000000000000000000..9a7f1d454991016a80bb40f98e7ed3d03ea3817d Binary files /dev/null and "b/\345\206\257\345\271\277\346\201\272/\346\227\245\346\212\245\345\233\276\347\211\207/\345\261\217\345\271\225\346\210\252\345\233\276 2026-07-07 172736.png" differ diff --git "a/\345\206\257\345\271\277\346\201\272/\346\227\245\346\212\245\345\233\276\347\211\207/\345\261\217\345\271\225\346\210\252\345\233\276 2026-07-07 172745.png" "b/\345\206\257\345\271\277\346\201\272/\346\227\245\346\212\245\345\233\276\347\211\207/\345\261\217\345\271\225\346\210\252\345\233\276 2026-07-07 172745.png" new file mode 100644 index 0000000000000000000000000000000000000000..e5542cc96bfdef9cb86b246ff7b08d40ae7cab43 Binary files /dev/null and "b/\345\206\257\345\271\277\346\201\272/\346\227\245\346\212\245\345\233\276\347\211\207/\345\261\217\345\271\225\346\210\252\345\233\276 2026-07-07 172745.png" differ