From 43c2dc0d8d7c04cc7673c98044e9165fac394bde Mon Sep 17 00:00:00 2001 From: wangzzpeng <1032675359@qq.com> Date: Mon, 28 Sep 2026 10:47:49 +0800 Subject: [PATCH] =?UTF-8?q?=E6=81=A2=E5=A4=8D=E4=BF=AE=E6=94=B9=E7=9A=84?= =?UTF-8?q?=E6=95=B0=E6=8D=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/api/auth.ts | 80 +-- src/api/cases.ts | 291 +++------ src/api/demand.ts | 192 +++++- src/api/home.ts | 261 +++----- src/api/profile.ts | 44 +- src/api/project.ts | 169 +++-- src/components/AppFooter.vue | 28 +- src/components/AppHeader.vue | 30 +- src/components/CaseCard.vue | 166 +++-- src/layout/index.vue | 19 +- src/router/routes.ts | 5 +- src/stores/modules/cases.ts | 226 ++++++- src/stores/modules/demand.ts | 321 ++++++++-- src/stores/modules/home.ts | 248 ++++++- src/stores/modules/project.ts | 121 +++- src/stores/modules/user.ts | 36 +- src/styles/mixins.less | 23 + src/styles/variables.less | 28 +- src/types/business/cases.d.ts | 261 +++++++- src/types/business/demand.d.ts | 195 +++++- src/types/business/home.d.ts | 197 +++++- src/types/business/project.d.ts | 307 ++++++++- src/types/business/user.d.ts | 15 + src/types/router.d.ts | 7 + src/utils/format.ts | 29 +- src/utils/request.ts | 41 ++ src/views/cases/cpns/CaseDetailHeader.vue | 247 +++---- src/views/cases/cpns/CaseRichText.vue | 71 +- src/views/cases/cpns/CasesFilter.vue | 640 +++++++++++++------ src/views/cases/cpns/CasesGrid.vue | 33 +- src/views/cases/detail.vue | 64 +- src/views/cases/index.ts | 2 + src/views/cases/index.vue | 114 +++- src/views/demand/index.ts | 9 +- src/views/demand/index.vue | 226 ++++--- src/views/home/cpns/HomeBusinessCards.vue | 95 ++- src/views/home/cpns/HomeCaseShowcase.vue | 135 +++- src/views/home/cpns/HomeQuickEntries.vue | 165 ++++- src/views/home/cpns/HomeStats.vue | 21 +- src/views/home/cpns/HomeWelcome.vue | 55 +- src/views/home/detail.vue | 28 +- src/views/home/index.ts | 4 + src/views/home/index.vue | 59 +- src/views/login/index.vue | 5 +- src/views/login/register.vue | 46 +- src/views/project/after-sales.vue | 10 +- src/views/project/cpns/ProjectAfterSales.vue | 4 +- src/views/project/cpns/ProjectFiles.vue | 6 +- src/views/project/cpns/ProjectFilter.vue | 470 +++++++++++--- src/views/project/cpns/ProjectFinance.vue | 10 +- src/views/project/cpns/ProjectInfoCard.vue | 3 +- src/views/project/cpns/ProjectMilestones.vue | 2 +- src/views/project/cpns/ProjectTable.vue | 182 +++--- src/views/project/cpns/ProjectTeam.vue | 2 +- src/views/project/detail.vue | 22 +- src/views/project/index.ts | 2 + src/views/project/index.vue | 127 ++-- 57 files changed, 4557 insertions(+), 1642 deletions(-) diff --git a/src/api/auth.ts b/src/api/auth.ts index b7b1267..cbbae6f 100644 --- a/src/api/auth.ts +++ b/src/api/auth.ts @@ -1,14 +1,55 @@ +import { request, CLIENT_ID } from '@/utils/request' +import type { LoginResult as AuthLoginResult, RegisterResult } from '@/types/business/auth' import type { - LoginByAccountParams, LoginBySmsParams, LoginResult, - RegisterParams, ResetPasswordParams, User, } from '@/types/business/user' import { isPhone, isValidPassword } from '@/utils/validate' -// TODO(api): 待接口文档到位后，将以下 mock 替换为 request 调用（页面 → store → api 数据流不变） +/** + * PC 端 clientId（sys_client 种子数据，grantType 含 password）。 + * 与请求头 clientid 同源（见 @/utils/request），改一处即可整体生效。 + */ +export const PC_CLIENT_ID = CLIENT_ID + +/** + * 账号密码登录：POST /auth/login + * 后端要求请求体含 clientId + grantType + username + password（api-decrypt 未开启，明文即可） + */ +export function loginByAccountApi(data: { username: string; password: string }): Promise { + return request({ + url: '/auth/login', + method: 'post', + data: { + username: data.username, + password: data.password, + clientId: PC_CLIENT_ID, + grantType: 'password', + }, + }) +} + +/** + * 账号密码注册：POST /auth/register + * userType=sys_user；需后端开启注册开关（sys.account.registerUser=true），否则返回「当前系统没有开启注册功能！」 + */ +export function registerByAccountApi(data: { username: string; password: string }): Promise { + return request({ + url: '/auth/register', + method: 'post', + data: { + username: data.username, + password: data.password, + userType: 'sys_user', + clientId: PC_CLIENT_ID, + grantType: 'password', + }, + }) +} + +// TODO(api): 以下为原 mock 逻辑（保留，待后端对应接口就绪后替换） const SIX_DIGIT_CODE = /^\d{6}$/ @@ -18,26 +59,6 @@ export function sendSmsCode(phone: string): Promise { return Promise.resolve() } -/** 账号密码登录（mock：demo 账号可登录，其余提示先注册） */ -export function loginByAccount(params: LoginByAccountParams): Promise { - const { account, password } = params - if (!account.trim() || !password) { - return Promise.reject(new Error('请输入账号和密码')) - } - if (account === 'demo') { - const user: User = { - id: 'u1', - nickname: '王永志', - avatar: '', - phone: '186****618', - email: 'yongzh******4@163.com', - passwordModifiedAt: '', - } - return Promise.resolve({ token: `mock-token-${Date.now()}`, user }) - } - return Promise.reject(new Error('登录失败，请先注册账号')) -} - /** 手机验证码登录（mock：验证码须为 6 位数字） */ export function loginBySms(params: LoginBySmsParams): Promise { const { phone, code } = params @@ -69,19 +90,6 @@ function validateAuthForm( return null } -/** 注册 */ -export function register(params: RegisterParams): Promise { - const message = validateAuthForm( - params.phone, - params.code, - params.password, - params.confirmPassword, - params.agree, - ) - if (message) return Promise.reject(new Error(message)) - return Promise.resolve() -} - /** 重置密码 */ export function resetPassword(params: ResetPasswordParams): Promise { const message = validateAuthForm( diff --git a/src/api/cases.ts b/src/api/cases.ts index a38f337..ba9bde9 100644 --- a/src/api/cases.ts +++ b/src/api/cases.ts @@ -1,227 +1,90 @@ -import type { BusinessType, PageResult } from '@/types/api' -import type { Case, CaseQuery, ScaleRange } from '@/types/business/cases' +// 案例库接口（真实后端绑定） +// 后端: vermis-maker com.ruoyi.vermins.controller.pc.web.ProjectCaseUserController +// 前缀: /web/projectCase +// +// 使用约定（与项目 SKILL.md 一致）： +// 页面/组件禁止直接 import axios，一律经 store 调用本模块的 request。 +// 本文件只放「函数签名 + 请求路径」，不做数据加工、不维护状态。 +import { request, serializeQuery } from '@/utils/request' +import type { + CaseSelectionModel, + ProjectCaseAndCaseCountVo, + ProjectCaseUserBo, + ProjectCaseVo, +} from '@/types/business/cases' -// TODO(api): 待接口文档到位后，将以下 mock 替换为 request 调用 - -/** 案例 mock（可变，收藏状态在前端内存中翻转演示） */ -const MOCK_CASES: Case[] = [ - { - id: 'case-001', - title: '自动化生产线升级改造项目', - category: 'manufacturing', - cover: '', - finishDate: '2026/8/10', - teamSize: 50, - scale: '300万', - industry: '自动化', - duration: '150个工作日', - clientType: '企业', - background: '传统产线效率低、人工依赖高，客户需要通过自动化升级提升产能与品控水平。', - painPoints: '1、产线依赖人工巡检，异常响应慢；2、设备数据孤岛，缺乏统一监控；3、工艺参数无法追溯。', - requirements: '建设产线数据采集与监控平台，完成关键工位自动化改造，打通 MES 系统接口。', - deliverables: '1、产线自动化改造方案；2、PLC 控制程序与上位机软件；3、数据看板与运维手册；4、培训与质保服务。', - video: '', - isFavorite: false, - }, - { - id: 'case-002', - title: '智能工厂物联网整体解决方案', - category: 'iot', - cover: '', - finishDate: '2026/8/10', - teamSize: 30, - scale: '500万', - industry: '工厂服务', - duration: '200个工作日', - clientType: '企业', - background: '园区工厂多系统独立运行，能耗与设备管理粗放，需要整体数字化升级。', - painPoints: '1、门禁/监控/能耗子系统数据不互通；2、能源浪费缺乏精细监测；3、决策缺少实时数据支撑。', - requirements: '构建 IoT 平台接入设备数据，建设综合驾驶舱，实现能耗监测与智能告警。', - deliverables: '1、IoT 接入平台；2、综合驾驶舱大屏；3、能耗分析系统；4、集成联调与培训服务。', - video: '', - isFavorite: false, - }, - { - id: 'case-003', - title: '智能穿戴设备PCB设计与量产', - category: 'hardware', - cover: '', - finishDate: '2026/8/10', - teamSize: 50, - scale: '10-50万', - industry: '智能设备', - duration: '30个工作日', - clientType: '企业', - background: '客户推出新一代智能穿戴产品，需要高集成度低功耗 PCB 设计并快速量产。', - painPoints: '1、板载空间受限，器件布局密集；2、功耗要求严格；3、量产良率需爬坡。', - requirements: '完成原理图与 PCB 设计、打样验证、SMT 贴片与整机装配量产。', - deliverables: '1、原理图与 PCB 设计文件；2、样板与测试报告；3、量产良率报告；4、BOM 与工艺文件。', - video: '', - isFavorite: false, - }, - { - id: 'case-004', - title: '智能园区综合管理平台开发', - category: 'internet', - cover: '', - finishDate: '2026/8/10', - teamSize: 20, - scale: '200万', - industry: '园区服务', - duration: '200个工作日', - clientType: '企业', - background: '传统园区管理普遍"数据孤岛"，安防、能耗、物业、招商等系统独立运行，缺乏联动，管理手段依赖人工巡检和纸质流程。', - painPoints: '1、运营效率低下：安保依赖人工巡逻；2、系统孤岛严重：门禁、监控、停车、能耗等子系统独立建设；3、能源浪费突出；4、服务体验欠佳；5、决策缺乏依据；6、安全隐患犹存。', - requirements: '打造集"感知、预警、分析、决策、服务"于一体的智能园区综合管理平台，打通园区各子系统壁垒，实现全场景数字化覆盖。', - deliverables: '1、Web 端管理平台（驾驶舱/安防/能源/物业）；2、移动端服务门户；3、IoT 平台与数据大屏；4、全套技术文档；5、培训与不少于1年免费质保。', - video: '', - isFavorite: false, - }, - { - id: 'case-005', - title: '电商中台系统定制开发', - category: 'internet', - cover: '', - finishDate: '2026/7/20', - teamSize: 15, - scale: '150万', - industry: '电商零售', - duration: '120个工作日', - clientType: '企业', - background: '品牌方多渠道订单分散，库存与会员数据不通，需要统一电商中台。', - painPoints: '1、多平台库存不同步；2、会员体系割裂；3、营销活动上线周期长。', - requirements: '建设商品/库存/订单/会员中台，开放 API 对接主流电商平台。', - deliverables: '1、中台系统与管理后台；2、开放 API 与对接文档；3、数据迁移方案；4、上线陪跑服务。', - video: '', - isFavorite: false, - }, - { - id: 'case-006', - title: '教培机构在线学习平台', - category: 'internet', - cover: '', - finishDate: '2026/6/30', - teamSize: 12, - scale: '80万', - industry: '教育培训', - duration: '90个工作日', - clientType: '企业', - background: '教培机构需要线上授课、作业批改与学员管理一体化能力。', - painPoints: '1、授课依赖第三方工具，数据不沉淀；2、续费转化缺少数据支撑。', - requirements: '交付直播授课、题库作业、班级管理、数据分析完整平台（Web + 小程序）。', - deliverables: '1、Web 学习平台；2、学员端小程序；3、题库与直播模块；4、运维部署手册。', - video: '', - isFavorite: false, - }, - { - id: 'case-007', - title: '医院智能随访系统开发', - category: 'internet', - cover: '', - finishDate: '2026/5/18', - teamSize: 18, - scale: '250万', - industry: '医疗健康', - duration: '180个工作日', - clientType: '企业', - background: '三甲医院需要对出院患者进行结构化随访，提升复诊率与科研数据质量。', - painPoints: '1、电话随访效率低；2、随访数据非结构化，科研难复用。', - requirements: '建设随访计划引擎、患者端触达与随访数据仓，对接 HIS 系统。', - deliverables: '1、随访管理平台；2、患者端小程序；3、HIS 对接中间件；4、随访报表与数据字典。', - video: '', - isFavorite: false, - }, - { - id: 'case-008', - title: '园区光伏能耗管理系统', - category: 'iot', - cover: '', - finishDate: '2026/4/25', - teamSize: 10, - scale: '120万', - industry: '能源环保', - duration: '60个工作日', - clientType: '企业', - background: '园区部署屋顶光伏后需要实时监控发电与用电，实现削峰填谷。', - painPoints: '1、发电数据分散在多品牌逆变器；2、能耗缺少分项计量。', - requirements: '接入逆变器/电表数据，建设发电与能耗看板，输出节能策略。', - deliverables: '1、能耗采集网关适配；2、监控看板系统；3、告警与报表；4、验收测试报告。', - video: '', - isFavorite: false, - }, -] - -const SCALE_BOUNDS: Record = { - lt50w: [0, 50], - '50to100w': [50, 100], - '100to300w': [100, 300], - '300to500w': [300, 500], - gt500w: [500, Number.POSITIVE_INFINITY], -} - -/** 从展示值解析规模数值（万），如 '300万' → 300，'10-50万' → 10 */ -function parseScaleValue(scale: string): number { - const value = Number.parseFloat(scale) - return Number.isNaN(value) ? 0 : value -} - -function matchScale(item: Case, selected: ScaleRange[]): boolean { - if (selected.length === 0) return true - const value = parseScaleValue(item.scale) - return selected.some((key) => { - const [min, max] = SCALE_BOUNDS[key] - return value >= min && value < max +/** + * 案例库分页列表（返回列表 + 业务数据统计）。 + * + *

规模区间是嵌套对象（`scales[0].lowerLimit`），必须用 serializeQuery 序列化—— + * axios 默认的 `scales[0][lowerLimit]` 后端绑不上，实测 HTTP 500。

