User

docs/产品设计文档.md §三 t_user; docs/.agents/common-context.md 术语规则


Report

docs/产品设计文档.md §三 t_report §5.3; docs/API-报告成片字段契约.md


ReportLead

docs/本期主线-下一步产品优化点.md §C 留资


updateStore

PUT /api/store/update
StoreController#update
StoreService#update


wxPhoneLogin

POST /api/user/wx-phone-login
UserController#wxPhoneLogin
UserService#loginByVerifiedPhone


createAppointment

petName petType serviceType appointmentTime storeId remark petId

POST /api/appointment/create
AppointmentController#create
AppointmentService#createBooking


startService

POST /api/appointment/start
AppointmentController#start
AppointmentService#startService


transitionAppointmentStatus

PUT /api/appointment/status
AppointmentController#updateStatus
AppointmentService#transitionStatus


submitReport

POST /api/report/create
ReportController#create
ReportService#create


submitLead

POST /api/report/{token}/reminder
ReportLeadController#submitReminder
ReportLeadService#submit


AppointmentCreated

appointmentId storeId userId appointmentTime


AppointmentStatusChanged

appointmentId fromStatus toStatus assignedUserId


ReportSubmitted

reportId appointmentId storeId reportToken


ReportOpened

docs/本期主线-下一步产品优化点.md 埋点事件 schema


ReportReopened

docs/本期主线-下一步产品优化点.md 埋点事件 schema


LeadSubmitted

reportTokenHash storeId hasPhone hasPetName repeatSubmit ts

docs/本期主线-下一步产品优化点.md 埋点事件 schema


报告前后照片必填

docs/产品设计文档.md §5.3 报告提交必填项


entity:store


entity:user


entity:appointment


entity:report


entity:report_lead


action:register_boss


action:login


action:wx_phone_login


action:create_appointment


action:start_service


action:transition_appointment_status


action:submit_report


action:track_report_open


action:submit_lead


ScheduleBlock

docs/产品设计文档.md §5.2 预约时段占用


HighlightVideo

docs/API-报告成片字段契约.md; docs/洗美报告短视频成片方案.md


createPet

POST /api/pet/create
PetController#create
PetService#create


updatePet

PUT /api/pet/update
PetController#update
PetService#update


deletePet

DELETE /api/pet/delete
PetController#delete
PetService#delete


getPetHistory

GET /api/pet/history
PetController#history
PetService#getServiceHistory


createServiceType

POST /api/service-type/create
ServiceTypeController#create
ServiceTypeService#create


dayAgenda

GET /api/schedule/day
ScheduleController#day
ScheduleService#dayAgenda


createScheduleBlock

POST /api/schedule/block
ScheduleController#createBlock
ScheduleService#createBlock


deleteScheduleBlock

DELETE /api/schedule/block
ScheduleController#deleteBlock
ScheduleService#deleteBlock


generateHighlight

docs/洗美报告短视频成片方案.md


createStaff

POST /api/user/create-staff
UserController#createStaff
UserService#createStaff


updateUser

PUT /api/user/update
UserController#updateUser
UserService#updateUser


HighlightSucceeded

reportTokenHash appointmentId durationSec composeMode ts

docs/本期主线-下一步产品优化点.md 埋点事件 schema


HighlightFailed

reportTokenHash appointmentId failReason ts

docs/本期主线-下一步产品优化点.md 埋点事件 schema


VideoPlay

docs/本期主线-下一步产品优化点.md 埋点事件 schema


VideoSave

docs/本期主线-下一步产品优化点.md 埋点事件 schema


ScheduleBlockCreated

blockId storeId slotStart blockType createdByUserId


成片三态 + composeMode

docs/洗美报告短视频成片方案.md; docs/API-报告成片字段契约.md


production profile：ddl=validate + show-sql=false + SMS 禁用


entity:user


entity:pet


entity:store


entity:report


action:generate_highlight


action:upload_image


action:create_schedule_block


action:delete_schedule_block


action:create_service_type


action:delete_service_type


action:create_pet


action:create_staff


action:update_user


action:bind_wechat


registerStaff

POST /api/user/register-staff
UserController#registerStaff
UserService#registerStaff


registerStore

POST /api/store/register
StoreController#register
StoreService#create


entity:report_testimonial


entity:service_interval


action:submit_testimonial


Membership

Phase A 门店后台明确不做；对标宠老板会员卡/升降级。仅 roadmap 占位。


StoredValue

Phase A 明确不做；依赖收银流水。


ServicePackage

Phase A 明确不做；次卡/套餐属 C 期。


ReportHistory

P2 方向库占位，不展开字段


AnalyticsDashboard

B 期经营看板；A 期工作台仅轻量指标卡，不展开本实体。


userSensitiveFieldsJsonIgnore

