feat(§T): 账户看板 + 场内模拟交易 9 端点(用户自助首版)
新增 §T 用户自助段(docs/05 §19 新号段 7 个 = A×40/C×7/K×4/M×4/O×3/R×4/T×9): - T001 GET /api/v1/users/me/account/dashboard — 账户/资金/持仓/盈亏汇总 - T002 POST /api/v1/users/me/orders — 委托提交(首版 market 立即全额成交) - T003 / T004 / T005 委托列表/详情/撤单 - T006 GET /api/v1/users/me/holdings — 持仓列表(含市值/盈亏/当日盈亏) - T007 / T008 成交记录列表/详情 - T009 GET /api/v1/users/me/cash-ledger — 资金账本 要点(与 docs/00 §6.6 一致): - 首版市价委托立即全额成交,不实现撮合队列/部分成交;T005 撤单首版对任何在场委托返回 ORDER_NOT_CANCELLABLE (409) - 价格来源复用 base FundQuoteService;service 层不二次封装(满足 AGENTS 第 2 条) - 首版风控 3 条硬性:产品可交易、客户适当性、持仓比例上限(fin_market_price 缺失或过期 → 拒绝买入) - 数据库零修改:10 张 fin_* 表全部 docs/00 既定,本批 PR 改列类型与可空性均 0;底座实际偏差(id 无 AUTO_INCREMENT、所谓'生成列'是普通 NOT NULL)由 service _next_id / 业务派生值补偿 注册 API:9 端点均注册进 app.main;user=9001(cust)'s id 写账 权限码(tools/seed_test_rbac.py 同步登记 + CUSTOMER 全量): 9047 account:read:self 9048 trade:order:create 9049 trade:order:read 9050 trade:order:cancel 9051 holding:read:self 9052 trade:txn:read 错误码(app/core/errors.py + docs/05 §3.6 + tests/unit/core/test_errors.py DOCUMENTED 三方同步): 404 ACCOUNT_NOT_FOUND / ORDER_NOT_FOUND 409 ORDER_NOT_CANCELLABLE 422 INSUFFICIENT_FUNDS / INSUFFICIENT_HOLDING / HOLDING_RATIO_EXCEEDED / SUITABILITY_MISMATCH / PRODUCT_NOT_TRADABLE 503 FUND_QUOTE_UNAVAILABLE(可重试) 新增:app/api/controllers/trading.py / app/api/schemas/trading.py / app/service/trade_service.py / tools/seed_sim_account_demo.py / tests/unit/service/test_trade_service.py(unit×8) / tests/contract/test_trading_endpoint_contract.py(contract×11) 修改:app/main.py(挂载 controller) / app/core/errors.py(10 新异常类) / tools/seed_test_rbac.py / docs/05-接口文档.md(§19 T001-T009 + §3.6 9 新码) / tests/unit/core/test_errors.py(DOCUMENTED 同步) 门禁:pytest tests/unit tests/contract 1313 passed (+19 新增) / ruff all clean / 三道守卫全过
This commit is contained in:
@@ -209,3 +209,78 @@ class FeedbackAlreadyExistsError(ConflictAgentError):
|
||||
"""同一用户对同一消息重复提交且内容不同(文档 §7.5)。"""
|
||||
|
||||
code = "FEEDBACK_ALREADY_EXISTS"
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# 场内基金模拟交易(§T 用户自助)错误码。
|
||||
# 对应基线 `docs/00` 第 6 章:买入前必须验证产品可用 + 适当性 + 持仓比例上限。
|
||||
# 错误码稳定,便于前端按 code 区分。
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
|
||||
class TradeError(AgentError):
|
||||
"""场内模拟交易错误基类。"""
|
||||
|
||||
|
||||
class ProductNotTradableError(TradeError):
|
||||
"""产品不可交易(停牌/退市/未开放)。"""
|
||||
|
||||
code = "PRODUCT_NOT_TRADABLE"
|
||||
status_code = 422
|
||||
|
||||
|
||||
class InsufficientFundsError(TradeError):
|
||||
"""可用资金不足以覆盖成交金额与费用。"""
|
||||
|
||||
code = "INSUFFICIENT_FUNDS"
|
||||
status_code = 422
|
||||
|
||||
|
||||
class InsufficientHoldingError(TradeError):
|
||||
"""可用持仓不足(卖出时)。"""
|
||||
|
||||
code = "INSUFFICIENT_HOLDING"
|
||||
status_code = 422
|
||||
|
||||
|
||||
class SuitabilityMismatchError(TradeError):
|
||||
"""客户适当性等级(C1-C5)与产品风险等级(R1-R5)不兼容。"""
|
||||
|
||||
code = "SUITABILITY_MISMATCH"
|
||||
status_code = 422
|
||||
|
||||
|
||||
class HoldingRatioExceededError(TradeError):
|
||||
"""超过单一投资者持有比例上限。"""
|
||||
|
||||
code = "HOLDING_RATIO_EXCEEDED"
|
||||
status_code = 422
|
||||
|
||||
|
||||
class FundQuoteUnavailableError(TradeError):
|
||||
"""实时行情缺失、非正数或过期。"""
|
||||
|
||||
code = "FUND_QUOTE_UNAVAILABLE"
|
||||
status_code = 503
|
||||
retryable = True
|
||||
|
||||
|
||||
class OrderNotCancellableError(TradeError):
|
||||
"""委托不可撤单(已成交/已撤单/已拒绝)。"""
|
||||
|
||||
code = "ORDER_NOT_CANCELLABLE"
|
||||
status_code = 409
|
||||
|
||||
|
||||
class OrderNotFoundError(TradeError):
|
||||
"""委托不存在或不属于当前客户。"""
|
||||
|
||||
code = "ORDER_NOT_FOUND"
|
||||
status_code = 404
|
||||
|
||||
|
||||
class AccountNotFoundError(TradeError):
|
||||
"""客户虚拟资金账户未开户。"""
|
||||
|
||||
code = "ACCOUNT_NOT_FOUND"
|
||||
status_code = 404
|
||||
|
||||
Reference in New Issue
Block a user