+ * + * @param bo 筛选条件（businessTypes 按案例表 business_type 原值匹配） + * @param pageNum 页码，从 1 开始（后端 PageQuery） + * @param pageSize 每页条数 + */ +export function getCaseList( + bo: ProjectCaseUserBo, + pageNum: number, + pageSize: number, +): Promise { + return request({ + url: '/web/projectCase/list', + method: 'get', + params: { ...bo, pageNum, pageSize }, + paramsSerializer: { serialize: serializeQuery }, }) } -function matchDate(item: Case, range: [string, string] | null): boolean { - if (!range) return true - const time = new Date(item.finishDate).getTime() - const start = new Date(range[0]).getTime() - const end = new Date(range[1]).getTime() - return time >= start && time <= end -} - -function applyFilters(query: CaseQuery): Case[] { - return MOCK_CASES.filter((item) => { - if (query.category !== 'all' && item.category !== query.category) return false - if (query.industries.length > 0 && !query.industries.includes(item.industry)) return false - if (!matchScale(item, query.scales)) return false - if (!matchDate(item, query.dateRange)) return false - if (query.keyword && !item.title.includes(query.keyword)) return false - return true +/** + * 案例详情（含项目背景富文本与附件，并回填当前用户是否已收藏）。 + * + *

注意：该接口每次调用都会把案例预览量 +1，勿在轮询 / 重试场景滥用。

+ */ +export function getCaseDetail(id: string): Promise { + return request({ + url: `/web/projectCase/${id}`, + method: 'get', }) } -/** 案例列表（筛选 + 分页） */ -export function getCaseList(query: CaseQuery): Promise> { - const filtered = applyFilters(query) - const start = (query.page - 1) * query.pageSize - return Promise.resolve({ - list: filtered.slice(start, start + query.pageSize), - total: filtered.length, +/** + * 案例收藏 / 取消收藏。 + * + *

后端为 toggle 语义：已收藏则取消收藏。需登录态，匿名调用会被后端拦截。

+ */ +export function collectCase(id: string): Promise { + return request({ + url: '/web/projectCase/collect', + method: 'post', + data: { id }, }) } -/** 案例详情（不存在返回 null） */ -export function getCaseDetail(id: string): Promise { - const found = MOCK_CASES.find((item) => item.id === id) ?? null - return Promise.resolve(found) +/** + * 筛选面板选项（业务类型统计 + 行业 + 规模档位）。 + * + *

左侧筛选除完成时间外的选项都由本接口一次下发：业务类型与案例总数在 + * {@code projectCaseStatisticsVo}，行业在 {@code businessIndustry}，规模在 + * {@code upperAndLowerLimits}（label 已由后端拼好）。

+ */ +export function getCaseCategories(): Promise { + return request({ + url: '/web/projectCase/categories', + method: 'get', + }) } -/** 收藏/取消收藏，返回最新案例数据 */ -export function toggleFavorite(id: string): Promise { - const found = MOCK_CASES.find((item) => item.id === id) - if (!found) return Promise.reject(new Error('案例不存在')) - found.isFavorite = !found.isFavorite - return Promise.resolve({ ...found }) -} - -/** 业务类型计数（筛选面板角标） */ -export function getCaseCounts(): Promise>> { - const counts: Partial> = {} - for (const item of MOCK_CASES) { - counts[item.category] = (counts[item.category] ?? 0) + 1 - } - return Promise.resolve(counts) +/** + * 案例浏览王（首页「案例库精选」）。 + * + *

不传 type 时返回「各业务类型的浏览王」各一条；传 type 时按案例表 + * business_type 的原值精确匹配，返回该类型全部案例。

+ */ +export function getFeaturedCases(type?: string): Promise { + return request({ + url: '/web/projectCase/mostViewed', + method: 'get', + params: type ? { type } : undefined, + }) } diff --git a/src/api/demand.ts b/src/api/demand.ts index f35d9f2..bb40589 100644 --- a/src/api/demand.ts +++ b/src/api/demand.ts @@ -1,25 +1,183 @@ -import type { Demand } from '@/types/business/demand' -import { storage } from '@/utils/storage' +// 需求提报接口（真实后端绑定） +// 草稿 com.ruoyi.vermins.controller.pc.web.WorkUserOrderDraftController → /web/workOrderDraft +// 提交 com.ruoyi.vermins.controller.pc.web.ProjectRequirementUserController → /web/requirementPool/create（WorkOrderDraftBo） +// 同控制器的 /submit（RdProjectBo）是直接提报入口（额外落 vm_rd_project），前端当前未使用 +// 业务类型 com.ruoyi.vermins.controller.pc.ProjectSubmissionWebController → /web/projectSubmission（@SaIgnore 免登录） +// 预算范围 org.dromara.system.controller.system.SysDictDataController → /system/dict/data/type/{dictType} +// 图片换链 org.dromara.resource.controller.SysOssController → /resource/oss/listByIds/{ids} +// 鉴权：业务类型列表免登录；草稿 / 提交 / 字典 / OSS 需登录态（匿名实测 401，故 /demand 路由带 requiresAuth） +// +// 使用约定（与项目 SKILL.md 一致）： +// 页面/组件禁止直接 import axios，一律经 store 调用本模块；本文件只放「函数签名 + 请求路径」。 +import service, { request } from '@/utils/request' +import type { ApiResponse } from '@/types/api' +import type { + Demand, + DemandDraftVo, + DictOption, + OssUploadVo, + OssUrlVo, + SubmissionBizTypeVo, +} from '@/types/business/demand' -// TODO(api): 待接口文档到位后，将以下 mock 替换为 request 调用（页面 → store → api 数据流不变） +/** 业务类型字典类型（sys_dict_type.dict_type）——仅作提报列表为空时的兜底值域 */ +export const BIZ_TYPE_DICT = 'vm_biz_type' +/** 预算范围字典类型 */ +export const BUDGET_RANGE_DICT = 'vm_budget_range' -const DRAFT_KEY = 'demand-draft' +/** + * 业务类型列表（项目提报表，**免登录**）。 + * + *

后端 `ProjectSubmissionWebController` 带 `@SaIgnore`，是需求页唯一匿名可用的接口； + * 它与首页 `/web/home-page/service-type-list` 共用同一个 `queryEnabledList()`，只返回 + * `enabled = 1` 且未被逻辑删除的记录。

+ * + *

返回项里 `subtitle` 是卡片描述来源、`logoUrl` 是卡片图标来源（实测是 OSS 文件标识， + * 需经 {@link getOssUrls} 换链）。

+ */ +export function getSubmissionBizTypes(): Promise { + return request({ + url: '/web/projectSubmission/list', + method: 'get', + }) +} -/** 提交需求（mock：返回提报单 id） */ -export function submitDemand(demand: Demand): Promise<{ id: string }> { - if (!demand.businessType || !demand.projectName || !demand.coreDescription) { - return Promise.reject(new Error('需求信息不完整，无法提交')) +/** + * OSS 文件标识 → 可直接访问的地址。 + * + *

提报列表的 `coverUrl` / `logoUrl` 下发的是 OSS 主键（如 2099753406859292674）而非地址， + * 直接当 `` 用会请求到本站的错误路径上，必须换链。

+ * + *

⚠️ 本接口需要登录态；失败时调用方回退前端内置图标，且不阻塞页面。

+ */ +export function getOssUrls(ids: (string | number)[]): Promise { + return request({ + url: `/resource/oss/listByIds/${ids.join(',')}`, + method: 'get', + }) +} + +/** + * 业务类型字典（`vm_biz_type`）。 + * + *

⚠️ 仅作**兜底**用：业务类型值域已改为提报列表 {@link getSubmissionBizTypes}； + * 只有当提报表一条可用记录都没有时，store 才回退到本字典，避免页面无可选项。

+ */ +export function getBizTypeDict(): Promise { + return request({ + url: `/system/dict/data/type/${BIZ_TYPE_DICT}`, + method: 'get', + }) +} + +/** 预算范围选项（字典 vm_budget_range） */ +export function getBudgetRangeDict(): Promise { + return request({ + url: `/system/dict/data/type/${BUDGET_RANGE_DICT}`, + method: 'get', + }) +} + +/** + * 读取当前登录用户的需求提报草稿（无草稿返回 null）。 + * + *

⚠️ 后端 `WorkUserOrderDraftController#getDraft` 在"该用户还没有草稿"时会 NPE： + * `VmWorkOrderDraftServiceImpl#queryById` 里 `draft` 为 null 仍继续执行 `draft.getId()`， + * 实测返回 code=500「发生未知异常」。这里刻意绕过统一 `request`（它会对非 200 弹错误提示）， + * 直接用原始实例静默兜底：非 200 一律视作"无草稿"。后端补上判空后本段可简化。

+ */ +export async function getDraftDemand(): Promise { + const resp = await service.request>({ + url: '/web/workOrderDraft/getDraft', + method: 'get', + }) + if (resp.data?.code !== 200) return null + return resp.data.data ?? null +} + +/** + * Demand → 后端 `WorkOrderDraftBo` 请求体。 + * + *

显式列出 BO 的字段，**剔掉纯前端字段 `budgetManual`**（后端 BO/VO 与两张表都没有 + * 「是否手写」的概念，留着虽然会被 Jackson 忽略，但容易被误读成后端支持该标记）。

+ * + *

预算范围只有一个字段可下发：预设档位是字典 dictValue，手写时是用户填的金额文本 + * ——后端没有可用的 `budgetCustom`（`WorkOrderDraftBo` 里被注释掉、表也无该列）。

+ * + *

`developmentCycle` 是 Integer，表单未填时是空串，必须归一成 null：空串虽然能靠 + * Jackson 的宽松转换塞进去，但依赖默认行为、且语义上是"没填"。

+ */ +function toBoPayload(demand: Demand): Record { + return { + id: demand.id, + userName: demand.userName, + userPhone: demand.userPhone, + bizType: demand.bizType, + budgetRange: demand.budgetRange, + developmentCycle: demand.developmentCycle === '' ? null : demand.developmentCycle, + supplementaryRemarks: demand.supplementaryRemarks, + projectName: demand.projectName, + requirementDesc: demand.requirementDesc, + attachmentInfo: demand.attachmentInfo, } - return Promise.resolve({ id: `demand-${Date.now()}` }) } -/** 读取本地草稿（无草稿返回 null） */ -export function getDraftDemand(): Promise { - return Promise.resolve(storage.sessionGet(DRAFT_KEY)) -} - -/** 保存草稿到本地 */ +/** 新增/覆盖草稿（后端 insertByBo 按登录用户 upsert） */ export function saveDraft(demand: Demand): Promise { - storage.sessionSet(DRAFT_KEY, { ...demand, status: 'draft' }) - return Promise.resolve() + return request({ + url: '/web/workOrderDraft/add', + method: 'post', + data: toBoPayload(demand), + }) +} + +/** 清空当前用户的草稿（后端 cleanHistoryDrafts） */ +export function resetDraft(): Promise { + return request({ + url: '/web/workOrderDraft/reset', + method: 'post', + }) +} + +/** 上传附件（multipart，后端字段名 file，返回 SysOssVo） */ +export function uploadDemandFile(file: File): Promise { + const data = new FormData() + data.append('file', file) + return request({ + url: '/web/workOrderDraft/upload', + method: 'post', + data, + headers: { 'Content-Type': 'multipart/form-data' }, + }) +} + +/** + * 提交需求（`POST /web/requirementPool/create`）。 + * + *

入参与草稿共用同一个 BO（`WorkOrderDraftBo`），故请求体直接复用 {@link toBoPayload}， + * 不需要字段名转换。

+ * + *

后端 `createRequirement` 一个事务里做三件事：

+ *
    + *
  • 落 `vm_project_requirement`（需求主记录，生成项目编号、优先级=未评估、状态=待接洽）；
    • + *
  • 把**请求体里的 `attachmentInfo`** 逐条复制成需求附件（只复制 `ossId` 引用到 + * `vm_project_requirement_attachment`，OSS 文件不重复上传）——注意这里是直接吃请求体， + * 不像 `/submit` 那样还得先落一次草稿，所以附件随本次请求一起走；
    • + *
  • 清掉该用户的草稿（`cleanHistoryDrafts`）。
    • + *
+ * + *

后端必填校验：`bizType` / `projectName` / `requirementDesc` 任一为空返回 + * 「请完整填写业务类型、项目名称和需求描述」；联系人姓名与电话缺失时先回退登录用户资料， + * 仍为空则报「请完善联系人姓名和联系电话」。

+ * + *

⚠️ 本条链路**只落 `vm_project_requirement` 单表**。而「我的项目/需求」列表 + * （`/web/requirementPool/list`）查的是 `vm_rd_project`，因此 create 提交的记录不会出现在 + * 该列表里——要同时落两张表得走后端 `/web/requirementPool/submit`（`RdProjectBo`）。

+ */ +export function submitDemand(demand: Demand): Promise { + return request({ + url: '/web/requirementPool/create', + method: 'post', + data: toBoPayload(demand), + }) } diff --git a/src/api/home.ts b/src/api/home.ts index 5adde7d..5bd904e 100644 --- a/src/api/home.ts +++ b/src/api/home.ts @@ -1,180 +1,97 @@ -import type { BusinessType } from '@/types/api' -import type { Case } from '@/types/business/cases' -import type { BusinessLine, HomeStats, ServiceType } from '@/types/business/home' +// 首页接口（真实后端绑定） +// 后端: vermis-maker com.ruoyi.vermins.controller.pc.web.UserSideWebHomePageController +// 前缀: /web/home-page 鉴权: 公开接口，无需 token +// 门户入口: com.ruoyi.vermins.controller.pc.web.IPortalEntryUserController（首页快捷入口功能，并入本文件） +// +// 使用约定（与项目 SKILL.md 一致）： +// 页面/组件禁止直接 import axios，一律经 store 调用本模块的 request。 +// 本文件只放「函数签名 + 请求路径」，不写业务逻辑。 +import { request } from '@/utils/request' +import type { + AgreementFormVo, + BannerVo, + PortalEntryGroup, + PortalEntryVo, + ProjectStatusCount, + ProjectSubmissionInfo, + ProjectSubmissionVo, +} from '@/types/business/home' -// TODO(api): 待接口文档到位后，将以下 mock 返回替换为 request 调用（页面 → store → api 数据流不变） - -const SERVICE_TYPES: ServiceType[] = [ - { label: 'Web应用', desc: '响应式 Web 与后台管理系统定制开发' }, - { label: '小程序', desc: '微信/支付宝小程序开发与上架' }, - { label: 'APP', desc: 'iOS/Android 移动应用定制开发' }, - { label: '二次开发', desc: '基于现有系统的功能扩展与重构' }, - { label: '桌面工具', desc: '跨平台桌面端工具与自动化软件' }, -] - -const SERVICE_CONTENT = `一、产品咨询与规划服务 -1、业务诊断与梳理：深入调研客户现有业务流程，识别数字化痛点与改进机会。 -2、竞品分析与市场调研：分析行业标杆产品，提炼差异化竞争优势。 -3、产品定位与MVP规划：明确核心用户群体，规划最小可行性产品（MVP）功能集，制定迭代路线图。 -4、技术可行性评估：评估所选技术栈的成熟度、扩展性及与现有系统的兼容性。 -二、UI/UX 设计服务 -1、用户研究与体验地图：构建用户画像，梳理用户旅程，优化关键触点体验。 -2、交互原型设计：制作高保真可交互原型，直观展示产品逻辑与操作流程，支持早期验证。 -3、视觉UI设计：遵循最新设计趋势与品牌规范，输出图标、界面、动效等视觉元素。 -4、设计规范与组件库：建立统一的设计系统（Design System），确保多端体验一致性，提升后续迭代效率。 -三、技术开发服务 -5、前端开发：基于 React/Vue/Flutter 等框架，实现响应式Web、H5、小程序及跨平台移动端应用。 -6、后端开发：采用 Spring Cloud、Node.js、Go 等微服务架构，构建高并发、高可用的业务接口与逻辑。 -7、数据库设计：根据业务特性设计关系型（MySQL）与非关系型（Redis、MongoDB）数据库集群方案。 -8、DevOps 与云服务部署：搭建 CI/CD 自动化流水线，基于 Docker/K8s 进行容器化部署，保障系统弹性伸缩。 -四、质量保障（QA）服务 -1、功能测试：覆盖单元测试、集成测试、系统测试及UAT（用户验收测试）支持。 -2、性能测试：进行压力测试、负载测试，定位系统瓶颈，优化响应速度。 -3、安全测试：实施渗透测试、漏洞扫描，保障数据安全与隐私合规。 -4、兼容性测试：覆盖主流浏览器、操作系统及移动设备型号。 -五、运维与持续运营服务 -1、7x24小时监控：实时监控系统健康度、流量及异常日志。 -2、数据运营分析：接入埋点系统，输出用户行为分析报告，指导产品优化。 -3、迭代升级：基于用户反馈与业务增长需求，提供持续的功能迭代与版本更新。` - -const BUSINESS_LINES: BusinessLine[] = [ - { - id: 'internet', - name: '互联网软件', - desc: 'Web/小程序/APP/二次开发/桌面工具等', - slogan: '专业的软件定制开发服务，从需求到上线全流程保障', - icon: '', - serviceContent: SERVICE_CONTENT, - serviceTypes: SERVICE_TYPES, - video: '', - }, - { - id: 'hardware', - name: '硬件电路', - desc: '原理图设计/PCB设计/电气效验等', - slogan: '专业的硬件电路设计服务，从方案到量产全流程保障', - icon: '', - serviceContent: SERVICE_CONTENT, - serviceTypes: SERVICE_TYPES, - video: '', - }, - { - id: 'iot', - name: '物联网全案', - desc: '软硬件开发+云端一体化/定制化开发等', - slogan: '专业的物联网软硬一体化服务，从感知到云端全流程保障', - icon: '', - serviceContent: SERVICE_CONTENT, - serviceTypes: SERVICE_TYPES, - video: '', - }, - { - id: 'manufacturing', - name: '生产制造', - desc: 'PCB制版/SMT/整机装配/定制生产等', - slogan: '专业的研发智造生产服务，从制版到交付全流程保障', - icon: '', - serviceContent: SERVICE_CONTENT, - serviceTypes: SERVICE_TYPES, - video: '', - }, -] - -const FEATURED_CASES: Case[] = [ - { - id: 'case-001', - title: '自动化生产线升级改造项目', - category: 'manufacturing', - cover: '', - finishDate: '2026/8/10', - teamSize: 50, - scale: '300万', - industry: '自动化', - duration: '150个工作日', - clientType: '企业', - background: '传统产线效率低、人工依赖高，客户需要通过自动化升级提升产能与品控水平。', - painPoints: '1、产线依赖人工巡检，异常响应慢；2、设备数据孤岛，缺乏统一监控；3、工艺参数无法追溯。', - requirements: '建设产线数据采集与监控平台，完成关键工位自动化改造，打通 MES 系统接口。', - deliverables: '1、产线自动化改造方案；2、PLC 控制程序与上位机软件；3、数据看板与运维手册；4、培训与质保服务。', - video: '', - isFavorite: false, - }, - { - id: 'case-002', - title: '智能工厂物联网整体解决方案', - category: 'iot', - cover: '', - finishDate: '2026/8/10', - teamSize: 30, - scale: '500万', - industry: '工厂服务', - duration: '200个工作日', - clientType: '企业', - background: '园区工厂多系统独立运行，能耗与设备管理粗放，需要整体数字化升级。', - painPoints: '1、门禁/监控/能耗子系统数据不互通；2、能源浪费缺乏精细监测；3、决策缺少实时数据支撑。', - requirements: '构建 IoT 平台接入设备数据，建设综合驾驶舱，实现能耗监测与智能告警。', - deliverables: '1、IoT 接入平台；2、综合驾驶舱大屏；3、能耗分析系统；4、集成联调与培训服务。', - video: '', - isFavorite: false, - }, - { - id: 'case-003', - title: '智能穿戴设备PCB设计与量产', - category: 'hardware', - cover: '', - finishDate: '2026/8/10', - teamSize: 50, - scale: '10-50万', - industry: '智能设备', - duration: '30个工作日', - clientType: '企业', - background: '客户推出新一代智能穿戴产品，需要高集成度低功耗 PCB 设计并快速量产。', - painPoints: '1、板载空间受限，器件布局密集；2、功耗要求严格；3、量产良率需爬坡。', - requirements: '完成原理图与 PCB 设计、打样验证、SMT 贴片与整机装配量产。', - deliverables: '1、原理图与 PCB 设计文件；2、样板与测试报告；3、量产良率报告；4、BOM 与工艺文件。', - video: '', - isFavorite: false, - }, - { - id: 'case-004', - title: '智能园区综合管理平台开发', - category: 'internet', - cover: '', - finishDate: '2026/8/10', - teamSize: 20, - scale: '200万', - industry: '园区服务', - duration: '200个工作日', - clientType: '企业', - background: '随着新型城镇化建设的加速和"数字中国"战略的深入推进，传统园区管理模式正面临严峻挑战，普遍存在"数据孤岛"现象。', - painPoints: '1、运营效率低下：安保依赖人工巡逻；2、系统孤岛严重：门禁、监控、停车等子系统独立建设；3、能源浪费突出；4、服务体验欠佳；5、决策缺乏依据；6、安全隐患犹存。', - requirements: '打造集"感知、预警、分析、决策、服务"于一体的智能园区综合管理平台，打通园区各子系统壁垒。', - deliverables: '1、Web 端管理平台（驾驶舱/安防/能源/物业）；2、移动端服务门户；3、IoT 平台与数据大屏；4、全套技术文档；5、培训与不少于1年免费质保。', - video: '', - isFavorite: false, - }, -] - -/** 首页数据看板 */ -export function getHomeStats(): Promise { - return Promise.resolve({ pending: 3, inProgress: 3, total: 6 }) +/** 项目状态统计 */ +export function getProjectStatusCount(): Promise { + return request({ + url: '/web/home-page/project-status-count', + method: 'get', + }) } -/** 业务线列表（首页 4 卡片） */ -export function getBusinessLines(): Promise { - return Promise.resolve(BUSINESS_LINES) +/** 业务服务类型列表 */ +export function getServiceTypeList(): Promise { + return request({ + url: '/web/home-page/service-type-list', + method: 'get', + }) } -/** 业务详情（业务详情页） */ -export function getBusinessDetail(type: BusinessType): Promise { - const found = BUSINESS_LINES.find((line) => line.id === type) - return Promise.resolve(found ?? BUSINESS_LINES[0]!) +/** 业务类型详情（聚合 VO：projectSubmission / projectServiceType / projectSubmissionAttachment / projectSubmissionCatalog） */ +export function getServiceTypeDetail(id: number | string): Promise { + return request({ + url: `/web/home-page/service-type-detail/${id}`, + method: 'get', + }) } -/** 首页案例精选（category=all 时返回全部） */ -export function getFeaturedCases(category: BusinessType | 'all' = 'all'): Promise { - const list = category === 'all' - ? FEATURED_CASES - : FEATURED_CASES.filter((item) => item.category === category) - return Promise.resolve(list) +/** 轮播图列表 */ +export function getCarouselList(): Promise { + return request({ + url: '/web/home-page/carousel-list', + method: 'get', + }) +} + +/** 平台介绍（富文本 HTML） */ +export function getPlatformIntro(): Promise { + return request({ + url: '/web/home-page/platform-intro', + method: 'get', + }) +} + +/** 联系信息（富文本 HTML） */ +export function getContactInfo(): Promise { + return request({ + url: '/web/home-page/contact-info', + method: 'get', + }) +} + +// 首页「案例库精选」接口（/web/projectCase/mostViewed）按资源归位到 `@/api/cases` 的 getFeaturedCases。 + +/** + * 查询用户门户入口列表 + * + *

登录态返回该用户个性化后的分组结果；匿名返回固定目录。 + * 两组数据由 groupType 区分（1 = 快捷、0 = 其他）。

+ */ +export function getPortalEntryList(): Promise { + return request({ + url: '/vermins/portalEntryUser/list', + method: 'get', + }) +} + +/** + * 快捷 / 其他入口互转 + * + *

后端 add 的入参是 @RequestParam，必须走 query 而非 body。

+ * + * @param id 入口 id + * @param type 目标分组：1 = 快捷、0 = 其他 + */ +export function switchPortalEntryGroup(id: number, type: PortalEntryGroup): Promise { + return request({ + url: '/vermins/portalEntryUser/add', + method: 'post', + params: { id, type }, + }) } diff --git a/src/api/profile.ts b/src/api/profile.ts index 06b5017..0b3e7b8 100644 --- a/src/api/profile.ts +++ b/src/api/profile.ts @@ -168,12 +168,15 @@ const MOCK_FAVORITES: Case[] = [ industry: '自动化', duration: '150个工作日', clientType: '企业', - background: '传统产线效率低、人工依赖高，客户需要通过自动化升级提升产能与品控水平。', - painPoints: '1、产线依赖人工巡检，异常响应慢；2、设备数据孤岛，缺乏统一监控；3、工艺参数无法追溯。', - requirements: '建设产线数据采集与监控平台，完成关键工位自动化改造，打通 MES 系统接口。', - deliverables: '1、产线自动化改造方案；2、PLC 控制程序与上位机软件；3、数据看板与运维手册；4、培训与质保服务。', + sections: [ + { title: '项目背景', content: '

传统产线效率低、人工依赖高，客户需要通过自动化升级提升产能与品控水平。

' }, + { title: '客户痛点', content: '

1、产线依赖人工巡检，异常响应慢；2、设备数据孤岛，缺乏统一监控；3、工艺参数无法追溯。

' }, + { title: '需求描述', content: '

建设产线数据采集与监控平台，完成关键工位自动化改造，打通 MES 系统接口。

' }, + { title: '交付物', content: '

1、产线自动化改造方案；2、PLC 控制程序与上位机软件；3、数据看板与运维手册；4、培训与质保服务。

' }, + ], video: '', isFavorite: true, + favoriteCount: 0, }, { id: 'fav-2', @@ -186,12 +189,15 @@ const MOCK_FAVORITES: Case[] = [ industry: '工厂服务', duration: '200个工作日', clientType: '企业', - background: '园区工厂多系统独立运行，能耗与设备管理粗放，需要整体数字化升级。', - painPoints: '1、门禁/监控/能耗子系统数据不互通；2、能源浪费缺乏精细监测；3、决策缺少实时数据支撑。', - requirements: '构建 IoT 平台接入设备数据，建设综合驾驶舱，实现能耗监测与智能告警。', - deliverables: '1、IoT 接入平台；2、综合驾驶舱大屏；3、能耗分析系统；4、集成联调与培训服务。', + sections: [ + { title: '项目背景', content: '

园区工厂多系统独立运行，能耗与设备管理粗放，需要整体数字化升级。

' }, + { title: '客户痛点', content: '

1、门禁/监控/能耗子系统数据不互通；2、能源浪费缺乏精细监测；3、决策缺少实时数据支撑。

' }, + { title: '需求描述', content: '

构建 IoT 平台接入设备数据，建设综合驾驶舱，实现能耗监测与智能告警。

' }, + { title: '交付物', content: '

1、IoT 接入平台；2、综合驾驶舱大屏；3、能耗分析系统；4、集成联调与培训服务。

' }, + ], video: '', isFavorite: true, + favoriteCount: 0, }, { id: 'fav-3', @@ -204,12 +210,15 @@ const MOCK_FAVORITES: Case[] = [ industry: '智能设备', duration: '30个工作日', clientType: '企业', - background: '客户推出新一代智能穿戴产品，需要高集成度低功耗 PCB 设计并快速量产。', - painPoints: '1、板载空间受限，器件布局密集；2、功耗要求严格；3、量产良率需爬坡。', - requirements: '完成原理图与 PCB 设计、打样验证、SMT 贴片与整机装配量产。', - deliverables: '1、原理图与 PCB 设计文件；2、样板与测试报告；3、量产良率报告；4、BOM 与工艺文件。', + sections: [ + { title: '项目背景', content: '

客户推出新一代智能穿戴产品，需要高集成度低功耗 PCB 设计并快速量产。

' }, + { title: '客户痛点', content: '

1、板载空间受限，器件布局密集；2、功耗要求严格；3、量产良率需爬坡。

' }, + { title: '需求描述', content: '

完成原理图与 PCB 设计、打样验证、SMT 贴片与整机装配量产。

' }, + { title: '交付物', content: '

1、原理图与 PCB 设计文件；2、样板与测试报告；3、量产良率报告；4、BOM 与工艺文件。

' }, + ], video: '', isFavorite: true, + favoriteCount: 0, }, { id: 'fav-4', @@ -222,12 +231,15 @@ const MOCK_FAVORITES: Case[] = [ industry: '园区服务', duration: '200个工作日', clientType: '企业', - background: '传统园区管理普遍"数据孤岛"，安防、能耗、物业、招商等系统独立运行，缺乏联动，管理手段依赖人工巡检和纸质流程。', - painPoints: '1、运营效率低下：安保依赖人工巡逻；2、系统孤岛严重：门禁、监控、停车、能耗等子系统独立建设；3、能源浪费突出；4、服务体验欠佳；5、决策缺乏依据；6、安全隐患犹存。', - requirements: '打造集"感知、预警、分析、决策、服务"于一体的智能园区综合管理平台，打通园区各子系统壁垒，实现全场景数字化覆盖。', - deliverables: '1、Web 端管理平台（驾驶舱/安防/能源/物业）；2、移动端服务门户；3、IoT 平台与数据大屏；4、全套技术文档；5、培训与不少于1年免费质保。', + sections: [ + { title: '项目背景', content: '

传统园区管理普遍"数据孤岛"，安防、能耗、物业、招商等系统独立运行，缺乏联动，管理手段依赖人工巡检和纸质流程。

' }, + { title: '客户痛点', content: '

1、运营效率低下：安保依赖人工巡逻；2、系统孤岛严重：门禁、监控、停车、能耗等子系统独立建设；3、能源浪费突出；4、服务体验欠佳；5、决策缺乏依据；6、安全隐患犹存。

' }, + { title: '需求描述', content: '

打造集"感知、预警、分析、决策、服务"于一体的智能园区综合管理平台，打通园区各子系统壁垒，实现全场景数字化覆盖。

' }, + { title: '交付物', content: '

1、Web 端管理平台（驾驶舱/安防/能源/物业）；2、移动端服务门户；3、IoT 平台与数据大屏；4、全套技术文档；5、培训与不少于1年免费质保。

' }, + ], video: '', isFavorite: true, + favoriteCount: 0, }, ] diff --git a/src/api/project.ts b/src/api/project.ts index fdccd00..e0a516e 100644 --- a/src/api/project.ts +++ b/src/api/project.ts @@ -1,13 +1,124 @@ -import type { FileInfo, PageResult } from '@/types/api' +import type { FileInfo } from '@/types/api' import type { AfterSales, AfterSalesPayload, Project, + ProjectListResult, ProjectQuery, + ProjectStatistics, + RequirementDetailVo, } from '@/types/business/project' +import { request } from '@/utils/request' import { formatDate } from '@/utils/format' +import { toProjectDetail } from '@/utils/projectVo' -// TODO(api): 待接口文档到位后，将以下 mock 替换为 request 调用 +// ───────────────────────────────────────────────────────────────────────────── +// 列表：真实接口 +// GET /web/requirementPool/list → ProjectRequirementUserController#list +// → ProjectRequirementServiceImpl#queryUserPageList +// 入参 RdProjectBo + PageQuery；出参 ProjectRequirementAndCountVo +// { requirementPage: { total, rows: RdProjectVo[] }, requirementStatistics: null } +// 鉴权：需登录态（匿名 401）；每请求带 clientid 头（见 utils/request.ts 拦截器）。 +// 筛选参数实测（tools/probe_project_api.py）： +// key → like projectName OR projectNo OR requirementDesc +// businessType → eq business_type（值是提报表主键 id，不是类型名） +// status → eq status（码值，见 RdProjectStatus） +// beginTime/endTime → between create_time（不是 submit_time！） +// pageNum/pageSize → PageQuery +// ⚠️ 主表已改为**需求表** vm_project_requirement（LEFT JOIN 项目表），未立项的需求也会出现； +// 未立项行 progress 为 null（显示「—」）、status 回落需求表中的 INITIATING。 +// ⚠️ 列表行的 businessType 是 SQL 里 JOIN 提报表**翻译后的中文名称**（如「互联网软件」）， +// 与筛选参数 businessType（提报表 id）**不是同一口径**，渲染时不能用 typeCounts 反查。 +// ───────────────────────────────────────────────────────────────────────────── + +// ───────────────────────────────────────────────────────────────────────────── +// 业务类型筛选条件：真实接口 +// GET /web/requirementPool/getFilterConditions +// → ProjectRequirementUserController#getFilterConditions +// → ProjectRequirementServiceImpl#getFilterConditions +// 出参 ProjectRequirementStatisticsVo： +// { total: 该用户需求总数, +// businessTypeCounts: [{ businessTypeId, businessTypeLabel, count }] } +// 口径：**全量、不分页**，所以件数不会随 pageNum/pageSize 变化，适合当筛选栏的固定值域； +// businessTypeId = vm_project_submission 主键 id（直接回传当 businessType 筛选参数）； +// businessTypeLabel = 该表的 business_type 名称；提报表里没命中的脏数据不计入。 +// ⚠️ /list 响应里的 requirementStatistics 后端仍是注释状态（实测恒 null），统计一律走本端点。 +// ───────────────────────────────────────────────────────────────────────────── + +/** 两位补零 */ +function pad(value: number): string { + return String(value).padStart(2, '0') +} + +/** Date → 'yyyy-MM-dd HH:mm:ss'（后端 RdProjectBo.beginTime/endTime 是 Date，实测该格式可绑定） */ +function toDateTime(date: Date, endOfDay: boolean): string { + const ymd = `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}` + return `${ymd} ${endOfDay ? '23:59:59' : '00:00:00'}` +} + +/** + * 提交时间条件 → 后端 `beginTime` / `endTime`（都落在 `create_time` 上）。 + * + *

自选区间优先（UI 上两组互斥，这里再兜一层）；结束日一律补到 23:59:59， + * 否则 `endTime=2026-09-30` 会被绑成当天 00:00:00 而漏掉当天数据。

+ */ +function toTimeRange(query: ProjectQuery): { beginTime?: string; endTime?: string } { + if (query.startDate || query.endDate) { + return { + beginTime: query.startDate ? `${query.startDate} 00:00:00` : undefined, + endTime: query.endDate ? `${query.endDate} 23:59:59` : undefined, + } + } + if (query.timeShortcut === 'all') return {} + + const start = new Date() + if (query.timeShortcut === '3m') start.setMonth(start.getMonth() - 3) + else if (query.timeShortcut === '6m') start.setMonth(start.getMonth() - 6) + else start.setFullYear(start.getFullYear() - 1) + return { beginTime: toDateTime(start, false), endTime: toDateTime(new Date(), true) } +} + +/** 项目列表（真实接口：服务端筛选 + 分页；业务类型统计走 getProjectFilterConditions） */ +export function getProjectList(query: ProjectQuery): Promise { + return request({ + url: '/web/requirementPool/list', + method: 'get', + params: { + pageNum: query.pageNum, + pageSize: query.pageSize, + // 空串不出现在 querystring 里，与后端 eqIfText 的「有值才等值匹配」语义一致 + key: query.keyword || undefined, + businessType: query.businessType || undefined, + status: query.status || undefined, + ...toTimeRange(query), + }, + }) +} + +/** + * 业务类型筛选条件（左侧筛选栏「业务类型」的值域 + 件数）。 + * + *

与列表分开取：`/list` 的 `requirementStatistics` 后端恒为 null，统计由本端点单独下发， + * 且是**全量口径**（不随筛选、分页变化），所以进页面拉一次即可。

+ */ +export function getProjectFilterConditions(): Promise { + return request({ + url: '/web/requirementPool/getFilterConditions', + method: 'get', + }) +} + +// ───────────────────────────────────────────────────────────────────────────── +// 详情：真实接口 +// GET /web/requirementPool/get/{id} → ProjectRequirementUserController#get +// → ProjectRequirementServiceImpl#queryRequirementByUserId +// 出参 ProjectRequirementUserVo，经 utils/projectVo.ts 映射成详情页沿用的 Project 形态。 +// ⚠️ id 传的是**需求 id**（vm_project_requirement.id）= 列表行 RdProjectVo.id。 +// 未立项的需求也能查到（项目侧字段为空）；不存在 / 非本人 → 后端 data 为 null。 +// +// 文件 / 售后：**仍是前端 mock** —— 该 Controller 只有 create / list / get / +// serviceTypeList 四个接口，没有附件上传、售后提交/取消的后端实现。 +// ───────────────────────────────────────────────────────────────────────────── /** 构造 mock 文件信息 */ function mockFile(name: string, size: number, uploadTime: string): FileInfo { @@ -17,7 +128,7 @@ function mockFile(name: string, size: number, uploadTime: string): FileInfo { /** 详情 mock 所属项目 id */ const DETAIL_ID = 'project-004' -/** 项目列表 mock（6 条，覆盖全部状态，internet/iot 混合） */ +/** 项目列表 mock（6 条，覆盖全部状态，internet/iot 混合）——仅详情页链路在用 */ const MOCK_PROJECTS: Project[] = [ { id: 'project-001', @@ -176,49 +287,15 @@ const PROJECT_DETAIL: Project = { }, } -/** 提交时间快捷区间匹配 */ -function matchTimeShortcut(submitTime: string, shortcut: ProjectQuery['timeShortcut']): boolean { - if (shortcut === 'all') return true - // mock 时间为 '2026-8-17 14:00'，替换为 / 保证各环境可解析 - const time = new Date(submitTime.replaceAll('-', '/')).getTime() - const start = new Date() - if (shortcut === '3m') start.setMonth(start.getMonth() - 3) - if (shortcut === '6m') start.setMonth(start.getMonth() - 6) - if (shortcut === '1y') start.setFullYear(start.getFullYear() - 1) - return time >= start.getTime() -} - -/** 项目列表（筛选 + 分页，pageSize 固定 8） */ -export function getProjectList(query: ProjectQuery): Promise> { - const filtered = MOCK_PROJECTS.filter((item) => { - if ( - query.keyword - && !item.projectName.includes(query.keyword) - && !item.projectNo.includes(query.keyword) - ) { - return false - } - if (query.businessType !== 'all' && item.businessType !== query.businessType) return false - if (query.status !== 'all' && item.status !== query.status) return false - if (!matchTimeShortcut(item.submitTime, query.timeShortcut)) return false - return true - }) - const pageSize = query.pageSize > 0 ? query.pageSize : 8 - const start = (query.page - 1) * pageSize - return Promise.resolve({ - list: filtered.slice(start, start + pageSize), - total: filtered.length, - }) -} - -/** 项目详情（不存在返回 null；仅详情项目返回完整数据） */ +/** 项目详情（真实接口；不存在 / 非本人需求返回 null） */ export function getProjectDetail(id: string): Promise { - if (id === DETAIL_ID) return Promise.resolve({ ...PROJECT_DETAIL }) - const found = MOCK_PROJECTS.find((item) => item.id === id) ?? null - return Promise.resolve(found ? { ...found } : null) + return request({ + url: `/web/requirementPool/get/${id}`, + method: 'get', + }).then((vo) => (vo ? toProjectDetail(vo) : null)) } -/** 上传项目文件（追加进详情文件列表） */ +/** 上传项目文件（mock：追加进详情文件列表） */ export function uploadProjectFile(file: File): Promise { const info: FileInfo = { name: file.name, @@ -230,7 +307,7 @@ export function uploadProjectFile(file: File): Promise { return Promise.resolve({ ...info }) } -/** 删除项目文件（按索引从详情文件列表移除） */ +/** 删除项目文件（mock：按索引从详情文件列表移除） */ export function deleteProjectFile(index: number): Promise { if (index >= 0 && index < PROJECT_DETAIL.files.length) { PROJECT_DETAIL.files.splice(index, 1) @@ -238,7 +315,7 @@ export function deleteProjectFile(index: number): Promise { return Promise.resolve() } -/** 提交售后工单 */ +/** 提交售后工单（mock） */ export function submitAfterSales( projectId: string, payload: AfterSalesPayload, @@ -255,7 +332,7 @@ export function submitAfterSales( return Promise.resolve({ ...result, attachments: [...result.attachments] }) } -/** 取消售后工单 */ +/** 取消售后工单（mock） */ export function cancelAfterSales(projectId: string): Promise { const result: AfterSales = { status: '无', diff --git a/src/components/AppFooter.vue b/src/components/AppFooter.vue index bfc8cc8..c69916a 100644 --- a/src/components/AppFooter.vue +++ b/src/components/AppFooter.vue @@ -5,10 +5,10 @@ const siteStore = useSiteStore() const quickLinks = [ { label: '首页', path: '/' }, - { label: '案例中心', path: '/cases' }, - { label: '需求提报', path: '/demand' }, + { label: '案例库', path: '/cases' }, + { label: '需求池', path: '/demand' }, { label: '下载 APP', path: '/' }, - { label: '帮助中心', path: '/profile/help' }, + { label: '消息中心', path: '/message' }, ] const coreBusiness = [ @@ -40,6 +40,17 @@ const coreBusiness = [

+
+

+ 核心业务 +

+ {{ item }} +
+

快速导航 @@ -54,17 +65,6 @@ const coreBusiness = [

-
-

- 核心业务 -

- {{ item }} -
-

联系我们 diff --git a/src/components/AppHeader.vue b/src/components/AppHeader.vue index 45ce2f4..5201f5f 100644 --- a/src/components/AppHeader.vue +++ b/src/components/AppHeader.vue @@ -11,7 +11,7 @@ interface NavItem { const navItems: NavItem[] = [ { label: '首页', path: '/' }, { label: '案例库', path: '/cases' }, - { label: '需求提报', path: '/demand' }, + { label: '需求池', path: '/demand' }, { label: '项目中心', path: '/project' }, { label: '合同中心', path: '/contract' }, { label: '财务中心', path: '/finance' }, @@ -45,6 +45,12 @@ onMounted(() => void messageStore.fetchUnreadCount())
+ + 快速提报 + + + 在线客服 + 🔔 {{ unreadCount }} @@ -108,6 +114,28 @@ onMounted(() => void messageStore.fetchUnreadCount()) gap: @spacing-base; } + &__action { + .flex(row, center); + height: 28px; + padding: 0 @spacing-base; + border-radius: @radius-round; + color: @white; + font-size: @font-size-sm; + transition: opacity 0.2s; + + &:hover { + opacity: 0.88; + } + + &--primary { + background: linear-gradient(90deg, @warning-color, @danger-color); + } + + &--success { + background: linear-gradient(90deg, #22b14c, @success-color); + } + } + &__bell { position: relative; diff --git a/src/components/CaseCard.vue b/src/components/CaseCard.vue index 5822a97..d6584b2 100644 --- a/src/components/CaseCard.vue +++ b/src/components/CaseCard.vue @@ -1,4 +1,5 @@ @@ -43,25 +68,22 @@ function onView(id: string): void { diff --git a/src/layout/index.vue b/src/layout/index.vue index 0056906..af095ae 100644 --- a/src/layout/index.vue +++ b/src/layout/index.vue @@ -1,15 +1,25 @@ @@ -18,6 +28,11 @@ import FloatingActions from './components/FloatingActions.vue' .layout { .layout__main { min-height: calc(100vh - @header-height - @footer-height); + + // 无底栏的页面：底栏不渲染，这里把它的占位高度还给内容区，避免页面底部空出一屏 + &--full { + min-height: calc(100vh - @header-height); + } } } diff --git a/src/router/routes.ts b/src/router/routes.ts index 6bc1b08..dcbda59 100644 --- a/src/router/routes.ts +++ b/src/router/routes.ts @@ -10,11 +10,12 @@ const layoutRoutes: RouteRecordRaw = { component: () => import('@/layout/index.vue'), children: [ // ── 公开 ── - { path: '', name: 'Home', component: () => import('@/views/home'), meta: { title: '首页' } }, + { path: '', name: 'Home', component: () => import('@/views/home'), meta: { title: '首页', footer: true } }, { path: 'business/:type', name: 'BusinessDetail', component: () => import('@/views/home/detail.vue'), meta: { title: '业务详情' } }, { path: 'cases', name: 'Cases', component: () => import('@/views/cases'), meta: { title: '成功案例库' } }, { path: 'cases/:id', name: 'CaseDetail', component: () => import('@/views/cases/detail.vue'), meta: { title: '案例详情' } }, - { path: 'demand', name: 'Demand', component: () => import('@/views/demand'), meta: { title: '需求提报' } }, + // 需求提报依赖登录态：字典 / 业务类型 / 草稿 / 上传 / 提交接口匿名实测均 401 + { path: 'demand', name: 'Demand', component: () => import('@/views/demand'), meta: { title: '需求提报', requiresAuth: true } }, // ── 登录区 ── { path: 'project', name: 'Project', component: () => import('@/views/project'), meta: { title: '项目中心', requiresAuth: true } }, diff --git a/src/stores/modules/cases.ts b/src/stores/modules/cases.ts index b7749c3..9264d35 100644 --- a/src/stores/modules/cases.ts +++ b/src/stores/modules/cases.ts @@ -1,41 +1,197 @@ import { defineStore } from 'pinia' import { ref } from 'vue' -import type { BusinessType, PageResult } from '@/types/api' -import type { Case, CaseQuery } from '@/types/business/cases' -import { getCaseCounts, getCaseDetail, getCaseList, toggleFavorite as toggleFavoriteApi } from '@/api/cases' +import type { + BusinessIndustryOption, + Case, + CaseQuery, + CaseTypeOption, + ProjectCaseStatisticsVo, + ProjectCaseUserBo, + ScaleLimit, +} from '@/types/business/cases' +import { collectCase, getCaseCategories, getCaseDetail, getCaseList } from '@/api/cases' +import { toCase } from '@/utils/caseVo' +import type { CaseTypeNameMap } from '@/utils/caseVo' + +/** + * 案例库数据（列表 / 筛选 / 分页 / 详情 / 收藏） + * + * 后端接口（ProjectCaseUserController，前缀 /web/projectCase）： + * - GET /list 列表（分页 + 跟随筛选条件的统计） + * - GET /categories 筛选面板选项（业务类型统计 + 所属行业 + 项目规模档位） + * - GET /{id} 详情（含项目背景富文本与附件，并回填 isFavorite） + * - POST /collect 收藏 / 取消收藏（toggle） + * + * ⚠️ 筛选面板**除完成时间外**的选项全部由后端下发，且**都来自 GET /categories**（一次请求）： + * - 业务类型：projectCaseStatisticsVo.projectCaseCounts（按项目提报表补全类型全集） + * - 案例总数：projectCaseStatisticsVo.total + * - 所属行业：businessIndustry + * - 项目规模：upperAndLowerLimits（label 已由后端拼好） + * 完成时间后端无对应选项接口，由前端按快捷区间 + 日期选择器生成。 + * + * ⚠️ 业务类型**下发的是提报主键 id**（不是类型名）：案例表 business_type 列实测存的就是 + * 该 id，传类型名后端按原值匹配不到（实测 total=0）。同一份 id→名称 字典还用于把列表 / + * 详情里的 id 翻译成展示名（见 typeNameById），否则标签会全部退化成「其他」。 + * + * 后端 VO 与页面字段的差异（命名、业务类型取值、富文本、数值单位）由 utils/caseVo 统一对齐。 + */ + +/** 每页条数（案例库为三列卡片栅格，9 = 3 行） */ +const PAGE_SIZE = 9 + +/** 结果数预探测的防抖时长（筛选面板改动后即时回显「N 个结果」） */ +const PROBE_DELAY = 300 function createDefaultQuery(): CaseQuery { return { - category: 'all', + categories: [], industries: [], scales: [], dateRange: null, + favoriteOnly: false, keyword: '', page: 1, - pageSize: 8, + pageSize: PAGE_SIZE, } } -/** 案例库数据（列表 / 筛选 / 分页 / 收藏） */ +/** 筛选面板给的是 yyyy-MM-dd，后端 Date 入参按 yyyy-MM-dd HH:mm:ss 补全 */ +function withTime(date: string, time: string): string { + return date.length === 10 ? `${date} ${time}` : date +} + +function trimmed(raw: string | null | undefined): string { + return (raw ?? '').trim() +} + +/** + * 业务类型统计 → 筛选面板选项。 + * + *

value 取**提报主键 id**（下发 businessTypes 用），label 取业务类型名称（展示用）。 + * 不按前端 BusinessType 枚举归一化，选项一律用后端下发的原值。

+ */ +function toTypeOptions(stats: ProjectCaseStatisticsVo | null): CaseTypeOption[] { + return (stats?.projectCaseCounts ?? []) + .map((item) => ({ + value: String(item.id ?? '').trim(), + label: trimmed(item.businessType), + count: item.caseCount ?? 0, + })) + .filter((item) => item.value.length > 0 && item.label.length > 0) +} + +/** 业务类型统计 → 「提报 id → 类型名」字典（供 utils/caseVo 翻译列表/详情的 business_type） */ +function toTypeNameMap(stats: ProjectCaseStatisticsVo | null): CaseTypeNameMap { + const map: CaseTypeNameMap = {} + for (const item of stats?.projectCaseCounts ?? []) { + const id = String(item.id ?? '').trim() + const name = trimmed(item.businessType) + if (id.length > 0 && name.length > 0) map[id] = name + } + return map +} + export const useCasesStore = defineStore('cases', () => { const query = ref(createDefaultQuery()) const list = ref([]) const total = ref(0) - const counts = ref>>({}) + /** 待提交条件的结果数（筛选面板改动后即时探测，仅用于「确定筛选（N 个结果）」） */ + const previewTotal = ref(0) + + /** 业务类型筛选项（接口下发：GET /categories 的统计；value=提报 id） */ + const typeOptions = ref([]) + /** 业务类型字典：提报 id → 类型名（列表/详情标签翻译 + 首页精选共用） */ + const typeNameById = ref({}) + /** 所属行业筛选项（接口下发：GET /categories） */ + const industryOptions = ref([]) + /** 项目规模筛选项（接口下发：GET /categories，label 由后端拼好） */ + const scaleOptions = ref([]) + /** 案例总数（全量口径，用于业务类型「全部」行角标） */ + const caseTotal = ref(0) + const currentCase = ref(null) + let probeTimer: ReturnType | null = null + + /** 页面筛选条件 → 后端查询条件（值均由接口下发，原样回传） */ + function buildQuery(input: CaseQuery): { + bo: ProjectCaseUserBo + pageNum: number + pageSize: number + } { + const bo: ProjectCaseUserBo = {} + if (input.categories.length > 0) { + // categories 存的已是提报主键 id（CaseTypeOption.value），直接下发 + bo.businessTypes = [...input.categories] + } + if (input.industries.length > 0) { + bo.businessIndustries = [...input.industries] + } + if (input.scales.length > 0) { + // 整档对象下发（后端接收 List），浅拷贝避免把响应式对象传出去 + bo.scales = input.scales.map((item) => ({ ...item })) + } + if (input.dateRange) { + bo.beginTime = withTime(input.dateRange[0], '00:00:00') + bo.endTime = withTime(input.dateRange[1], '23:59:59') + } + if (input.favoriteOnly) bo.isFavorite = 1 + const keyword = input.keyword.trim() + if (keyword) bo.key = keyword + return { bo, pageNum: input.page, pageSize: input.pageSize } + } + + /** + * 筛选面板选项：一次 GET /categories 取回三组 + 业务类型字典。 + * + *

后端 CaseSelectionModel 里同时带 projectCaseStatisticsVo，所以业务类型选项与案例总数 + * 无需再单独打一次 /list —— 这里的所有选项都是「全量口径」，不随当前筛选条件收缩。

+ */ + async function fetchCategories(): Promise { + const result = await getCaseCategories() + const stats = result.projectCaseStatisticsVo + typeOptions.value = toTypeOptions(stats) + typeNameById.value = toTypeNameMap(stats) + caseTotal.value = stats?.total ?? 0 + industryOptions.value = (result.businessIndustry ?? []).filter((item) => trimmed(item.name).length > 0) + scaleOptions.value = result.upperAndLowerLimits ?? [] + } + + /** + * 确保业务类型字典已就绪（幂等）。 + * + *

首页「案例库精选」的标签翻译同样依赖该字典 —— 从首页直接进入时， + * 案例库页自身的 fetchCategories 还没跑过，故由调用方（首页 store）显式确保。

+ */ + async function ensureCategories(): Promise { + if (typeOptions.value.length === 0) await fetchCategories() + } + + /** 列表取数 */ async function fetchCases(): Promise { - const result: PageResult = await getCaseList(query.value) - list.value = result.list - total.value = result.total + const { bo, pageNum, pageSize } = buildQuery(query.value) + const result = await getCaseList(bo, pageNum, pageSize) + list.value = (result.projectCasePage?.rows ?? []).map((vo) => toCase(vo, typeNameById.value)) + total.value = result.projectCasePage?.total ?? 0 + previewTotal.value = total.value } - async function fetchCounts(): Promise { - counts.value = await getCaseCounts() + /** 待提交条件的结果数（防抖，避免每次点击都打接口） */ + async function probeTotal(): Promise { + const { bo } = buildQuery(query.value) + const result = await getCaseList(bo, 1, 1) + previewTotal.value = result.projectCasePage?.total ?? 0 } + function scheduleProbe(): void { + if (probeTimer) clearTimeout(probeTimer) + probeTimer = setTimeout(() => void probeTotal(), PROBE_DELAY) + } + + /** 面板改条件（只改待提交条件，不取数；取数由「确定筛选」触发） */ function setQuery(next: CaseQuery): void { query.value = next + scheduleProbe() } /** 确定筛选（重置页码后取数） */ @@ -55,29 +211,61 @@ export const useCasesStore = defineStore('cases', () => { await fetchCases() } - async function fetchCaseDetail(id: string): Promise { - currentCase.value = await getCaseDetail(id) + /** 「收藏列表」开关：只筛已收藏案例 */ + async function toggleFavoriteOnly(): Promise { + query.value = { ...query.value, favoriteOnly: !query.value.favoriteOnly, page: 1 } + await fetchCases() } + /** 案例详情（后端查不到时返回 null，页面据此展示空态） */ + async function fetchCaseDetail(id: string): Promise { + const vo = await getCaseDetail(id) + currentCase.value = vo ? toCase(vo, typeNameById.value) : null + } + + /** + * 收藏 / 取消收藏。 + * + *

后端为 toggle 语义且不返回最新状态，这里按调用成功的结果本地翻转， + * 避免再调一次详情接口（该接口会自增预览量）。

+ */ async function toggleFavorite(id: string): Promise { - const updated = await toggleFavoriteApi(id) + await collectCase(id) const index = list.value.findIndex((item) => item.id === id) - if (index >= 0) list.value[index] = updated - if (currentCase.value?.id === id) currentCase.value = updated + if (index >= 0) { + const target = list.value[index] + const delta = target.isFavorite ? -1 : 1 + list.value[index] = { ...target, isFavorite: !target.isFavorite, favoriteCount: target.favoriteCount + delta } + } + if (currentCase.value?.id === id) { + const delta = currentCase.value.isFavorite ? -1 : 1 + currentCase.value = { + ...currentCase.value, + isFavorite: !currentCase.value.isFavorite, + favoriteCount: currentCase.value.favoriteCount + delta, + } + } } return { query, list, total, - counts, + previewTotal, + typeOptions, + typeNameById, + industryOptions, + scaleOptions, + caseTotal, currentCase, fetchCases, - fetchCounts, + fetchCategories, + ensureCategories, setQuery, search, resetQuery, changePage, + toggleFavoriteOnly, fetchCaseDetail, toggleFavorite, } diff --git a/src/stores/modules/demand.ts b/src/stores/modules/demand.ts index 6050737..62dd808 100644 --- a/src/stores/modules/demand.ts +++ b/src/stores/modules/demand.ts @@ -1,60 +1,266 @@ import { defineStore } from 'pinia' -import { ref } from 'vue' +import { computed, ref } from 'vue' import { ElMessage } from 'element-plus' -import type { Demand } from '@/types/business/demand' -import type { FileInfo } from '@/types/api' +import type { + BizTypeOption, + Demand, + DemandAttachment, + DemandDraftVo, + DictOption, +} from '@/types/business/demand' +import { + getBizTypeDict, + getBudgetRangeDict, + getDraftDemand, + getOssUrls, + getSubmissionBizTypes, + resetDraft as resetDraftApi, + saveDraft as saveDraftApi, + submitDemand, + uploadDemandFile, +} from '@/api/demand' +import { getUserProfile } from '@/api/user' +import { toAssetUrl } from '@/utils/asset' +import { toBizTypeOption, toBizTypeOptionFromDict } from '@/utils/bizTypeMeta' +import { isManualBudget, resolveDraftBudget } from '@/utils/budgetMeta' import { formatDate } from '@/utils/format' -import { getDraftDemand, saveDraft as saveDraftApi, submitDemand } from '@/api/demand' function createDefaultForm(): Demand { return { - businessType: 'internet', + id: null, + bizType: '', projectName: '', - attachments: [], - coreDescription: '', - expectedDuration: '', + requirementDesc: '', budgetRange: '', - userName: '王永志', - userPhone: '1866****9618', - remark: '', - status: 'draft', + budgetManual: false, + developmentCycle: '', + supplementaryRemarks: '', + userName: '', + userPhone: '', + attachmentInfo: [], } } -/** 需求提报数据（M3：表单 / 步骤 / 提交与草稿） */ +/** 字典按 dictSort 升序（后端已排序，前端再保一次序，避免脏序） */ +function sortDict(list: DictOption[] | null): DictOption[] { + return [...(list ?? [])].sort((a, b) => (a.dictSort ?? 0) - (b.dictSort ?? 0)) +} + +/** + * 草稿 VO → 表单。空值回退到 base（base 里已放入登录用户资料预填）， + * 否则草稿里的空 userName / userPhone 会把预填的联系人信息覆盖掉。 + * + *

预算范围要单独反推：后端只回传一个 `budgetRange` 字符串、没有「是否手写」的标记 + * （`budgetCustom` 恒为 null），故命中字典码值或文案即预设档位，否则视为手填文本。

+ */ +function mergeDraft(base: Demand, draft: DemandDraftVo, budgetDict: DictOption[]): Demand { + const budget = resolveDraftBudget(draft.budgetRange, budgetDict) + return { + id: draft.id ?? null, + bizType: draft.bizType || base.bizType, + projectName: draft.projectName || base.projectName, + requirementDesc: draft.requirementDesc || base.requirementDesc, + budgetRange: budget.value, + budgetManual: budget.manual, + developmentCycle: draft.developmentCycle ?? base.developmentCycle, + supplementaryRemarks: draft.supplementaryRemarks || base.supplementaryRemarks, + userName: draft.userName || base.userName, + userPhone: draft.userPhone || base.userPhone, + attachmentInfo: draft.attachmentInfo ?? [], + } +} + +/** + * 批量把 OSS 文件标识换成可访问地址。 + * + *

提报列表的 `logoUrl` 实测是 OSS 主键（如 2099753406859292674）。其中本身已是地址的 + * 直接跳过；接口需要登录态，失败时返回空映射，由调用方回退前端内置图标（不阻塞页面）。

+ */ +async function loadOssUrlMap(raws: (string | null)[]): Promise> { + const ids = [...new Set( + raws.map((item) => (item ?? '').trim()).filter((item) => item && !toAssetUrl(item)), + )] + if (ids.length === 0) return {} + try { + const list = await getOssUrls(ids) + return Object.fromEntries(list.map((item) => [String(item.ossId), item.url])) + } + catch { + return {} + } +} + +/** 需求提报数据（单页三段表单 + 真实接口：提报列表 / 字典 / 草稿 / 上传 / 提交） */ export const useDemandStore = defineStore('demand', () => { const form = ref(createDefaultForm()) - const step = ref(1) + /** 业务类型卡片选项（**完全由提报列表接口决定**：接口几条就几条，前端不追加任何兜底项） */ + const bizTypeOptions = ref([]) + /** 预算范围字典原始项（值域来源：vm_budget_range） */ + const budgetDict = ref([]) const loading = ref(false) + const saving = ref(false) + const submitting = ref(false) + const uploading = ref(false) - function setStep(next: number): void { - step.value = next + /** + * 预算范围选项：全部来自字典，只把「手填」项**固定排到最后**（设计稿要求末尾那一项是可输入的手填位）。 + * + *

不动字典的值域，只调顺序。渲染方式由 `DemandInfoForm` 决定：非手填项渲染成胶囊按钮， + * 手填项渲染成**同排第 5 个输入框**（占位文案即字典 label）。

+ */ + const budgetOptions = computed(() => { + const list = budgetDict.value + return [ + ...list.filter((item) => !isManualBudget(item.dictLabel)), + ...list.filter((item) => isManualBudget(item.dictLabel)), + ] + }) + + /** + * 业务类型选项：项目提报列表（免登录）→ logo 换链 → 映射卡片选项。 + * + *

值域**完全由接口决定**：接口返回几条就渲染几张卡，前端不追加任何兜底项 + * （包括「其他」——接口有才显示，没有就不显示）。

+ * + *

仅当提报接口**整体不可用**（请求异常）或一条可用记录都没有（全停用/全删除）时， + * 才回退字典 `vm_biz_type`。这仍是接口驱动的降级路径（不是前端凭空造值）， + * 目的是避免出现"一个业务类型都选不了、表单无法提交"的死局。

+ */ + async function loadBizTypeOptions(): Promise { + try { + const submissions = await getSubmissionBizTypes() + if (submissions.length > 0) { + const ossUrlById = await loadOssUrlMap(submissions.map((item) => item.logoUrl)) + const options = submissions + .map((item) => toBizTypeOption(item, ossUrlById)) + .filter((item): item is BizTypeOption => item !== null) + if (options.length > 0) return options + } + } + catch { + // 提报接口不可用时落到字典兜底，避免整页初始化失败 + } + const dict = sortDict(await getBizTypeDict()) + return dict.map((item) => toBizTypeOptionFromDict(item.dictValue, item.dictLabel)) } function patchForm(partial: Partial): void { form.value = { ...form.value, ...partial } } - /** File → FileInfo（mock：url 为空，uploadTime 取当前时间） */ - function addAttachment(file: File): void { - const info: FileInfo = { - name: file.name, - size: file.size, - uploadTime: formatDate(new Date()), - url: '', + /** 页面初始化：业务类型 + 预算字典 + 登录用户资料 + 已有草稿（并行） */ + async function init(): Promise { + loading.value = true + try { + const [bizTypes, budgetDictRes, profile, draft] = await Promise.all([ + loadBizTypeOptions(), + getBudgetRangeDict(), + // 用户资料失败不阻塞页面（联系人留空时后端会回退取登录用户资料） + getUserProfile().catch(() => null), + getDraftDemand(), + ]) + bizTypeOptions.value = bizTypes + budgetDict.value = sortDict(budgetDictRes) + + const base = createDefaultForm() + if (profile) { + base.userName = profile.nickName || profile.userName || '' + base.userPhone = profile.phoneNumber || '' + } + form.value = draft ? mergeDraft(base, draft, budgetDict.value) : base + } + catch (error) { + ElMessage.error(error instanceof Error ? error.message : '需求提报数据加载失败') + } + finally { + loading.value = false } - form.value.attachments = [...form.value.attachments, info] } - function removeAttachment(target: FileInfo): void { - form.value.attachments = form.value.attachments.filter( - (item) => !(item.name === target.name && item.uploadTime === target.uploadTime), + /** 上传附件：先传 OSS，再把附件记录挂到表单（提交时后端按 ossId 转存） */ + async function addAttachment(file: File): Promise { + if (uploading.value) return + uploading.value = true + try { + const oss = await uploadDemandFile(file) + const suffix = (oss.fileSuffix || file.name.split('.').pop() || '').replace(/^\./, '') + const item: DemandAttachment = { + ossId: oss.ossId, + originalName: oss.originalName || file.name, + url: oss.url, + fileSize: file.size, + type: suffix, + createTime: formatDate(new Date()), + } + form.value.attachmentInfo = [...form.value.attachmentInfo, item] + ElMessage.success(`「${item.originalName}」上传成功`) + } + catch (error) { + ElMessage.error(error instanceof Error ? error.message : '附件上传失败') + } + finally { + uploading.value = false + } + } + + /** 移除附件（仅从表单摘除，OSS 文件保留） */ + function removeAttachment(target: DemandAttachment): void { + form.value.attachmentInfo = form.value.attachmentInfo.filter( + (item) => !(item.ossId === target.ossId && item.id === target.id), ) } - /** 提交需求：必填校验通过后调 api，成功返回 true（页面可据此跳转） */ + /** 保存草稿（后端按登录用户 upsert） */ + async function saveDraft(): Promise { + saving.value = true + try { + await saveDraftApi(form.value) + ElMessage.success('草稿已保存') + } + catch (error) { + ElMessage.error(error instanceof Error ? error.message : '草稿保存失败') + } + finally { + saving.value = false + } + } + + /** 重置：清空后端草稿并复位表单（保留登录账号的联系人预填） */ + async function reset(): Promise { + saving.value = true + try { + await resetDraftApi() + const base = createDefaultForm() + base.userName = form.value.userName + base.userPhone = form.value.userPhone + form.value = base + ElMessage.success('已重置') + } + catch (error) { + ElMessage.error(error instanceof Error ? error.message : '重置失败') + } + finally { + saving.value = false + } + } + + /** + * 提交需求：前端必填校验 → 提报接口（`/web/requirementPool/create`）→ 复位表单。 + * + *

接口收的就是草稿那套 BO（`WorkOrderDraftBo`），附件**随本次请求体一起下发**：后端 + * `createRequirement` 会逐条把 `attachmentInfo` 的 `ossId` 引用复制成需求附件，所以这里 + * 不需要先落一次草稿（这点与后端 `/requirementPool/submit` 不同——那条链路才是从已落库 + * 草稿里搬附件）。

+ * + *

后端在同一事务里还会清掉该用户的草稿（`cleanHistoryDrafts`），故提交成功后草稿箱 + * 一并清空，用户不会在下次进入页面时看到已经提报过的内容。

+ * + *

⚠️ 该链路只落 `vm_project_requirement` 单表；「我的项目/需求」列表 + * （`/web/requirementPool/list`）查的是 `vm_rd_project`，所以本页提交的记录**不会**出现在 + * 那个列表里（详见 `api/demand.ts#submitDemand`）。

+ */ async function submit(): Promise { - if (!form.value.businessType) { + if (!form.value.bizType) { ElMessage.warning('请选择业务类型') return false } @@ -62,15 +268,23 @@ export const useDemandStore = defineStore('demand', () => { ElMessage.warning('请填写项目名称') return false } - if (!form.value.coreDescription.trim()) { + if (!form.value.requirementDesc.trim()) { ElMessage.warning('请填写核心需求描述') return false } - loading.value = true + // 手写模式下金额会直接作为 budgetRange 提交，故空值必须拦住 + if (form.value.budgetManual && !form.value.budgetRange.trim()) { + ElMessage.warning('请填写预算金额，或改选一个预设档位') + return false + } + submitting.value = true try { await submitDemand(form.value) - form.value.status = 'submitted' - ElMessage.success('提交后我们的专业顾问将在一个工作日内与您联系') + const base = createDefaultForm() + base.userName = form.value.userName + base.userPhone = form.value.userPhone + form.value = base + ElMessage.success('提交成功，专业顾问将在一个工作日内与您联系') return true } catch (error) { @@ -78,49 +292,24 @@ export const useDemandStore = defineStore('demand', () => { return false } finally { - loading.value = false + submitting.value = false } } - /** 保存草稿到 sessionStorage */ - async function saveDraft(): Promise { - loading.value = true - try { - await saveDraftApi(form.value) - form.value.status = 'draft' - ElMessage.success('草稿已保存') - } - catch (error) { - ElMessage.error(error instanceof Error ? error.message : '草稿保存失败') - } - finally { - loading.value = false - } - } - - /** 恢复本地草稿（无草稿则保持默认表单） */ - async function loadDraft(): Promise { - const draft = await getDraftDemand() - if (draft) form.value = { ...createDefaultForm(), ...draft } - } - - /** 重置表单与步骤 */ - function reset(): void { - form.value = createDefaultForm() - step.value = 1 - } - return { form, - step, + bizTypeOptions, + budgetOptions, loading, - setStep, + saving, + submitting, + uploading, + init, patchForm, addAttachment, removeAttachment, - submit, saveDraft, - loadDraft, reset, + submit, } }) diff --git a/src/stores/modules/home.ts b/src/stores/modules/home.ts index ab3d846..cff98ba 100644 --- a/src/stores/modules/home.ts +++ b/src/stores/modules/home.ts @@ -1,46 +1,262 @@ import { defineStore } from 'pinia' -import { ref } from 'vue' +import { computed, ref } from 'vue' import type { BusinessType } from '@/types/api' import type { Case } from '@/types/business/cases' -import type { BusinessLine, HomeStats } from '@/types/business/home' -import { getBusinessDetail, getBusinessLines, getFeaturedCases, getHomeStats } from '@/api/home' +import type { + BannerVo, + BusinessLine, + HomeStats, + ProjectStatusCount, + ProjectSubmissionFlat, + ProjectSubmissionInfo, + ProjectSubmissionVo, + ServiceContentBlock, + ServiceType, +} from '@/types/business/home' +import type { PortalEntryGroup, PortalEntryVo } from '@/types/business/home' +import { + getCarouselList, + getPortalEntryList, + getProjectStatusCount, + getServiceTypeDetail, + getServiceTypeList, + switchPortalEntryGroup as switchPortalEntryGroupApi, +} from '@/api/home' +import { getFeaturedCases as getFeaturedCasesApi } from '@/api/cases' +import { toCase } from '@/utils/caseVo' +import { formatBusinessType, toBusinessType } from '@/utils/format' +import { useCasesStore } from '@/stores/modules/cases' + +/** + * 首页数据（数据层：取数 + 状态 + 后端 VO → 页面类型映射，页面只调本 store） + * + * 后端接口： + * - UserSideWebHomePageController（前缀 /web/home-page）：看板、业务服务线、业务详情 + * - ProjectCaseUserController 的 /web/projectCase/mostViewed：案例库精选 + * + * 页面/组件消费的类型（BusinessLine / Case / HomeStats）保持不变， + * 后端 VO 与页面字段的差异（字段名、业务类型取值、富文本、数值单位）全部在本层对齐。 + */ + +// 业务类型归一化（toBusinessType）已抽到 `@/utils/format`，首页与案例库共用。 + +/** 富文本转纯文本（服务内容区以 
 展示，需去掉 HTML 标签，避免渲染出标签本身） */
+function stripHtml(html: string): string {
+  return html
+    .replace(//gi, '\n')
+    .replace(/<\/(p|div|li|h[1-6]|tr)>/gi, '\n')
+    .replace(/<[^>]*>/g, '')
+    .replace(/ /gi, ' ')
+    .replace(/&/gi, '&')
+    .replace(/</gi, '<')
+    .replace(/>/gi, '>')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim()
+}
+
+/** 后端「项目提报」→ 业务线卡片 / 业务详情 */
+function toBusinessLine(vo: ProjectSubmissionVo): BusinessLine {
+  const serviceTypes: ServiceType[] = (vo.serviceTypes ?? []).map((item) => ({
+    label: item.serviceName ?? '',
+    desc: '',
+    icon: item.iconUrl ?? '',
+  }))
+  const serviceContent = (vo.backgrounds ?? [])
+    .map((item) => stripHtml(item.content ?? ''))
+    .filter((text) => text.length > 0)
+    .join('\n\n')
+  // 列表接口的「项目背景」富文本按条映射为服务内容区块（保留 HTML 原文，详情页逐块渲染）
+  const contents: ServiceContentBlock[] = (vo.backgrounds ?? [])
+    .map((item) => ({ title: '', content: item.content ?? '' }))
+    .filter((block) => block.content.trim().length > 0)
+  const subtitle = vo.subtitle ?? ''
+  return {
+    id: toBusinessType(vo.businessType),
+    name: vo.title ?? '',
+    desc: subtitle,
+    slogan: subtitle,
+    icon: vo.logoUrl ?? '',
+    serviceContent,
+    contents,
+    serviceTypes,
+    video: '',
+  }
+}
+
+/** 后端「业务详情聚合 VO」→ 业务线（主表单对象；服务类型 / 附件 / 富文本目录均为一对多 List，需按数组下钻读取） */
+function toBusinessLineFromInfo(info: ProjectSubmissionInfo): BusinessLine {
+  const ps = info.projectSubmission ?? ({} as ProjectSubmissionFlat)
+  const serviceTypes: ServiceType[] = (info.projectServiceType ?? []).map((item) => ({
+    label: item.serviceName ?? '',
+    desc: '',
+    icon: item.iconUrl ?? '',
+  }))
+  const serviceContent = (info.projectSubmissionCatalog ?? [])
+    .map((item) => stripHtml(item.content ?? ''))
+    .filter((text) => text.length > 0)
+    .join('\n\n')
+  // 一、二、三…每条富文本目录 → 一个「服务内容」区块（保留 HTML，含内嵌图片/视频）
+  const contents: ServiceContentBlock[] = (info.projectSubmissionCatalog ?? [])
+    .map((item) => ({ title: item.title ?? '', content: item.content ?? '' }))
+    .filter((block) => block.content.trim().length > 0)
+  const subtitle = ps.subtitle ?? ''
+  return {
+    id: toBusinessType(ps.businessType),
+    name: ps.title ?? '',
+    desc: subtitle,
+    slogan: subtitle,
+    icon: ps.logoUrl ?? '',
+    serviceContent,
+    contents,
+    serviceTypes,
+    video: '',
+  }
+}
+
+// 后端案例 VO → 页面 Case 的映射已抽到 `@/utils/caseVo`（首页与案例库共用）。
+
+/** 未登录时后端看板返回 null，这里兜底为零值 */
+const EMPTY_STATUS: ProjectStatusCount = {
+  projectCount: 0,
+  ongoingProjectCount: 0,
+  pendingProjectCount: 0,
+}
 
-/** 首页数据（数据层：取数 + 状态，页面只调本 store） */
 export const useHomeStore = defineStore('home', () => {
+  /**
+   * 案例类型字典（提报 id → 类型名）由案例库 store 提供。
+   *
+   * 
案例表 business_type 列存的是提报主键 id，精选案例标签要翻译成名称就得查这份字典，
+   * 故首页与案例库共用同一份（见 casesStore.ensureCategories）。

+   */
+  const casesStore = useCasesStore()
+
   const stats = ref({ pending: 0, inProgress: 0, total: 0 })
+  const banners = ref([])
   const businessLines = ref([])
   const featuredCases = ref([])
   const currentBusiness = ref(null)
 
-  /** 首页初始化：看板 + 业务线 + 案例精选 */
+  /** 提报原始列表（内部缓存）：业务线卡片与详情共用，详情需按提报主键 id 取数 */
+  const submissions = ref([])
+
+  /** 门户入口原始列表（含快捷 / 其他两组，由 groupType 区分） */
+  const portalEntries = ref([])
+
+  /** 门户入口是否已成功取到（失败时组件回退到内置默认入口） */
+  const portalEntriesLoaded = ref(false)
+
+  /** 快捷入口组（groupType = 1） */
+  const quickEntries = computed(() =>
+    portalEntries.value.filter((item) => item.groupType === '1'),
+  )
+
+  /** 其他入口组（groupType ≠ 1） */
+  const otherEntries = computed(() =>
+    portalEntries.value.filter((item) => item.groupType !== '1'),
+  )
+
+  /**
+   * 拉取当前用户的门户入口。
+   *
+   * 
该接口对游客（无登录态）与无权限用户不可用，失败时保持入口为空，
+   * 由调用方回退到默认入口，不影响首页其余数据。

+   */
+  async function fetchPortalEntries(): Promise {
+    try {
+      const list = await getPortalEntryList()
+      portalEntries.value = list ?? []
+      portalEntriesLoaded.value = true
+    } catch {
+      portalEntries.value = []
+      portalEntriesLoaded.value = false
+    }
+  }
+
+  /** 快捷 / 其他入口互转，成功后重新拉取以同步后端排序 */
+  async function switchEntryGroup(id: number, type: PortalEntryGroup): Promise {
+    await switchPortalEntryGroupApi(id, type)
+    await fetchPortalEntries()
+  }
+
+  /** 确保提报列表已加载（业务详情页可能被直接打开，此时列表尚未取过） */
+  async function ensureSubmissions(): Promise {
+    if (submissions.value.length === 0) {
+      submissions.value = await getServiceTypeList()
+    }
+  }
+
+  /** 首页初始化：看板 + 轮播图 + 业务服务线 + 案例精选 */
   async function fetchHomeData(): Promise {
-    const [homeStats, lines, cases] = await Promise.all([
-      getHomeStats(),
-      getBusinessLines(),
-      getFeaturedCases(),
+    const [statusCount, submissionList, cases, carouselList] = await Promise.all([
+      getProjectStatusCount(),
+      getServiceTypeList(),
+      getFeaturedCasesApi(),
+      getCarouselList(),
+      // 案例标签需要「提报 id → 类型名」字典，与首页其余数据并行取（幂等，已加载则不发请求）
+      casesStore.ensureCategories(),
     ])
-    stats.value = homeStats
-    businessLines.value = lines
-    featuredCases.value = cases
+    const status = statusCount ?? EMPTY_STATUS
+    stats.value = {
+      pending: status.pendingProjectCount ?? 0,
+      inProgress: status.ongoingProjectCount ?? 0,
+      total: status.projectCount ?? 0,
+    }
+    submissions.value = submissionList
+    businessLines.value = submissionList.map(toBusinessLine)
+    featuredCases.value = cases.map((vo) => toCase(vo, casesStore.typeNameById))
+    banners.value = carouselList ?? []
+    // 入口个性化接口失败已被内部吞掉，不会影响上面的首页数据
+    await fetchPortalEntries()
   }
 
-  /** 按业务类型切换案例精选 */
+  /**
+   * 按业务类型切换案例精选。
+   *
+   * 
后端 selectByType 按案例表 business_type 列的**原值**精确匹配，而该列实测存的是
+   * **提报主键 id**，故这里用 BusinessType 名称经 /categories 字典反查提报 id 再下发；
+   * 字典里查不到（提报表未登记该类型）时直接置空，不发无效请求。

+   */
   async function fetchFeaturedCases(category: BusinessType | 'all' = 'all'): Promise {
-    featuredCases.value = await getFeaturedCases(category)
+    if (category === 'all') {
+      featuredCases.value = (await getFeaturedCasesApi()).map((vo) => toCase(vo, casesStore.typeNameById))
+      return
+    }
+    await casesStore.ensureCategories()
+    const name = formatBusinessType(category)
+    const typeId = Object.entries(casesStore.typeNameById).find(([, value]) => value === name)?.[0]
+    if (!typeId) {
+      featuredCases.value = []
+      return
+    }
+    featuredCases.value = (await getFeaturedCasesApi(typeId)).map((vo) => toCase(vo, casesStore.typeNameById))
   }
 
-  /** 业务详情 */
+  /** 业务详情：前端 BusinessType 反查提报主键后取详情 */
   async function fetchBusinessDetail(type: BusinessType): Promise {
-    currentBusiness.value = await getBusinessDetail(type)
+    await ensureSubmissions()
+    const target = submissions.value.find((item) => toBusinessType(item.businessType) === type)
+    if (!target || target.id == null) {
+      currentBusiness.value = null
+      return
+    }
+    currentBusiness.value = toBusinessLineFromInfo(await getServiceTypeDetail(target.id))
   }
 
   return {
     stats,
+    banners,
     businessLines,
     featuredCases,
     currentBusiness,
+    portalEntries,
+    portalEntriesLoaded,
+    quickEntries,
+    otherEntries,
     fetchHomeData,
     fetchFeaturedCases,
     fetchBusinessDetail,
+    fetchPortalEntries,
+    switchEntryGroup,
   }
 })
diff --git a/src/stores/modules/project.ts b/src/stores/modules/project.ts
index f23da0e..cae8b2d 100644
--- a/src/stores/modules/project.ts
+++ b/src/stores/modules/project.ts
@@ -1,12 +1,19 @@
 import { defineStore } from 'pinia'
 import { ref } from 'vue'
 import { ElMessage } from 'element-plus'
-import type { PageResult } from '@/types/api'
-import type { AfterSalesPayload, Project, ProjectQuery } from '@/types/business/project'
+import type {
+  AfterSalesPayload,
+  Project,
+  ProjectQuery,
+  ProjectStatistics,
+  ProjectTypeCount,
+  RdProjectVo,
+} from '@/types/business/project'
 import {
   cancelAfterSales as cancelAfterSalesApi,
   deleteProjectFile,
   getProjectDetail,
+  getProjectFilterConditions,
   getProjectList,
   submitAfterSales as submitAfterSalesApi,
   uploadProjectFile,
@@ -15,50 +22,125 @@ import {
 function createDefaultQuery(): ProjectQuery {
   return {
     keyword: '',
-    businessType: 'all',
-    status: 'all',
+    businessType: '',
+    status: '',
     timeShortcut: 'all',
-    page: 1,
+    startDate: '',
+    endDate: '',
+    pageNum: 1,
     pageSize: 8,
   }
 }
 
-/** 项目中心数据（列表 / 筛选 / 分页 / 详情 / 文件 / 售后） */
+/**
+ * 业务类型件数 —— 由 `getFilterConditions` 的统计构建（**全量口径**，不随筛选 / 分页变化）。
+ *
+ * 
「全部」的件数取统计里的 `total`（该用户需求总数）；统计拿不到时退回列表 `total`，
+ * 这种降级下只会渲染出「全部」一行。

+ */
+function buildTypeCounts(
+  statistics: ProjectStatistics | null | undefined,
+  total: number,
+): ProjectTypeCount[] {
+  const counts = statistics?.businessTypeCounts ?? []
+  return [
+    { value: 'all', label: '全部', count: statistics?.total ?? total },
+    ...counts.map((item) => ({
+      value: String(item.businessTypeId),
+      label: item.businessTypeLabel,
+      count: item.count,
+    })),
+  ]
+}
+
+/** 项目中心数据（列表 + 详情走真实接口；文件 / 售后仍是 mock，后端无对应接口） */
 export const useProjectStore = defineStore('project', () => {
   const query = ref(createDefaultQuery())
-  const list = ref([])
+  /** 列表行（后端 RdProjectVo；**不是**详情那套 mock 的 Project） */
+  const list = ref([])
   const total = ref(0)
   const current = ref(null)
+  /** 业务类型件数（左侧筛选栏用；由 `ensureFilterConditions` 单独拉取，全量口径） */
+  const typeCounts = ref([{ value: 'all', label: '全部', count: 0 }])
+  /** 业务类型筛选条件是否已拉过（值域在运行期不变，进页面拉一次即可） */
+  let filterConditionsLoaded = false
 
-  async function fetchList(): Promise {
-    const result: PageResult = await getProjectList(query.value)
-    list.value = result.list
-    total.value = result.total
+  /**
+   * 取业务类型筛选条件（左侧筛选栏「业务类型」的值域 + 件数）。
+   *
+   * 
幂等：成功拉到一次后不再重复请求（值域是全量口径，与当前筛选条件无关）。
+   * 失败时不标记已加载，下次进页面仍会重试；期间保留上一次结果，首屏即失败则只有「全部」一行。

+   */
+  async function ensureFilterConditions(): Promise {
+    if (filterConditionsLoaded) return
+    try {
+      typeCounts.value = buildTypeCounts(await getProjectFilterConditions(), total.value)
+      filterConditionsLoaded = true
+    }
+    catch (error) {
+      console.warn('[project] 业务类型筛选条件加载失败', error)
+    }
   }
 
+  /**
+   * 取列表（服务端筛选 + 分页；失败向上抛给调用方处理）。
+   *
+   * 
⚠️ 这里**不**碰 `typeCounts`：`/list` 的 `requirementStatistics` 后端恒为 null，
+   * 拿它重建会把业务类型整列抹成只剩「全部」，且「全部」件数会变成筛选后的 total（偏小）。
+   * 业务类型的值域统一由 {@link ensureFilterConditions} 负责。

+   */
+  async function fetchList(): Promise {
+    const result = await getProjectList(query.value)
+    const page = result?.requirementPage
+    list.value = page?.rows ?? []
+    total.value = page?.total ?? 0
+  }
+
+  /**
+   * 取详情（真实接口）。
+   *
+   * 
后端在「需求不存在」或「不属于当前用户」时返回 `data: null` ⇒ 页面显示空态；
+   * 请求本身失败（如 500）也归为 null，不让异常冒到组件里。

+   */
   async function fetchDetail(id: string): Promise {
-    current.value = await getProjectDetail(id)
+    try {
+      current.value = await getProjectDetail(id)
+    }
+    catch (error) {
+      current.value = null
+      console.warn('[project] 项目详情加载失败', error)
+    }
   }
 
   function setQuery(next: ProjectQuery): void {
     query.value = next
   }
 
+  /** 确定筛选 / 换页后的取数统一入口（失败只提示，不清空已有数据） */
+  async function load(): Promise {
+    try {
+      await fetchList()
+    }
+    catch (error) {
+      console.warn('[project] 项目列表加载失败', error)
+    }
+  }
+
   /** 确定筛选（重置页码后取数） */
   async function search(): Promise {
-    query.value = { ...query.value, page: 1 }
-    await fetchList()
+    query.value = { ...query.value, pageNum: 1 }
+    await load()
   }
 
   /** 重置全部条件 */
   async function resetQuery(): Promise {
     query.value = createDefaultQuery()
-    await fetchList()
+    await load()
   }
 
-  async function changePage(page: number): Promise {
-    query.value = { ...query.value, page }
-    await fetchList()
+  async function changePage(pageNum: number): Promise {
+    query.value = { ...query.value, pageNum }
+    await load()
   }
 
   /** 上传项目文件（追加到当前详情） */
@@ -92,9 +174,12 @@ export const useProjectStore = defineStore('project', () => {
     list,
     total,
     current,
+    typeCounts,
+    ensureFilterConditions,
     fetchList,
     fetchDetail,
     setQuery,
+    load,
     search,
     resetQuery,
     changePage,
diff --git a/src/stores/modules/user.ts b/src/stores/modules/user.ts
index 0fbceac..b3bdf93 100644
--- a/src/stores/modules/user.ts
+++ b/src/stores/modules/user.ts
@@ -4,18 +4,18 @@ import { ElMessage } from 'element-plus'
 import type {
   LoginByAccountParams,
   LoginBySmsParams,
-  LoginResult,
-  RegisterParams,
   ResetPasswordParams,
   User,
 } from '@/types/business/user'
 import {
-  loginByAccount as loginByAccountApi,
   loginBySms as loginBySmsApi,
-  register as registerApi,
   resetPassword as resetPasswordApi,
   sendSmsCode as sendSmsCodeApi,
 } from '@/api/auth'
+import {
+  loginByAccountApi,
+  registerByAccountApi,
+} from '@/api/auth'
 import { storage } from '@/utils/storage'
 
 /** 用户登录态（M4：token 持久化 key 'token'，路由守卫读取同一 key） */
@@ -26,7 +26,7 @@ export const useUserStore = defineStore('user', () => {
 
   const isLoggedIn = computed(() => Boolean(token.value))
 
-  /** 发送短信验证码 */
+  /** 发送短信验证码（保留原 mock 逻辑） */
   async function sendSmsCode(phone: string): Promise {
     try {
       await sendSmsCodeApi(phone)
@@ -39,18 +39,18 @@ export const useUserStore = defineStore('user', () => {
   }
 
   /** 登录成功统一落库（token 持久化） */
-  function applyLogin(result: LoginResult): void {
-    token.value = result.token
-    user.value = result.user
-    storage.set('token', result.token)
+  function applyLogin(payload: { token: string; user: User | null }): void {
+    token.value = payload.token
+    user.value = payload.user
+    storage.set('token', payload.token)
   }
 
-  /** 账号密码登录 */
+  /** 账号密码登录（对接真实后端 /auth/login，返回 access_token） */
   async function loginByAccount(params: LoginByAccountParams): Promise {
     loading.value = true
     try {
-      const result = await loginByAccountApi(params)
-      applyLogin(result)
+      const result = await loginByAccountApi({ username: params.account, password: params.password })
+      applyLogin({ token: result.access_token, user: null })
       ElMessage.success('登录成功')
       return true
     }
@@ -63,12 +63,12 @@ export const useUserStore = defineStore('user', () => {
     }
   }
 
-  /** 手机验证码登录 */
+  /** 手机验证码登录（保留原 mock 逻辑） */
   async function loginBySms(params: LoginBySmsParams): Promise {
     loading.value = true
     try {
       const result = await loginBySmsApi(params)
-      applyLogin(result)
+      applyLogin({ token: result.token, user: result.user })
       ElMessage.success('登录成功')
       return true
     }
@@ -81,11 +81,11 @@ export const useUserStore = defineStore('user', () => {
     }
   }
 
-  /** 注册 */
-  async function register(params: RegisterParams): Promise {
+  /** 注册（对接真实后端 /auth/register，账号+密码，无验证码） */
+  async function register(params: { username: string; password: string; confirmPassword: string }): Promise {
     loading.value = true
     try {
-      await registerApi(params)
+      await registerByAccountApi({ username: params.username, password: params.password })
       ElMessage.success('注册成功，请登录')
       return true
     }
@@ -98,7 +98,7 @@ export const useUserStore = defineStore('user', () => {
     }
   }
 
-  /** 重置密码 */
+  /** 重置密码（保留原 mock 逻辑） */
   async function resetPassword(params: ResetPasswordParams): Promise {
     loading.value = true
     try {
diff --git a/src/styles/mixins.less b/src/styles/mixins.less
index 67cca48..3a17d47 100644
--- a/src/styles/mixins.less
+++ b/src/styles/mixins.less
@@ -35,3 +35,26 @@
     background: transparent;
   }
 }
+
+// 表单文本控件（输入框 / 文本域共用外观；需求提报页设计稿规格：白底 + 浅灰描边 + 4px 圆角）
+.text-control() {
+  width: 100%;
+  padding: 0 @spacing-base;
+  border: 1px solid @border-color;
+  border-radius: @radius-sm;
+  background: @white;
+  font-size: @font-size-base;
+  font-family: inherit;
+  color: @heading-color;
+  outline: none;
+  box-sizing: border-box;
+  transition: border-color 0.2s;
+
+  &:focus {
+    border-color: @primary-color;
+  }
+
+  &::placeholder {
+    color: @text-color-secondary;
+  }
+}
diff --git a/src/styles/variables.less b/src/styles/variables.less
index 4f4b914..b8ad69e 100644
--- a/src/styles/variables.less
+++ b/src/styles/variables.less
@@ -1,8 +1,8 @@
 // ★ less 变量唯一来源（颜色/间距/字号/圆角）
 // 注：蓝湖设计稿到位前为原型近似值，到位后按标注精确校准
 
-// 品牌色
-@primary-color: #3370ff;
+// 品牌色（按案例库设计稿标注校准）
+@primary-color: #276fff;
 @primary-hover: #598bff;
 @primary-light: #eaf1ff;
 
@@ -46,11 +46,31 @@
 @font-size-xl: 20px;
 @font-size-xxl: 28px;
 
-// 布局
-@container-width: 1200px;
+// 布局（容器宽度按设计稿标注校准：设计稿为约 1400 宽的整幅版面）
+@container-width: 1400px;
 @header-height: 64px;
 @footer-height: 240px;
 
 // 阴影
 @shadow-base: 0 2px 8px rgba(31, 39, 51, 0.08);
 @shadow-lg: 0 4px 16px rgba(31, 39, 51, 0.12);
+
+// 案例库（按设计稿标注校准；筛选面板 / 案例卡片专用）
+@filter-selected-bg: #e6f7ff;   // 业务类型选中行底色
+@pill-bg: #f2f2f2;              // 胶囊选项默认底色
+@pill-selected-bg: #d4e2ff;     // 胶囊选项选中底色
+@chips-panel-bg: #eff6ff;       // 「已选条件」区底色
+@input-bg: #f3f4f6;             // 搜索框 / 日期区间底色
+@tag-hardware: #82b43b;         // 业务标签：硬件电路
+@tag-iot: #5720ba;              // 业务标签：物联网全案
+@tag-manufacturing: #ff8f1f;    // 业务标签：生产制造
+@tag-other: #8a94a6;            // 业务标签：其他
+
+// 需求提报（按需求提报设计稿标注校准）
+@demand-selected-bg: #dee8fc;   // 业务类型卡片 / 预算胶囊选中底色
+@demand-accent: #2563eb;        // 业务类型选中描边与右上角圆点
+@demand-secondary-bg: #e6e6e6;  // 底部「保存草稿 / 重置」按钮底色
+
+// 项目中心（按项目中心设计稿标注校准）
+@project-table-head-bg: #e8e8e8;  // 表头底色（设计稿实取 (232,232,232)）
+@project-table-line: #bbbbbb;     // 表格网格线（设计稿实取 (187,187,187)）
diff --git a/src/types/business/cases.d.ts b/src/types/business/cases.d.ts
index d2c28f9..a9e91e0 100644
--- a/src/types/business/cases.d.ts
+++ b/src/types/business/cases.d.ts
@@ -1,9 +1,52 @@
-// 案例实体（PRD 4.1，home/cases/profile.favorites 共享）
+// 案例库类型（案例实体 + 后端 VO，与 api/cases.ts 对应）
+//
+// 后端：vermis-maker com.ruoyi.vermins.controller.pc.web.ProjectCaseUserController（前缀 /web/projectCase）
+// 说明：案例实体类型统一定义在本文件（含首页「案例库精选」消费的 ProjectCaseVo）。
 
 import type { BusinessType } from '@/types/api'
 
-/** 项目规模区间 */
-export type ScaleRange = 'lt50w' | '50to100w' | '100to300w' | '300to500w' | 'gt500w'
+/**
+ * 业务类型筛选项。
+ *
+ * 
选项不是前端写死的，而是取自 GET /web/projectCase/categories 返回的
+ * {@link ProjectCaseStatisticsVo#projectCaseCounts}——后端按项目提报表统计后下发。

+ */
+export interface CaseTypeOption {
+  /**
+   * 下发值 = **提报主键 id**（如 "2099753433048526850"）。
+   *
+   * 
必须用 id 而非类型名：案例表 business_type 列实测存的就是提报主键 id，
+   * 传类型名（如「硬件电路」）后端按原值精确匹配不到 → 实测 total=0。

+   */
+  value: string
+  /** 展示名（后端下发的 businessType 名称，如「硬件电路」） */
+  label: string
+  /** 该业务类型的案例数（后端统计口径，可能为 0） */
+  count: number
+}
+
+/** 案例附件（页面消费，由后端 ProjectCaseAttachmentVo 映射而来） */
+export interface CaseAttachment {
+  /** 原始文件名 */
+  name: string
+  /** 文件大小（后端已格式化的文本形式，可能为空） */
+  size: string
+  /** 附件访问地址 */
+  url: string
+}
+
+/**
+ * 案例正文区块（后端「自定义目录」一项 = 页面一张白卡）。
+ *
+ * 
标题由后端下发，前端不写死：增删区块（项目背景 / 客户痛点 / 需求描述 / 交付物 …）
+ * 完全由 vm_project_case_catalog 数据决定。

+ */
+export interface CaseSection {
+  /** 区块标题（vm_project_case_catalog.title） */
+  title: string
+  /** 区块内容：富文本 HTML（可能内嵌 img / video） */
+  content: string
+}
 
 /** 案例 */
 export interface Case {
@@ -18,21 +61,219 @@ export interface Case {
   industry: string
   duration: string
   clientType: string
-  background: string
-  painPoints: string
-  requirements: string
-  deliverables: string
+  /**
+   * 正文区块列表（标题 + 富文本）。
+   *
+   * 
来自后端 catalogs（vm_project_case_catalog，按 sort_order 升序）；
+   * 列表 / 精选接口不下发，故那些场景为空数组。

+   */
+  sections: CaseSection[]
+  /** 附件列表（仅案例详情接口返回，列表页为空） */
+  attachments?: CaseAttachment[]
   video: string
   isFavorite: boolean
+  /** 收藏量（详情/列表接口下发，本地收藏翻转时同步 ±1） */
+  favoriteCount: number
 }
 
-/** 案例筛选条件 */
+/**
+ * 案例筛选条件。
+ *
+ * 
三类选项全部由后端下发，前端不写死，且都来自 GET /categories（{@link CaseSelectionModel}）：
+ * 业务类型（{@link CaseTypeOption}）、所属行业、项目规模；仅完成日期区间由前端生成。

+ */
 export interface CaseQuery {
-  category: BusinessType | 'all'
+  /** 业务类型**提报主键 id**（多选，空数组 = 全部；值域见 CaseTypeOption.value） */
+  categories: string[]
+  /** 所属行业名称（多选，空数组 = 全部；值域见 BusinessIndustryOption.name） */
   industries: string[]
-  scales: ScaleRange[]
+  /** 项目规模档位（多选，空数组 = 全部；整档对象直接下发，值域见 /categories） */
+  scales: ScaleLimit[]
   dateRange: [string, string] | null
+  /** 只看收藏（对应后端 isFavorite=1） */
+  favoriteOnly: boolean
   keyword: string
   page: number
   pageSize: number
 }
+
+/* ============================ 后端 VO / BO ============================ */
+
+/**
+ * GET /web/projectCase/list 的查询条件（后端 ProjectCaseUserBo）。
+ *
+ * 
businessTypes 按案例表 business_type 列的**原值**精确匹配（in），而该列实测存的是
+ * **提报主键 id**（非类型名），所以前端下发的是 CaseTypeOption.value（id）。

+ */
+export interface ProjectCaseUserBo {
+  /** 业务类型提报主键 id 列表 */
+  businessTypes?: string[]
+  /** 业务/行业名称列表 */
+  businessIndustries?: string[]
+  /** 规模区间列表（区间之间取并集） */
+  scales?: ScaleLimit[]
+  /** 只看收藏：1 = 是；不传 = 全部 */
+  isFavorite?: number
+  /** 关键字（案例名 / 客户类型 / 项目周期 / 团队人数） */
+  key?: string
+  /** 开始时间 */
+  beginTime?: string
+  /** 结束时间 */
+  endTime?: string
+}
+
+/** 规模区间（后端 UpperAndLowerLimitsModel）：任一端为空表示该方向不设限 */
+export interface ScaleLimit {
+  lowerLimit?: number | null
+  upperLimit?: number | null
+  /** 展示样式：以下 / 区间 / 以上 */
+  model?: string | null
+  /** 档位文字（后端拼好，如「28–46万」） */
+  label?: string | null
+  sort?: number | null
+}
+
+/** 所属行业选项（后端 BusinessIndustryModel） */
+export interface BusinessIndustryOption {
+  name: string | null
+  sort: number | null
+}
+
+/**
+ * GET /web/projectCase/categories —— 筛选面板选项。
+ *
+ * 
左侧筛选**除完成时间外**的选项全部由本接口一次下发：
+ * 业务类型（{@link CaseSelectionModel.projectCaseStatisticsVo}）、
+ * 所属行业（{@link CaseSelectionModel.businessIndustry}）、
+ * 项目规模（{@link CaseSelectionModel.upperAndLowerLimits}）。

+ */
+export interface CaseSelectionModel {
+  businessIndustry: BusinessIndustryOption[] | null
+  upperAndLowerLimits: ScaleLimit[] | null
+  /** 业务类型统计（承载业务类型筛选项与案例总数） */
+  projectCaseStatisticsVo: ProjectCaseStatisticsVo | null
+}
+
+/** 案例总数 + 各业务类型案例数 */
+export interface ProjectCaseStatisticsVo {
+  /** 案例总数（口径：未删除且在架） */
+  total: number | null
+  /** 各业务类型的案例数（按案例数倒序） */
+  projectCaseCounts: ProjectCaseCountVo[] | null
+}
+
+/** 单个业务类型的案例数 */
+export interface ProjectCaseCountVo {
+  /** 业务类型原值（提报主键 id 的字符串形式） */
+  id: string | null
+  /** 业务类型名称 */
+  businessType: string | null
+  caseCount: number | null
+}
+
+/**
+ * GET /web/projectCase/list —— 案例分页列表 + 业务数据统计。
+ *
+ * 
统计口径是「本次查询结果」，即跟随筛选条件变化，不是全表统计。

+ */
+export interface ProjectCaseAndCaseCountVo {
+  projectCasePage: ProjectCasePageVo | null
+  projectCaseStatisticsVo: ProjectCaseStatisticsVo | null
+}
+
+/** 分页体（后端 PageResult：rows + total） */
+export interface ProjectCasePageVo {
+  total: number
+  rows: ProjectCaseVo[]
+}
+
+/** 案例库视图对象（列表 / 详情 / mostViewed 共用；后端 Long 主键序列化为字符串） */
+export interface ProjectCaseVo {
+  id: string
+  /** 案例编号 */
+  caseNo: string | null
+  /** 案例名称 */
+  caseName: string | null
+  /** 业务类型原值（案例表该列存提报主键 id 或类型名称） */
+  businessType: string | null
+  /** 业务类型名称（后端 JOIN 提报表翻译后的展示名） */
+  projectTypeName: string | null
+  /** 业务/行业 */
+  businessIndustry: string | null
+  /** 上下架：1 上架，0 下架 */
+  enabled: number | null
+  /** 规模数值（单位：万） */
+  scale: number | null
+  /** 预览量（详情接口每次调用自增 1） */
+  previewCount: number | null
+  /** 浏览量（已废弃，勿用于排序） */
+  viewCount: number | null
+  /** 收藏量 */
+  favoriteCount: number | null
+  /** 封面（后端下发的是 OSS 文件标识，未必是可直接访问的 URL） */
+  coverUrl: string | null
+  /** 客户类型 */
+  customerType: string | null
+  /** 所属行业 */
+  industry: string | null
+  /** 项目周期 */
+  projectCycle: string | null
+  /** 服务团队人数 */
+  serviceTeam: number | null
+  /** 完成时间 yyyy-MM-dd */
+  completedAt: string | null
+  /** 是否收藏：1 是，0 否（详情与列表接口均会回填） */
+  isFavorite: number | null
+  /**
+   * 项目背景富文本段列表（仅详情返回）。
+   *
+   * @deprecated 后端已改用 {@link ProjectCaseVo.catalogs}（带标题的自定义目录），该字段恒为 null。
+   */
+  backgrounds: ProjectCaseBackgroundVo[] | null
+  /** 正文区块列表（仅详情返回；后端按 sort_order、id 升序下发） */
+  catalogs: ProjectCaseCatalogVo[] | null
+  /** 附件列表（仅详情返回） */
+  attachments: ProjectCaseAttachmentVo[] | null
+  /** 更新时间 yyyy-MM-dd HH:mm:ss */
+  updateTime: string | null
+}
+
+/**
+ * 案例项目背景富文本段（vm_project_case_detail）。
+ *
+ * @deprecated 已被 {@link ProjectCaseCatalogVo} 取代（新结构带 title），后端恒下发 null。
+ */
+export interface ProjectCaseBackgroundVo {
+  id: string | null
+  projectId: string | null
+  /** 富文本 HTML */
+  content: string | null
+  sortOrder: number | null
+}
+
+/** 案例自定义目录 / 正文区块（vm_project_case_catalog） */
+export interface ProjectCaseCatalogVo {
+  id: string | null
+  projectId: string | null
+  /** 目录标题（如「项目背景」「客户痛点」） */
+  title: string | null
+  /** 目录内容富文本 HTML */
+  content: string | null
+  /** 排序值，升序 */
+  sortOrder: number | null
+}
+
+/** 案例附件（vm_project_case_attachment） */
+export interface ProjectCaseAttachmentVo {
+  id: string | null
+  projectId: string | null
+  /** OSS 标识 */
+  ossId: string | null
+  /** 原始文件名 */
+  originalName: string | null
+  /** 文件大小（文本形式） */
+  fileSize: string | null
+  /** 附件访问地址 */
+  url: string | null
+  sortOrder: number | null
+}
diff --git a/src/types/business/demand.d.ts b/src/types/business/demand.d.ts
index 7eaac14..2abfcd8 100644
--- a/src/types/business/demand.d.ts
+++ b/src/types/business/demand.d.ts
@@ -1,20 +1,181 @@
-// 需求提报实体（M3，page-architecture）
+// 需求提报（对接真实后端）
+//   草稿：POST /web/workOrderDraft/{getDraft,add,upload,reset} → vm_work_order_draft（WorkOrderDraftBo / Vo）
+//   提交：POST /web/requirementPool/create → vm_project_requirement（入参 WorkOrderDraftBo，与草稿同 BO，附件随请求体）
+//        （同控制器的 /submit 入参是 RdProjectBo、会额外落 vm_rd_project，前端当前未使用）
+//   业务类型：GET /web/projectSubmission/list（vm_project_submission，@SaIgnore 免登录）
+//            与首页 /web/home-page/service-type-list 是同一个 service 方法，数据完全一致
+//   预算范围：GET /system/dict/data/type/vm_budget_range（字典）
+//   注意：草稿 / 提交 / 字典 需登录态（匿名实测 401）；业务类型列表免登录
 
-import type { BusinessType, FileInfo } from '@/types/api'
+/** 业务类型图标标识（对应前端内联 SVG，见 views/demand/cpns/BizTypeIcon.vue） */
+export type BizIconKey = 'code' | 'chip' | 'iot' | 'factory' | 'other'
 
-/** 预算范围 */
-export type BudgetRange = 'lt1w' | '1to5w' | '5to10w' | 'gt10w' | ''
-
-/** 需求提报表单 */
-export interface Demand {
-  businessType: BusinessType
-  projectName: string
-  attachments: FileInfo[]
-  coreDescription: string
-  expectedDuration: number | ''
-  budgetRange: 'lt1w' | '1to5w' | '5to10w' | 'gt10w' | ''
-  userName: string
-  userPhone: string
-  remark: string
-  status: 'draft' | 'submitted'
+/** 字典项（GET /system/dict/data/type/{dictType}） */
+export interface DictOption {
+  dictLabel: string
+  dictValue: string
+  dictSort: number
+}
+
+/** 项目提报列表项（GET /web/projectSubmission/list，只取业务类型卡片用得到的字段） */
+export interface SubmissionBizTypeVo {
+  /** 提报主键（业务详情接口 /web/projectSubmission/{id} 用它） */
+  id: string | number
+  /** 业务类型（既作展示名，也作下发给后端的值） */
+  businessType: string | null
+  /** 标题 */
+  title: string | null
+  /** 副标题（卡片一句话描述的数据源） */
+  subtitle: string | null
+  /** 封面（⚠️ 实测存的是 OSS 文件标识，非完整地址） */
+  coverUrl: string | null
+  /** Logo（⚠️ 同上，需经 /resource/oss/listByIds 换取真实地址） */
+  logoUrl: string | null
+}
+
+/**
+ * 业务类型卡片选项。
+ *
+ * 
值域**完全由接口决定**：提报列表返回几条就渲染几张卡，前端不追加任何兜底项
+ * （「其他」也不例外——接口有才显示，没有就不显示）。字段映射：`businessType` 作下发值、
+ * `title` 作展示名、`subtitle` 作描述、`logoUrl` 作图标。但后端这两个字段目前是**半成品**——
+ * subtitle 常与类型名重复、logo 存的是 OSS 文件标识——故 desc / icon 保留前端映射表兜底
+ * （见 `utils/bizTypeMeta.ts`，只按类型名补描述/图标，不产生新选项）。

+ */
+export interface BizTypeOption {
+  /** 下发给后端的值（= 提报 businessType，如「互联网软件」） */
+  value: string
+  /** 展示名 */
+  label: string
+  /** 一句话描述（后端 subtitle 可用时优先，否则用前端映射） */
+  desc: string
+  /** 图标标识（前端内联 SVG；`iconUrl` 为空时渲染它） */
+  icon: BizIconKey
+  /** 后端 Logo 图片地址（已换链可直接访问时优先渲染，否则回退 `icon` 内联 SVG） */
+  iconUrl?: string
+}
+
+/** 草稿附件（vm_work_order_draft_attachment） */
+export interface DemandAttachment {
+  id?: string | number | null
+  draftId?: string | number | null
+  /** OSS 文件主键 */
+  ossId?: string | number | null
+  /** 原始文件名 */
+  originalName?: string | null
+  /** 文件访问地址 */
+  url?: string | null
+  /** 文件大小（字节） */
+  fileSize?: number | null
+  /** 文件格式后缀（pdf / docx / zip …） */
+  type?: string | null
+  /** 上传时间（BaseEntity.createTime；本地上传时由前端补当前时间） */
+  createTime?: string | null
+}
+
+/** 需求提报表单（字段与后端 WorkOrderDraftBo 对应，另有 1 个纯前端状态字段：budgetManual） */
+export interface Demand {
+  /** 草稿主键（编辑已有草稿时回填） */
+  id?: string | number | null
+  /** 业务类型（= 项目提报的 businessType，如「互联网软件」；后端落库存的也是这个名称，不是提报 id） */
+  bizType: string
+  /** 项目名称 */
+  projectName: string
+  /** 核心需求描述 */
+  requirementDesc: string
+  /**
+   * 预算范围：选预设档位时为字典 `vm_budget_range` 的 dictValue（'0'~'3'）；
+   * 在第 5 个「手填」输入框里写字时为用户自己填的金额文本（如「80万」）。
+   *
+   * 
⚠️ 手填内容只能放本字段：后端 `WorkOrderDraftBo.budgetCustom` 是被注释掉的、
+   * `vm_work_order_draft` 表也没有 `budget_custom` 列（VO 上那个 `budgetCustom` 恒为 null），
+   * 所以没有第二个位置可以承载手填文本。提交落 `vm_project_requirement.budget_range`，
+   * 该列为 **varchar(30)**，故手填文本限长见 `utils/budgetMeta.ts#MANUAL_BUDGET_MAX`。

+   */
+  budgetRange: string
+  /** 是否由「手填」输入框提供预算（**纯前端状态**：后端 BO/VO 与两张表都没有该字段，下发前需剔除） */
+  budgetManual: boolean
+  /** 预计开发周期（工作日） */
+  developmentCycle: number | ''
+  /** 补充备注 */
+  supplementaryRemarks: string
+  /** 用户名称 */
+  userName: string
+  /** 用户电话 */
+  userPhone: string
+  /** 附件列表（后端按此逐条转存为需求附件） */
+  attachmentInfo: DemandAttachment[]
+}
+
+/**
+ * 直接提报请求体（对应后端 `RdProjectBo` 的可写子集，POST /web/requirementPool/submit）。
+ *
+ * 
⚠️ **当前前端未使用**：提交走的是 `/web/requirementPool/create`（入参 `WorkOrderDraftBo`，
+ * 与草稿同一个 BO，附件随请求体下发）。本类型对应的是后端 `/submit` 链路，保留以备切回。

+ *
+ * 
⚠️ 与草稿 BO 的字段名**不同**，别混用：业务类型叫 `businessType`（草稿叫 `bizType`）、
+ * 补充备注叫 `extraRemark`（草稿叫 `supplementaryRemarks`）。

+ *
+ * 
⚠️ 两个字段**不在**此请求体里：

+ * 
    
+ *   
  • `developmentCycle`（预计开发周期）—— `vm_project_requirement` 与 `vm_rd_project`
+ *       两张表都**没有**该列，所以提报链路无处存放（草稿表 `vm_work_order_draft.development_cycle`
+ *       里有，提交后即丢失，草稿路径同样如此）；
    • 
+ *   
  • `attachmentInfo` —— `RdProjectBo` 无附件字段，后端按登录用户从**已落库草稿**里
+ *       按 `ossId` 搬运到 `vm_project_requirement_attachment`（故走该链路时调用方需先落一次草稿，
+ *       这也正是前端改回 `/create` 的原因之一）。
    • 
+ * 

+ *
+ * 
`projectNo` / `sourceType` / `priority` / `status` / `progress` 在 BO 上虽标了 `@NotBlank`，
+ * 但注解都挂 `AddGroup` / `EditGroup`，而控制器是裸 `@Validated`（未指定分组）⇒ 实际**不生效**；
+ * 这些值由后端统一生成/兜默认（`project_no` 复用需求编号、`source_type=EXTERNAL`、
+ * `priority=UNASSESSED`、`status=IN_PROGRESS`、`progress=0`），前端不下发。

+ */
+export interface DemandSubmitBo {
+  /** 业务类型名称（如「互联网软件」；后端落库存的是名称，不是提报 id） */
+  businessType: string
+  /** 项目名称 */
+  projectName: string
+  /** 核心需求描述 */
+  requirementDesc: string
+  /** 联系人姓名（缺失时后端回退取登录用户资料） */
+  customerName: string
+  /** 联系人电话（同上） */
+  customerPhone: string
+  /** 预算范围：预设档位 = 字典码值；手填 = 用户输入的金额文本 */
+  budgetRange: string | null
+  /** 补充备注（对应草稿的 supplementaryRemarks） */
+  extraRemark: string | null
+}
+
+/** 草稿详情（后端 WorkOrderDraftVo，取前端用得到的子集） */
+export interface DemandDraftVo {
+  id: string | number | null
+  bizType: string | null
+  projectName: string | null
+  requirementDesc: string | null
+  /** 预算范围：预设档位=字典 dictValue；手填=用户在第 5 个输入框里写的文本（前端据此反推 budgetManual） */
+  budgetRange: string | null
+  /** ⚠️ 后端 VO 声明了该字段但**恒为 null**（Bo 里被注释、表无该列）→ 不要依赖它回填手填内容 */
+  budgetCustom: string | null
+  developmentCycle: number | null
+  supplementaryRemarks: string | null
+  userName: string | null
+  userPhone: string | null
+  attachmentInfo: DemandAttachment[] | null
+}
+
+/** 附件上传返回（后端 SysOssVo） */
+export interface OssUploadVo {
+  ossId: string | number
+  url: string
+  originalName: string
+  fileSuffix: string
+}
+
+/** OSS 换链返回项（GET /resource/oss/listByIds/{ids} 的子集） */
+export interface OssUrlVo {
+  ossId: string | number
+  /** 可直接访问的地址（阿里云 OSS 公网 URL） */
+  url: string
 }
diff --git a/src/types/business/home.d.ts b/src/types/business/home.d.ts
index 99edb5a..3eee878 100644
--- a/src/types/business/home.d.ts
+++ b/src/types/business/home.d.ts
@@ -1,7 +1,14 @@
-// 首页实体（PRD 3.1/3.2，page-architecture M1）
+// 首页类型（VIEW 类型 + 后端真实 VO 类型 + 门户入口类型，统一归位于 types/business/home.d.ts）
+//
+// - VIEW 类型（BusinessLine / HomeStats / ServiceType / ServiceContentBlock / QuickLink）：页面消费层
+// - 后端 VO 类型（Project* / BannerVo / AgreementFormVo / ProjectCaseVo）：vermis-maker
+//   com.ruoyi.vermins.controller.pc.web.UserSideWebHomePageController 与 ProjectCaseUserController 的真实返回
+// - 门户入口类型（PortalEntry* / EntryTone / PortalEntryCard）：IPortalEntryUserController，属首页快捷入口功能
 
 import type { BusinessType } from '@/types/api'
 
+/* ============================ VIEW 类型（页面消费层） ============================ */
+
 /** 数据看板 */
 export interface HomeStats {
   pending: number
@@ -9,7 +16,7 @@ export interface HomeStats {
   total: number
 }
 
-/** 快捷入口 */
+/** 快捷入口（VIEW 层占位，实际入口由门户接口驱动） */
 export interface QuickLink {
   label: string
   path: string
@@ -19,6 +26,19 @@ export interface QuickLink {
 export interface ServiceType {
   label: string
   desc: string
+  /** 图标（后端 icon_url 原样透传：图片地址时渲染为图，否则用名称首字兜底） */
+  icon?: string
+}
+
+/**
+ * 服务内容区块（对应后端富文本目录 `vm_project_submission_catalog` 的一条：
+ * 一条目录 = 详情页的一个「服务内容」区块，content 为富文本 HTML，可能内嵌图片/视频）
+ */
+export interface ServiceContentBlock {
+  /** 区块标题（后端 catalog.title，可为空） */
+  title: string
+  /** 区块内容（富文本 HTML 原文，直接渲染） */
+  content: string
 }
 
 /** 业务线（首页业务卡片 + 业务详情页共用） */
@@ -29,6 +49,179 @@ export interface BusinessLine {
   slogan: string
   icon: string
   serviceContent: string
+  /** 服务内容区块列表（一条富文本目录一项，详情页逐块渲染，保留 HTML） */
+  contents: ServiceContentBlock[]
   serviceTypes: ServiceType[]
   video: string
 }
+
+/* ============================ 后端真实 VO 类型 ============================ */
+
+/** GET /web/home-page/project-status-count —— 项目状态统计 */
+export interface ProjectStatusCount {
+  /** 项目数量 */
+  projectCount: number
+  /** 进行中的项目数目 */
+  ongoingProjectCount: number
+  /** 待处理数目 */
+  pendingProjectCount: number
+}
+
+/** 服务类型子项（service-type-list / service-type-detail 内含） */
+export interface ProjectServiceTypeVo {
+  id: number | null
+  projectId: number | null
+  serviceName: string | null
+  iconUrl: string | null
+  sortOrder: number | null
+}
+
+/** 项目背景（富文本） */
+export interface ProjectBackgroundVo {
+  id: number | null
+  projectId: number | null
+  content: string | null
+  sortOrder: number | null
+}
+
+/** 项目提报视图对象：service-type-list / service-type-detail/{id} 的返回 */
+export interface ProjectSubmissionVo {
+  id: number
+  businessType: string | null
+  title: string | null
+  subtitle: string | null
+  /** 是否启用：1 启用，0 停用 */
+  enabled: number | null
+  coverUrl: string | null
+  logoUrl: string | null
+  serviceTypes: ProjectServiceTypeVo[]
+  backgrounds: ProjectBackgroundVo[]
+  /** yyyy-MM-dd HH:mm:ss */
+  updateTime: string | null
+}
+
+/** GET /web/home-page/service-type-detail/{id} —— 项目提报详情（聚合 VO：主表单对象，三个子表均为一对多 List） */
+export interface ProjectSubmissionInfo {
+  projectSubmission: ProjectSubmissionFlat | null
+  /** 一对多：服务类型列表 */
+  projectServiceType: ProjectServiceTypeInfo[] | null
+  /** 一对多：附件列表 */
+  projectSubmissionAttachment: ProjectSubmissionAttachmentInfo[] | null
+  /** 一对多：富文本目录列表 */
+  projectSubmissionCatalog: ProjectSubmissionCatalogInfo[] | null
+}
+
+/** 主表 vm_project_submission（详情接口下发） */
+export interface ProjectSubmissionFlat {
+  id: number | null
+  businessType: string | null
+  title: string | null
+  subtitle: string | null
+  enabled: number | null
+  coverUrl: string | null
+  logoUrl: string | null
+}
+
+/** 服务类型 vm_project_service_type（详情接口各取一条） */
+export interface ProjectServiceTypeInfo {
+  id: number | null
+  projectId: number | null
+  serviceName: string | null
+  iconUrl: string | null
+  sortOrder: number | null
+}
+
+/** 附件 vm_project_submission_attachment（详情接口各取一条） */
+export interface ProjectSubmissionAttachmentInfo {
+  id: number | null
+  projectId: number | null
+  originalName: string | null
+  fileSize: string | null
+  url: string | null
+  sortOrder: number | null
+}
+
+/** 目录（富文本）vm_project_submission_catalog（详情接口各取一条） */
+export interface ProjectSubmissionCatalogInfo {
+  id: number | null
+  projectId: number | null
+  title: string | null
+  content: string | null
+  sortOrder: number | null
+}
+
+/** GET /web/home-page/carousel-list —— 轮播图 */
+export interface BannerVo {
+  id: number | null
+  imageUrl: string | null
+  sort: number | null
+  /** 是否启用（true 启用，false 停用） */
+  enabled: boolean | null
+}
+
+/** GET /web/home-page/platform-intro、contact-info —— 协议/静态文章富文本 */
+export interface AgreementFormVo {
+  id: number | null
+  /** 协议类型（目前只有「关于我们」一条） */
+  type: string | null
+  /** 文章内容（富文本 HTML） */
+  content: string | null
+}
+
+// 案例库的实体类型与 VO（ProjectCaseVo / ProjectCaseUserBo / CaseSelectionModel 等）
+// 已按「一页一套」归位到 `@/types/business/cases`，本文件不再重复定义。
+
+/* ============================ 门户入口（首页快捷入口功能） ============================ */
+
+/**
+ * 后端 IPortalEntryVo（入口目录 + 用户个性化分组）
+ *
+ * 
注意字段来源分两处：

+ * - 登录分支（selectByUserId）：name / id / icon / route / groupType / sortOrder / status，
+ *   其中 id 取的是 vm_portal_entry.id（入口目录主键）；
+ * - 匿名分支（selectVoList，MyBatis-Plus 自动 SQL）：多带 entryId 等目录字段，groupType 为目录默认值。
+ */
+export interface PortalEntryVo {
+  /** 入口主键 */
+  id: number | null
+  /** 入口标识 */
+  entryId: string | null
+  /** 显示名 */
+  name: string | null
+  /** 图标名 / URL */
+  icon: string | null
+  /** 跳转路由 */
+  route: string | null
+  /** 权限标识（空 = 无需权限） */
+  permission: string | null
+  /** 1 = 快捷、0 = 其他 */
+  groupType: string | null
+  /** 组内顺序 */
+  sortOrder: number | null
+  /** 1 = 启用、0 = 停用 */
+  status: boolean | null
+}
+
+/** 入口分组：1 = 快捷入口、0 = 其他入口 */
+export type PortalEntryGroup = '1' | '0'
+
+/** 页面消费的入口卡片（视图层类型，与后端字段解耦） */
+export interface PortalEntryCard {
+  /** 入口 id（切换分组时回传后端） */
+  id: number
+  /** 显示名 */
+  label: string
+  /** 跳转路由（可能为空，为空时不可点击跳转） */
+  route: string
+  /** 当前分组：1 = 快捷、0 = 其他 */
+  groupType: PortalEntryGroup
+  /** 图标：emoji 字符或图片地址 */
+  icon: string
+  /** icon 是否为图片地址 */
+  isImage: boolean
+  /** 图标底色主题 */
+  tone: EntryTone
+}
+
+/** 图标底色主题（设计稿为五色循环） */
+export type EntryTone = 'purple' | 'green' | 'blue' | 'amber' | 'red' | 'cyan'
diff --git a/src/types/business/project.d.ts b/src/types/business/project.d.ts
index 627b2c3..1c9d8d7 100644
--- a/src/types/business/project.d.ts
+++ b/src/types/business/project.d.ts
@@ -2,8 +2,108 @@
 
 import type { BusinessType, FileInfo } from '@/types/api'
 
-/** 项目状态 */
-export type ProjectStatus = '待立项' | '进行中' | '待验收' | '已完成' | '售后中' | '已取消'
+/**
+ * 项目状态（详情页展示口径，中文）。
+ *
+ * 
取值 = 两张表状态码值的并集经 {@link PROJECT_STATUS_LABEL} 映射后的中文：
+ * 需求侧 `INITIATING`（待立项）/ `CANCELLED`（已取消），项目侧 `IN_PROGRESS` /
+ * `PENDING_ACCEPTANCE` / `PENDING_INTERNAL_ACCEPTANCE` / `COMPLETED` / `AFTER_SALE`。
+ * 「待内部验收」数量少但确实存在，故保留。

+ */
+export type ProjectStatus =
+  | '待立项'
+  | '进行中'
+  | '待验收'
+  | '待内部验收'
+  | '已完成'
+  | '售后中'
+  | '已取消'
+
+/**
+ * 列表行状态码值 —— 后端 `COALESCE(rd_project.status, project_requirement.status)`。
+ *
+ * 
列表接口已改为「需求表为主 + LEFT JOIN 项目表」：已立项取项目状态，未立项回落到需求状态。
+ * 因此这里 = 两张表状态的并集：

+ * · 项目表 `vm_rd_project.status`：IN_PROGRESS / PENDING_ACCEPTANCE /
+ *   PENDING_INTERNAL_ACCEPTANCE / COMPLETED / AFTER_SALE / CANCELLED

+ * · 需求表 `vm_project_requirement.status` 额外提供：INITIATING（待立项）

+ *
+ * 
所以设计稿画的「待立项」现在是真实码值（= 需求已提报、尚未立项）。

+ */
+export type RdProjectStatus =
+  | 'INITIATING'
+  | 'IN_PROGRESS'
+  | 'PENDING_ACCEPTANCE'
+  | 'PENDING_INTERNAL_ACCEPTANCE'
+  | 'COMPLETED'
+  | 'AFTER_SALE'
+  | 'CANCELLED'
+
+/**
+ * 项目列表行 —— 后端 `RdProjectVo`（`GET /web/requirementPool/list` 的 `requirementPage.rows`）。
+ *
+ * 
`id` 后端是 Long，但全局 Jackson 配置序列化成字符串（已实测），故按 string 声明。
+ * `progress` 是 Integer，可能为 null（库里大量为空）⇒ 展示层要兜底成「—」。

+ */
+export interface RdProjectVo {
+  id: string
+  /** 外部项目关联的需求主键，内部项目为 null */
+  requirementId?: string | null
+  projectNo: string
+  /** EXTERNAL / INTERNAL */
+  sourceType?: string | null
+  /** 业务类型快照：存的是**提报表主键 id**（如 '1'），不是类型名 ⇒ 展示要经 label 映射 */
+  businessType?: string | null
+  projectName: string
+  requirementDesc?: string | null
+  customerName?: string | null
+  customerPhone?: string | null
+  submitUserId?: string | null
+  submitTime?: string | null
+  /** HIGH / MEDIUM / LOW */
+  priority?: string | null
+  status?: string | null
+  progress?: number | null
+  planStartTime?: string | null
+  planEndTime?: string | null
+  actualStartTime?: string | null
+  actualEndTime?: string | null
+  customerServiceName?: string | null
+  technicalOwnerName?: string | null
+  createTime?: string | null
+  updateTime?: string | null
+}
+
+/** 业务类型统计单项（后端 `ProjectRequirementCountVo`） */
+export interface ProjectBusinessTypeCount {
+  /** 提报表主键 id（与列表筛选参数 `businessType` 同口径） */
+  businessTypeId: string
+  /** 业务类型名称，如「互联网软件」 */
+  businessTypeLabel: string
+  count: number
+}
+
+/**
+ * 业务数据统计（后端 `ProjectRequirementStatisticsVo`）。
+ *
+ * 
来源是独立端点 `GET /web/requirementPool/getFilterConditions`（**全量口径**，不随筛选 / 分页变化）。

+ *
+ * 
⚠️ 列表接口 `/list` 响应里的同名字段后端仍是注释状态、实测恒为 `null`，**不要**拿它当统计源。
+ * 这里仍按「可能为 null」处理：拿不到时筛选栏只剩「全部」一行。

+ */
+export interface ProjectStatistics {
+  total?: number | null
+  businessTypeCounts?: ProjectBusinessTypeCount[] | null
+}
+
+/** 列表响应（后端 `ProjectRequirementAndCountVo`：分页数据 + 统计平级） */
+export interface ProjectListResult {
+  requirementPage?: {
+    total: number
+    rows: RdProjectVo[]
+  } | null
+  requirementStatistics?: ProjectStatistics | null
+}
 
 /** 里程碑节点 */
 export interface Milestone {
@@ -48,7 +148,11 @@ export interface AfterSalesPayload {
   attachments: FileInfo[]
 }
 
-/** 项目 */
+/**
+ * 项目详情（**详情页仍是前端 mock 形态**，尚未接后端）。
+ *
+ * 
列表已改走真实接口（见 {@link RdProjectVo}），本类型只服务详情页那几个组件。

+ */
 export interface Project {
   id: string
   projectNo: string
@@ -68,12 +172,201 @@ export interface Project {
   afterSales?: AfterSales
 }
 
-/** 项目列表查询条件 */
+/** 业务类型筛选项 + 件数（左侧筛选栏「业务类型」列表；「全部」的 value 为 'all'） */
+export interface ProjectTypeCount {
+  /** 'all' 表示「全部」；否则是后端下发的 `businessTypeId` */
+  value: string
+  /** 展示文案（后端 `businessTypeLabel`；「全部」由前端给） */
+  label: string
+  /** 该类型下的项目件数（后端全量口径；统计缺失时为 0） */
+  count: number
+}
+
+/**
+ * 项目列表查询条件（**已是后端口径**）。
+ *
+ * 
与 `RdProjectBo` 的字段对应关系：`keyword → key`、`businessType → businessType`（提报表 id）、
+ * `status → status`（码值）、`startDate/endDate 或 timeShortcut → beginTime/endTime`（两者都落在
+ * `create_time` 上）、`pageNum/pageSize → PageQuery`。

+ *
+ * 
用空串表示「不限」而不是 'all'——空串直接不出现在 querystring 里，与后端 `eqIfText` 的语义一致。

+ */
 export interface ProjectQuery {
   keyword: string
-  businessType: BusinessType | 'all'
-  status: ProjectStatus | 'all'
+  /** '' = 全部；否则为后端统计下发的 businessTypeId */
+  businessType: string
+  /** '' = 全部；否则为 {@link RdProjectStatus} 码值 */
+  status: string
+  /** 提交时间快捷区间；与 startDate/endDate 互斥（选其一会把另一组清空） */
   timeShortcut: 'all' | '3m' | '6m' | '1y'
-  page: number
+  /** 提交时间自选区间起（YYYY-MM-DD，空串 = 不限） */
+  startDate: string
+  /** 提交时间自选区间止（YYYY-MM-DD，空串 = 不限） */
+  endDate: string
+  pageNum: number
   pageSize: number
 }
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 详情契约：后端 `ProjectRequirementUserVo`（GET /web/requirementPool/get/{id}）
+//
+// 与列表不同，详情是「需求表为主 + 各子表按需填充」：需求未立项时 `vm_rd_project`
+// 没有对应行，项目侧字段（projectStage / projectMilestones / members / billPlans /
+// invoices / contracts）一律为空，需求侧字段（基本信息 / requirementAttachments /
+// afterSale）照常返回。
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** 开发进度（后端 `ProjectStage`，表 `vm_project_stage`） */
+export interface RequirementProjectStage {
+  id: string
+  projectId: string | null
+  requirementId: string | null
+  stageName: string | null
+  status: string | null
+  startTime: string | null
+  planTime: string | null
+  finishTime: string | null
+  /** 开发进度百分比（列表页那个 progress 的详情侧来源） */
+  developmentProgress: number | null
+  sort: number | null
+}
+
+/** 里程碑（后端 `RdProjectMilestone`，表 `vm_rd_project_milestone`） */
+export interface RequirementMilestone {
+  id: string
+  projectId: string | null
+  milestoneName: string | null
+  sortOrder: number | null
+  status: string | null
+  startTime: string | null
+  endTime: string | null
+  parallelFlag: boolean | null
+}
+
+/** 需求附件（后端 `ProjectRequirementAttachment`，表 `vm_project_requirement_attachment`） */
+export interface RequirementAttachment {
+  id: string
+  requirementId: string | null
+  /** 附件所属阶段，实测有 `REQUIREMENT` */
+  phase: string | null
+  ossId: string | null
+  originalName: string | null
+  url: string | null
+  fileSize: number | null
+  sortOrder: number | null
+  /** 上传时间（继承 BaseEntity，后端会下发） */
+  createTime?: string | null
+}
+
+/** 项目团队（后端 `RdProjectMember`，表 `vm_rd_project_member`） */
+export interface RequirementMember {
+  id: string
+  projectId: string | null
+  userId: string | null
+  userName: string | null
+  roleKey: string | null
+  roleName: string | null
+  isOwner: boolean | null
+}
+
+/** 付款计划（后端 `BillPlan`，表 `vm_bill_plan`） */
+export interface RequirementBillPlan {
+  id: string
+  projectId: string | null
+  projectNo: string | null
+  projectName: string | null
+  totalAmount: number | null
+  periods: number | null
+  currentPeriod: number | null
+  periodRule: string | null
+  nextDate: string | null
+  status: string | null
+}
+
+/** 发票（后端 `Invoice`，表 `vm_invoice`） */
+export interface RequirementInvoice {
+  id: string
+  billId: string | null
+  invoiceTitle: string | null
+  taxNo: string | null
+  invoiceType: string | null
+  amount: number | null
+  status: string | null
+  invoiceNo: string | null
+  /** 电子发票文件地址 */
+  invoiceFile: string | null
+  applyTime: string | null
+  invoiceDate: string | null
+  /** 申请时间（继承 BaseEntity，后端会下发） */
+  createTime?: string | null
+}
+
+/** 合同（后端 `Contract`，表 `vm_contract`） */
+export interface RequirementContract {
+  id: string
+  contractNo: string | null
+  projectId: string | null
+  title: string | null
+  amount: number | null
+  signStatus: string | null
+  status: string | null
+  signDate: string | null
+  /** 合同文件地址 */
+  file: string | null
+  /** 签署时间（继承 BaseEntity，后端会下发） */
+  createTime?: string | null
+}
+
+/** 售后工单（后端 `ProjectRequirementAfterSale`，表 `vm_project_requirement_after_sale`） */
+export interface RequirementAfterSale {
+  id: string
+  requirementId: string | null
+  /** 售后原因 */
+  reason: string | null
+  status: string | null
+  requestUserName: string | null
+  requestTime: string | null
+  processUserName: string | null
+  processNote: string | null
+  processTime: string | null
+  withdrawReason: string | null
+}
+
+/**
+ * 需求详情响应（后端 `ProjectRequirementUserVo`）。
+ *
+ * 
注意两个「名字骗人」的字段：`attachments` / `afterSales`（复数）后端**从未赋值**，
+ * 真正有数据的是 `requirementAttachments` 与 `afterSale`（单数）。前端只取后者。

+ */
+export interface RequirementDetailVo {
+  id: string
+  projectNo: string | null
+  submitUserId: string | null
+  submitUserName: string | null
+  submitPhone: string | null
+  /** 业务类型**中文名**（如「硬件电路」），非英文 code */
+  businessType: string | null
+  projectName: string | null
+  requirementDesc: string | null
+  priority: string | null
+  /** 状态码值：需求侧 INITIATING/CANCELLED，项目侧 IN_PROGRESS/… */
+  status: string | null
+  customerServiceName: string | null
+  customerServicePhone: string | null
+  technicalOwnerName: string | null
+  internalRemark: string | null
+  attachmentCount: number | null
+  createTime: string | null
+  updateTime: string | null
+  launchNote: string | null
+  cancelReason: string | null
+  /** 未立项时为 null */
+  projectStage: RequirementProjectStage | null
+  projectMilestones: RequirementMilestone[]
+  requirementAttachments: RequirementAttachment[]
+  members: RequirementMember[]
+  billPlans: RequirementBillPlan[]
+  invoices: RequirementInvoice[]
+  contracts: RequirementContract[]
+  afterSale: RequirementAfterSale | null
+}
diff --git a/src/types/business/user.d.ts b/src/types/business/user.d.ts
index c2f232f..757ae58 100644
--- a/src/types/business/user.d.ts
+++ b/src/types/business/user.d.ts
@@ -10,6 +10,21 @@ export interface User {
   passwordModifiedAt: string
 }
 
+/**
+ * 登录用户资料（GET /system/user/profile，后端 SysUserVo 的子集）。
+ *
+ * 
字段名与后端一致：`nickName` / `phoneNumber`（不是 nickname / phone）。

+ */
+export interface UserProfileVo {
+  userId: string
+  userName: string
+  nickName: string
+  phoneNumber: string
+  email: string
+  avatarUrl: string
+  deptName: string
+}
+
 /** 账号密码登录参数 */
 export interface LoginByAccountParams {
   account: string
diff --git a/src/types/router.d.ts b/src/types/router.d.ts
index 0e3ee2d..d98fcdf 100644
--- a/src/types/router.d.ts
+++ b/src/types/router.d.ts
@@ -7,5 +7,12 @@ declare module 'vue-router' {
     title?: string
     /** 是否需要登录 */
     requiresAuth?: boolean
+    /**
+     * 是否展示公共底栏（AppFooter）。
+     *
+     * 
默认不展示：底栏信息量大、只在门户首页作为站点信息区出现，
+     * 其余页面（列表/详情/登录区）不渲染，避免干扰正文。

+     */
+    footer?: boolean
   }
 }
diff --git a/src/utils/format.ts b/src/utils/format.ts
index 6eb4de3..547a190 100644
--- a/src/utils/format.ts
+++ b/src/utils/format.ts
@@ -1,7 +1,6 @@
 // 格式化工具（无 Vue 依赖）
 
 import type { BusinessType } from '@/types/api'
-import type { ScaleRange } from '@/types/business/cases'
 
 const BUSINESS_TYPE_LABELS: Record = {
   internet: '互联网软件',
@@ -11,12 +10,23 @@ const BUSINESS_TYPE_LABELS: Record = {
   other: '其他',
 }
 
-const SCALE_LABELS: Record = {
-  lt50w: '50万以下',
-  '50to100w': '50-100万',
-  '100to300w': '100-300万',
-  '300to500w': '300-500万',
-  gt500w: '500万以上',
+const BUSINESS_TYPE_CODES = Object.keys(BUSINESS_TYPE_LABELS) as BusinessType[]
+
+/**
+ * 后端业务类型归一化：兼容英文 code（internet）与中文名称（互联网软件），未知值归 other。
+ *
+ * 
后端案例表 / 项目提报表的 business_type 是自由文本，历史数据里两种写法混存，
+ * 展示与筛选都需要先归一化到前端 BusinessType。

+ */
+export function toBusinessType(raw: string | null | undefined): BusinessType {
+  const value = (raw ?? '').trim()
+  if (!value) return 'other'
+  const lower = value.toLowerCase()
+  return (
+    BUSINESS_TYPE_CODES.find((code) => code === lower)
+    ?? BUSINESS_TYPE_CODES.find((code) => BUSINESS_TYPE_LABELS[code] === value)
+    ?? 'other'
+  )
 }
 
 /** 业务类型展示名 */
@@ -24,11 +34,6 @@ export function formatBusinessType(type: BusinessType): string {
   return BUSINESS_TYPE_LABELS[type]
 }
 
-/** 项目规模展示名 */
-export function formatScale(scale: ScaleRange): string {
-  return SCALE_LABELS[scale]
-}
-
 /** 金额千分位（默认两位小数） */
 export function formatMoney(value: number, decimals = 2): string {
   const fixed = value.toFixed(decimals)
diff --git a/src/utils/request.ts b/src/utils/request.ts
index 0b2553d..6ee265f 100644
--- a/src/utils/request.ts
+++ b/src/utils/request.ts
@@ -7,6 +7,16 @@ import { storage } from '@/utils/storage'
 // 鉴权头 Authorization: Bearer  已与后端 sa-token.token-prefix=Bearer 对齐，无需改动。
 const SUCCESS_CODE = 200
 
+/**
+ * PC 端 clientId（sys_client 种子数据，grantType 含 password）。
+ *
+ * 后端 SecurityConfig 对每个已登录请求做多端隔离校验：
+ * header / query 里的 clientid 必须与登录时写入 token 的 clientid 一致，
+ * 否则抛 NotLoginException「客户端ID与Token不匹配」。
+ * 所以此值必须与登录、注册请求体的 clientId 完全同源。
+ */
+export const CLIENT_ID = 'e5cd7e4891bf95d1d19206ce24a7b32e'
+
 /** 全项目唯一 axios 实例 */
 const service = axios.create({
   baseURL: import.meta.env.VITE_API_BASE_URL,
@@ -18,6 +28,8 @@ service.interceptors.request.use((config) => {
   if (token) {
     config.headers.Authorization = `Bearer ${token}`
   }
+  // 带 token 的请求必须回传 clientid，否则后端 SecurityConfig:97-106 校验不通过
+  config.headers.clientid = CLIENT_ID
   return config
 })
 
@@ -26,6 +38,35 @@ service.interceptors.response.use(undefined, (error) => {
   return Promise.reject(error)
 })
 
+/**
+ * 查询参数序列化（按 Spring MVC WebDataBinder 的绑定约定）。
+ *
+ * 
axios 默认把嵌套对象序列化成 `scales[0][lowerLimit]`，而 Spring 只认点号路径
+ * `scales[0].lowerLimit`——实测用默认形式后端直接 HTTP 500，故需要序列化的接口
+ * 统一走本函数（`paramsSerializer: { serialize: serializeQuery }`）。

+ */
+export function serializeQuery(params: Record): string {
+  const parts: string[] = []
+
+  function append(key: string, value: unknown): void {
+    if (value === undefined || value === null || value === '') return
+    if (Array.isArray(value)) {
+      value.forEach((item, index) => append(`${key}[${index}]`, item))
+      return
+    }
+    if (typeof value === 'object') {
+      for (const [subKey, subValue] of Object.entries(value as Record)) {
+        append(`${key}.${subKey}`, subValue)
+      }
+      return
+    }
+    parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
+  }
+
+  for (const [key, value] of Object.entries(params)) append(key, value)
+  return parts.join('&')
+}
+
 /**
  * 统一请求：自动解包 ApiResponse，失败统一提示并 reject
  * 页面/组件禁止直接 import axios，一律经 store 调用本函数
diff --git a/src/views/cases/cpns/CaseDetailHeader.vue b/src/views/cases/cpns/CaseDetailHeader.vue
index d845a93..9a9aa2c 100644
--- a/src/views/cases/cpns/CaseDetailHeader.vue
+++ b/src/views/cases/cpns/CaseDetailHeader.vue
@@ -1,164 +1,185 @@
 
 
 
 
 
diff --git a/src/views/cases/cpns/CaseRichText.vue b/src/views/cases/cpns/CaseRichText.vue
index a19adb5..ff4a5ba 100644
--- a/src/views/cases/cpns/CaseRichText.vue
+++ b/src/views/cases/cpns/CaseRichText.vue
@@ -5,53 +5,84 @@ interface Props {
   item: Case
 }
 
-defineProps()
+const props = defineProps()
 
-const sections = [
-  { key: 'background', title: '项目背景', field: 'background' },
-  { key: 'painPoints', title: '客户痛点', field: 'painPoints' },
-  { key: 'requirements', title: '需求描述', field: 'requirements' },
-  { key: 'deliverables', title: '交付物', field: 'deliverables' },
-] as const
+/**
+ * 案例正文区块（设计稿：一段一张白卡，卡片标题带蓝色竖条）。
+ *
+ * 
区块的**数量与标题都来自后端**（vm_project_case_catalog：title + content，
+ * 按 sort_order 升序），前端不再写死「项目背景 / 客户痛点 / 需求描述 / 交付物」，
+ * 后端增删目录即自动生效。空内容已在 utils/caseVo.ts#toSections 里过滤。

+ */
 
 
 
 
 
diff --git a/src/views/cases/cpns/CasesFilter.vue b/src/views/cases/cpns/CasesFilter.vue
index 5f55f88..e3baa4f 100644
--- a/src/views/cases/cpns/CasesFilter.vue
+++ b/src/views/cases/cpns/CasesFilter.vue
@@ -1,15 +1,22 @@
 
 
 
 
 
diff --git a/src/views/cases/cpns/CasesGrid.vue b/src/views/cases/cpns/CasesGrid.vue
index a419cb4..9608867 100644
--- a/src/views/cases/cpns/CasesGrid.vue
+++ b/src/views/cases/cpns/CasesGrid.vue
@@ -4,23 +4,34 @@ import type { Case } from '@/types/business/cases'
 
 interface Props {
   cases: Case[]
+  /** 当前筛选条件下的案例总数 */
+  total: number
 }
 
 defineProps()
 
-const emit = defineEmits<{ view: [id: string] }>()
+const emit = defineEmits<{
+  view: [id: string]
+  favorite: [id: string]
+}>()
 
 
 
 
 
diff --git a/src/views/home/cpns/HomeWelcome.vue b/src/views/home/cpns/HomeWelcome.vue
index f70c8ba..3ab3181 100644
--- a/src/views/home/cpns/HomeWelcome.vue
+++ b/src/views/home/cpns/HomeWelcome.vue
@@ -18,57 +18,42 @@ const greeting = computed(() => {
 
 
 
 
 
diff --git a/src/views/home/detail.vue b/src/views/home/detail.vue
index aff3793..68f1738 100644
--- a/src/views/home/detail.vue
+++ b/src/views/home/detail.vue
@@ -1,12 +1,15 @@