User 敏感字段不序列化


publicStoreFieldTrim

公开 get/list 经 toPublicStoreView 裁剪，不含 ownerId/inviteCode/deleted


oneReportOneTestimonial

一报告一寄语（重复提交更新）


serviceIntervalSuggestion

服务建议周期推算下次日期


trackVideoPlay

frontend reportView / videoPlayer (client-emitted)

docs/本期主线-下一步产品优化点.md 埋点事件 schema

前端客户端事件；上报与统计落地 gap


trackVideoSave

docs/本期主线-下一步产品优化点.md 埋点事件 schema

前端客户端事件；上报与统计落地 gap


logout

当前仅有签发无服务端吊销；前端清本地 token


testimonialSaved

reportTokenHash testimonialId isPublic ts

代码已写库；独立事件上报/统计未落地


entity:highlight_video

Report.highlight_fail_reason 使用 HighlightFailReason 归类


entity:session_token

AuthInterceptor 解析 token → CurrentUserContext


action:track_video_play


action:track_video_save


action:logout


rule:BR-USER-003

同样适用于 login/register/list_staff 等返回 User 的动作


rule:BR-TST-001


rule:BR-UNSUB-001


rule:BR-INT-001


rule:BR-STORE-003


AdminConsole

Phase A 产品预录入；独立 Web 端，与 uni-app 小程序并存。对标宠老板「店铺概况」入口，不做收银/库存。详见 docs/门店管理后台升级方案-对标宠老板.md


Workbench

todayAppointmentCount todayDoneCount pendingLeadCount highlightFailedCount todoItems reportFunnel anomalyList

Store Admin FE
Backend Core
Report Media Backend


WorkbenchTodoItem

kind: today_appointments | pending_report | highlight_anomaly | pending_lead


ServiceCustomer

userId displayName phoneMasked pets lastVisitAt lastReportId leadStatus source storeId


adminRoleGate

门店后台角色门禁（boss/staff 可读写）

boss 与 staff 均可进入 admin_console 并编辑本店数据；customer 禁止。删店/部分设置仍仅 boss（BR-STORE-001/BR-USER-001）。产品决策 2026-07-10。


adminStoreScope

后台数据仅本店 storeId

所有后台查询/写操作强制 current.storeId；忽略跨店请求参数。连锁同步不在 Phase A。


adminInternalFieldsAllowed

后台可看内部字段（与公开裁剪对称）

经 BR-ADMIN-001 鉴权后，后台可返回 inviteCode、完整报告内部字段等；公开 API 仍受 BR-STORE-003/BR-RPT-006 约束。手机号默认仍脱敏，明文需更高权限（预留）。


adminPhaseAOutOfScope

Phase A 后台范围闸门

禁止将 membership/stored_value/service_package/收银/库存/寄养/押金/点餐/支付宝渠道 写入 Phase A 后台范围或设计稿。上述保持 evidence=gap。


drilldownWorkbenchTodo

按 kind 跳转 admin_list_appointments / reports / leads 并带筛选。


adminListAppointments

status dateFrom dateTo assignedUserId page pageSize

Admin UI /appointments (planned)
reuses GET /api/appointment/list

Web 列表增强筛选；业务规则复用现有 Appointment*，不另造状态机。；Web 允许调用 start_service（产品决策 2026-07-10）


adminListReports

dateFrom dateTo highlightStatus page pageSize

Admin UI /reports (planned)
reuses GET /api/report/list

含成片三态、复制公开链接、触发重生成（复用 generate_highlight）。


adminListLeads

Admin UI /leads (planned)
reuses GET /api/report/leads


adminListServiceCustomers

source hasPendingLead lastVisitFrom lastVisitTo q page pageSize

GET /api/admin/service-customers
Admin UI /customers

产品决策：新建聚合 API，不以前端拼装为正式方案。Query: source,hasPendingLead,lastVisitFrom,lastVisitTo,q,page,pageSize；2026-07-10 已实现聚合 API


adminUpdateSettings

GET /api/admin/store
Admin UI /settings
PUT /api/store/update

后台读本店含 inviteCode（GET /api/admin/store）；写资料复用 PUT /api/store/update（仅 boss）；服务类型/员工复用既有 API。


adminManageSchedule

Admin UI /schedule
GET /api/schedule/day
POST /api/schedule/block
DELETE /api/schedule/block


workbenchViewed

可选埋点；A 期可不实现上报。


entity:admin_console


entity:workbench


entity:service_customer


action:view_workbench


rule:BR-ADMIN-001


rule:BR-ADMIN-002


rule:BR-ADMIN-004


action:admin_list_appointments


action:admin_list_reports


action:admin_list_leads


action:admin_list_service_customers


action:drilldown_workbench_todo