# 小马工单

**Repository Path**: dlmshk/horse-order

## Basic Information

- **Project Name**: 小马工单
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-16
- **Last Updated**: 2026-07-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文档索引

本目录存放项目的可执行业务、技术和交付文档。根目录 [roadmap.md](../roadmap.md) 是唯一的进度总索引和工程约束来源。

## 产品

| 文档 | 内容 |
| --- | --- |
| [产品范围](product/scope.md) | 产品目标、P0 边界、术语和验收闭环。 |
| [工单流程](product/work-order-flow.md) | 状态机、数量、父子工序、快照与异常规则。 |
| [工艺、路线与工序](product/process-route-and-documents.md) | 工艺文件、工序字典、路线模板、工单实例和质检配置。 |
| [不良与返修处理](product/nonconformance-and-rework.md) | 内部返修、辅助工序、上游回流、报废和数量规则。 |
| [现场控制与追溯扩展](product/shop-floor-control.md) | 批次、人员/设备准入、在制位置、拆合单、工时和升级规则。 |
| [角色权限](product/roles-and-permissions.md) | 组织、角色和数据范围。 |
| [产品设计原则](product/design-principles.md) | 成熟制造系统的可用性取舍与反过度设计规则。 |
| [数据质量与报表](product/data-quality-and-reporting.md) | 数据口径、校验、追溯和可下钻报表。 |
| [产值与工序比例](product/output-value.md) | 产品单位产值、工序比例、产值流水和统计口径。 |
| [上游资料与快速建单](product/upstream-data-import.md) | 多来源字段映射、流转卡载入、去重和工单快照。 |

## 技术架构

| 文档 | 内容 |
| --- | --- |
| [总体架构](architecture/overview.md) | 模块化单体、系统边界和模块职责。 |
| [数据模型](architecture/data-model.md) | 实体关系、核心表、约束和事务。 |
| [后端与环境](architecture/backend-and-environment.md) | Go 技术栈、MySQL、本地环境和开发约束。 |
| [API 与集成](architecture/api-and-integration.md) | API 约定、P0 接口和外部集成。 |
| [OpenAPI 契约](api/openapi.yaml) | 已实现 P0 HTTP API、认证、请求模型和统一错误响应。 |
| [安全与运维](architecture/security-and-operations.md) | 安全、备份、可观测性和租户隔离。 |
| [实施取舍](architecture/implementation-principles.md) | 渐进交付、配置边界与避免过度设计。 |

## 前端与车间端

| 文档 | 内容 |
| --- | --- |
| [多端方案](frontend/multi-platform.md) | Vue、uni-app、小程序、H5 和 App 的边界。 |
| [组件与工程](frontend/component-architecture.md) | 前端 feature、组件、composable 和平台适配约束。 |
| [页面与交互](frontend/pages-and-interactions.md) | 管理后台、车间端页面和高频交互规则。 |

## 交付

| 文档 | 内容 |
| --- | --- |
| [研发里程碑](delivery/milestones.md) | S0 至 P2 的阶段目标和验收。 |
| [测试策略](delivery/testing.md) | 单元、集成、端到端和现场验收。 |
| [模拟数据](delivery/demo-data.md) | 可重复执行的本地模拟租户和演示数据入口。 |
| [首版准备](delivery/p0-readiness.md) | 试点前的业务和环境准备项。 |
| [试点资料收集](delivery/pilot-intake.md) | 产品、路线、权限、异常、流转卡、样例工单和现场设备资料模板。 |
| [现场验收运行手册](delivery/field-acceptance.md) | 六张样例工单、扫码/弱网/标签、角色边界和现场证据记录。 |
| [Gitee 流水线说明](delivery/gitee-pipeline.md) | 已取消的 Gitee 流水线方案留档，不作为当前验收门槛。 |

## 进度

| 文档 | 内容 |
| --- | --- |
| [进行中](roadmap/active.md) | 当前迭代工作。 |
| [已完成](roadmap/done.md) | 已完成且已验证的工作。 |
| [未来计划](roadmap/future.md) | 尚未排期的能力。 |

维护规则：单个文档超过约 500 行或出现两个独立主题时，在对应分类下建立二级目录拆分；新文档必须补充到本索引。