joey5628
446baf5939
- 页头平台选择器：PlatformProvider 加载平台目录与平台上下文
（X-Atlas-Platform-Id header），平台 id 仅作为非敏感 UI 偏好存
localStorage，默认取目录第一家（Ozon 优先）
- 店铺管理页覆盖 docs/api/stores-and-platforms.md 已实现接口：
游标分页列表、创建（202+operation）、编辑（If-Match 乐观锁、
409 刷新提示）、设为默认、重新验证凭据、仓库同步（422 脱敏
错误展示）、软删除（DEFAULT_STORE_REPLACEMENT_REQUIRED 提示）
- services/api.ts 新增 getList（保留 {data, meta} 分页信封）与
apiErrorCode；services/stores.ts 按契约生成 Idempotency-Key
- @atlas/contracts 补充只读响应类型 Platform / PlatformContext /
CursorPaginationMeta / StoreOperationResponse（无行为变更）
- API Key 仅存在于提交瞬间的内存表单，不落任何存储
- 浏览器实测：注册→平台切换→创建/编辑/设默认/删除保护/同步
错误路径→刷新会话恢复全部通过；typecheck + production build 通过
Atlas Seller Kit 文档
先确认产品需求，再进入数据库、接口和开发设计。本目录不代表已实施功能。
目录
| 类型 | 位置 | 内容 |
|---|---|---|
| 项目 | project/ |
产品定位、交接、协作约定与已确认的长期约束 |
| 产品需求 | requirements/ |
页面、流程、字段和待确认事项 |
| 基础架构 | architecture/ |
多租户、平台、门店、水印、物流和定价的数据设计及 DDL |
| 商品领域设计 | product/ |
已有的多 SKU 商品编辑页、领域模型与 API 草案 |
| 项目结构 | architecture/project-structure.md |
pnpm monorepo 的目录、依赖关系与本地运行边界。 |
| 外部平台资料 | integrations/ |
Ozon Seller API 的整理资料与适配依据 |
| 学习指南 | guides/ |
项目所用技术概念与设计原则的入门说明 |
| HTTP API 设计 | api/ |
可评审的服务端接口契约，按模块逐步补全。 |
| 设计评审 | reviews/ |
实现前待决问题、风险和关闭记录。 |
当前阅读顺序
project/development-collaboration-contract.md：所有人工与 AI 开发者必须遵守的协作、领域所有权、API 与数据约束。project/HANDOFF.md：项目边界和已经确认的商品规则。requirements/collector-browser-extension.md：来源商品采集、采集箱、多 SKU、插件认证和 Ozon Seller 网页观察实验。requirements/collection-box-and-online-products.md：采集箱、上架后编辑限制、按 SKU 展示的在线商品和 Ozon 异步同步需求。requirements/account-store-watermark.md：账户、门店和水印需求。requirements/pricing-tool.md：独立试算、SKU 定价方案和物流规则需求。requirements/cel-ozon-rfbs-rates-review.md：从 CEL Ozon-rFBS 资费表提取的待审核规则。architecture/foundation-data-model.md：基础模块数据模型和 PostgreSQL DDL。architecture/exchange-rates.md：系统汇率、CBR、免费备用接口、更新任务和报价快照规则。architecture/product-domain-data-model.md：采集箱、商品编辑、发布任务和在线商品镜像的数据库设计与 SQL。architecture/technology-and-deployment.md：已确认的 NestJS、PostgreSQL、Redis/BullMQ、MinIO、七牛 Kodo 与部署策略。architecture/database-security.md：迁移/应用数据库角色、RLS 强制策略与部署职责。architecture/transactional-outbox-and-idempotency.md：关键写请求去重、事务 Outbox、BullMQ 投递与验收规则。guides/object-storage-object-key.md：对象存储、object_key、来源 URL 与预签名 URL 的使用边界。guides/minio-local-deployment.md：MinIO 简介、本地 Docker 部署与应用侧使用方法。guides/postgresql-local-development.md：原生 PostgreSQL / Docker Compose 本地数据库、角色、迁移与建表。api/README.md：HTTP API 统一约定及第一批账户、门店、水印接口。reviews/implementation-readiness-open-items.md：实现前必须闭环的数据库/API 事项与已确认约束。- 后续按模块补全定价、采集、商品编辑、发布和在线商品接口。