# account-service

**Repository Path**: edcX/account-service

## Basic Information

- **Project Name**: account-service
- **Description**: 湖北省政务网saas注册
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-28
- **Last Updated**: 2026-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# account-service

经营主体政务事项自动化 SaaS 平台。最终目标为武汉市全部受理区划的个体工商户和有限公司设立登记；当前阶段先只跑通个体工商户完整链路，有限公司流程暂缓。青山区个体户住所承诺仅作为首条真实验收路线。重构及跨端验证仍在进行，不代表全市已完成真实自动办理。

## 后续开发基线

后续注册开发采用经双审确认的 [PSK-1 架构](docs/architecture/registration-page-step-kernel.md)、[行为规格](openspec/changes/page-step-registration-kernel/specs/page-step-registration-kernel/spec.md) 与 [阶段任务](openspec/changes/page-step-registration-kernel/tasks.md)：保留业务平台和后端权威，以住所页实验开始定向替换注册执行内核。正式文档先由 Codex 与 `gemini-3.8-flash-high` 审核；未通过不写入，不绕过实验直接全盘重写。

当前代码和部署仍含旧逐动作候选/审批机制。以下执行流程描述原有机制与业务目标，不代表 PSK 新内核已经实现；历史未完成验收保持未完成。新版本目标由 Worker 显式页面步骤核验真实 UI 联动，后端保留租约、独立结果核验、检查点及提交防重。

## 原有执行流程与业务目标

```text
BusinessOrder
-> 主体资料、材料、代理资格、支持范围与自动提交授权预检
-> 合格代理账号随机调度与数据库租约
-> 不可变 RegistrationExecutionSnapshot
-> 身份证预处理及 READY 材料校验
-> MatterExecutionRunner：确定性页面处理器选择动作
-> 确定性校验、动作合同冻结、同一 Playwright Worker 正常 UI 办理
-> 逐动作页面、API 和截图证据
-> 一次性提交及结果证据
-> PRE_REVIEW_SUBMITTED + application/business id
-> 关闭浏览器、回调终态、释放租约
```

技术栈为 React、Spring Boot、MySQL、Redis、MinIO 和 Playwright。当前注册由同一服务器 Worker 的确定性页面处理器通过正常 UI 执行，不调用模型、不保留 AI 兜底或未知页面自动学习。所有业务值来自不可变订单快照与真实门户选项；未知页面或流程缺口留证停止，由开发维护对应处理器。重试不得替换代理账号、资料或材料。历史采集记录及证据保留，历史完整技能不作为当前执行的通用准入条件。

## 个体户资料

- 草稿可以不完整；提交前校验经营者、身份证住址、名称、经营范围、武汉注册区划和明确住所模式。
- 资金、从业人数、组成形式和政治面貌缺省时，分别由数据库规则解析为 1 万元、1 人、个人经营、群众；客户明确值优先。
- 产权人姓名及手机号缺省时取本单经营者资料；代理身份只取已租用且备案合格的政务账号。
- 住所承诺由门户生成告知书，无承诺书上传槽位。住所申报需要产权证明，租赁或无偿使用还需要相应使用证明，并匹配经过证据验证的材料要求。
- 默认规则、执行知识和材料按主体、事项、区划、住所模式匹配。缺少当次动作所需来源时停止并报告具体缺口，不能复制青山门户编码或跨主体兜底。

## 有限公司资料

公司订单保存结构化人员实例、任职关系、自然人/组织股东、出资及材料关系。同人兼任共享身份，多人同角色分别绑定；资料与材料归属冻结后逐人消费，不能用个体经营者模型替代。公司默认邮寄领照，个体默认窗口领取，各自按精确作用域规则解析。

## 验证边界

人工演示已到达个体户住所承诺流程的网上预审结果页。代码的本地行为测试、持久化测试和 Playwright fixture 验证不代表服务器已经完成真实自动办理；住所申报仍需单独受控实走和知识验证。

只有一次正常 UI 提交的真实成功响应、与冻结申请绑定的流程标识及当前结果页“已提交登记机关网上预审”证据成立，才记录 PRE_REVIEW_SUBMITTED。空办件号如实保留，流程 ID 不冒充办件号；网上预审不等于登记机关审核通过。验证码、短信、人脸或统一身份认证无法无人通过时，以 AUTH_CHALLENGE 结束；未知写动作不得重放。结果证据保存后关闭浏览器，确认资源关闭后回调终态并释放租约，不继续查询后续审核。

## 开发入口

- [项目准则](AGENTS.md)
- [架构与运行文档](docs/README.md)
- [历史双主体重构合同（非当前实施路线）](docs/verification/wuhan-dual-subject-refactor-contract-20261003.md)
- [历史双主体回归与真实未完成项](docs/verification/wuhan-refactor-regression-20261003.md)
- [个体户办理规范](openspec/specs/individual-registration/spec.md)
- [本地 Java 21 构建](docs/runbooks/local-java21-maven-build.md)