Finance

spec: 1
id: finance
name: 财务
description: 个人酬金/收入（财务门户，仅校园网）、学费住宿费欠费和缴费记录（收费平台）。只读。
version: 0.4.0
author: pkuinfo
icon: card
homepage: https://github.com/pkuinfo/pku-harness-plugins/tree/main/plugins/finance
requires: [campus-session, campus-network, network]
# Money owed to and paid by the student, all read-only. Ported from the TypeScript plugin.
# - 财务综合信息门户 cwfw.pku.edu.cn (pkucli crates/cwfw; campus network only): the Wingsoft "WF"
#   portal. Every form body of the common*.action calls is obfuscated with encrypt(x) =
#   encode(encode2(x)) (shared.yaml), and button procedures are referenced by per-session hashes
#   parsed from each window definition. The harness `cwfw` session signs in.
# - 北京大学收费平台 cwpay.pku.edu.cn: the harness `cwpay` session signs in through IAAA, adds
#   X-Token and decrypts answers; tools read the `{messageCode, message, data}` envelope.
campus: [cwfw, cwpay]
shared: shared.yaml
tools:
  rewards: tools/rewards.yaml
  tuitionFees: tools/tuitionFees.yaml
  paymentOrders: tools/paymentOrders.yaml
  monthlyIncome: tools/monthlyIncome.yaml
  cardDeposits: tools/cardDeposits.yaml
  reimbursements: tools/reimbursements.yaml
  loans: tools/loans.yaml
  foreignRemittances: tools/foreignRemittances.yaml
  fxRates: tools/fxRates.yaml
  payrollIssued: tools/payrollIssued.yaml
  portalMenu: tools/portalMenu.yaml
  pendingPayments: tools/pendingPayments.yaml
  paymentProjects: tools/paymentProjects.yaml
  orderDetail: tools/orderDetail.yaml
  paymentSpending: tools/paymentSpending.yaml
  platformNotice: tools/platformNotice.yaml
widgets:
  fees: widgets/fees.json
dataSources:
  fees: { title: 学费住宿费未缴, tool: tuitionFees, ttl: 6h }
commands:
  fees: { description: 查学费、住宿费有没有欠费, aliases: [学费, 欠费, 住宿费], prompt: 我的学费和住宿费交清了吗？还欠多少？ }
  income: { description: 查今年的酬金/助学金收入, aliases: [酬金, 工资, 收入], prompt: 今年到现在我一共收到多少酬金？按月说一下。 }
i18n:
  en:
    name: Finance
    description: 'Your stipends and income (Finance portal, campus network only), plus unpaid tuition and housing fees and payment history (payment platform). Read-only.'
    tools:
      rewards: { title: Stipends and income, summary: 'Stipends, labour fees and other payments from PKU, by month' }
      tuitionFees: { title: Tuition and housing fees, summary: Tuition and housing fees due and paid per academic year }
      paymentOrders: { title: Payment history, summary: Your orders on the payment platform }
      monthlyIncome: { title: Monthly scholarships and pay, summary: 'Scholarships, grants and subsidies paid monthly' }
      cardDeposits: { title: Payments to my bank card, summary: Payments the university sent to your bank card }
      reimbursements: { title: Reimbursement status, summary: How many reimbursement claims are in each state }
      loans: { title: Outstanding advances, summary: Advances you still have to settle }
      foreignRemittances: { title: Incoming foreign remittances, summary: Foreign remittances received by PKU from a given payer }
      fxRates: { title: Exchange rates, summary: Exchange rates the finance office uses }
      payrollIssued: { title: Payments issued from my projects, summary: Payments issued from projects you manage }
      portalMenu: { title: Finance portal menu, summary: Which queries the finance portal offers your account }
      pendingPayments: { title: Pending bills (payment platform), summary: Bills waiting to be paid on the payment platform }
      paymentProjects: { title: Payment platform catalog, summary: 'What can be paid on the platform, and whether it is open now' }
      orderDetail: { title: Order details, summary: 'One payment order: status, channel and e-invoice link' }
      paymentSpending: { title: Payment platform spending, summary: 'What you paid on the platform, by project and month' }
      platformNotice: { title: Payment platform notice, summary: The notice on the payment platform home page }
    widgets:
      fees: { title: Tuition and housing, description: 'Unpaid tuition and housing fees on the payment platform (shows “All paid” when nothing is due).' }
    commands:
      fees: { prompt: 'Have I paid my tuition and accommodation fees? How much is still due?', description: Check for unpaid tuition or housing fees, aliases: [tuition] }
      income: { prompt: 'How much have I received in payments and stipends so far this year? Break it down by month.', description: This year’s stipends and other income, aliases: [stipend, salary] }
    dataSources:
      fees: { title: Unpaid tuition and housing }

{
  "id": "finance",
  "name": "财务",
  "description": "个人酬金/收入（财务门户，仅校园网）、学费住宿费欠费和缴费记录（收费平台）。只读。",
  "author": "pkuinfo",
  "kind": "builtin",
  "auth": "none",
  "icon": "card",
  "requires": [
    "campus-session",
    "campus-network",
    "network"
  ],
  "scopes": [
    "cwfw.pku.edu.cn",
    "cwpay.pku.edu.cn"
  ],
  "tags": [
    "official",
    "campus",
    "finance"
  ],
  "version": "0.4.0",
  "i18n": {
    "en": {
      "name": "Finance",
      "description": "Your stipends and income (Finance portal, campus network only), plus unpaid tuition and housing fees and payment history (payment platform). Read-only."
    }
  }
}