Resminama mazmuny

接口与数据清单(统计口径如实交代)

本文档如实交代系统接口与数据对象的统计口径:直写接口 599 个,含配置引擎生成共 656 个,数据库表 110 张,并给出分业务域的逐项明细。

  • 接口总数两种口径:直写 599 个,含配置生成共 656 个
  • 599 个直写接口分散在 61 个接口文件中
  • 接口按十大业务域拆分,各块合计对齐 599
  • 全库 110 张表,落在 65 个模型文件里
  • 权限树节点 371 个,预置角色 14 个

送审和评标常要一句“你们有多少接口、多少数据对象”。光给一个总数是最容易被问倒的——同一个“接口数”,换一种数法就差几十个。 所以这份清单先说清怎么数的,再给分块。

B.1 一个总数,两种数法

  • 直写的接口:一个个处理函数明摆着标了方法的路由,实测共 599 个,分散在 61 个接口文件里。
  • 含配置生成的接口:再把由配置引擎在运行时按对象动态挂出来的子接口一并计入,总数到 656。

对外报数,两个都得能说清是哪一个。 单说 656 会被问“哪来的 57 个”,答“配置引擎生成的”才是实的;单说 599 又低估了系统真实能受理的入口。这本书取 656 为总口径、并注明其中 599 为直写,两个数同时给,不留含糊。

B.2 接口按业务域分块(直写 599 的拆法)

业务域直写接口数(约)覆盖
报价到订单119客户、询价、报价、合同、评审、可行性、订单、发货、工作台
工艺与产品101产品主数据、分类、清单、路线、工艺文件、流程图、控制计划、零件、工装、批量库
仓储与采购89仓库、库存、物料、采购、供应商
生产执行80工单、派工、报工、打样、试制、样品检、开工确认
平台底座78认证、系统、字段配置、模板、生成文档、文件、驾驶舱、报表、集成、同步
质量36检验、标准、失效模式
财务32发票对账回款、台账、报销
人员与审批29审批流、培训
设备21设备、校准、改造
售后与项目14售后、项目

合计 599。这几块里没有哪一块是“空架子”——每一块背后都能点回能力篇对应章的实证。

B.3 数据对象:110 张表

全库表实体 110 个,落在 65 个模型文件里。几个跟正文口径直接相关的数:

  • 带创建人的表:二十几张(含这一轮补齐的六张最该留人的表)。
  • 权限树节点 371:一级模块 21、菜单 90、操作点 260;在用权限码 174;预置角色 14、单角色最多 135。
  • 审批、字段配置、编号规则、状态字典:各成一族配置表,是第四十四章“能不能自己调”的落点。

B.4 端点分块的披露纪律

写这份清单守三条,也是全书对“数字”的态度:

  1. 一个数配一个口径,不给裸数(656 不说怎么来的,就不该印)。
  2. 近似与估算一律标明(周转率、账龄、达成率这些界面上都带估算字样)。
  3. 演示库小样本不进正文——本地验证库只用来对链路、证关联,它的具体条数不代表任何厂的业务现状,一个数都不往正文里搬。

接口与数据不是越多越好听,是能对得上、说得清才算数。 这份清单给的就是一份能拿去逐项对表、且每一项都知道边界在哪的底账。