费用
无需离开项目管理工具即可跟踪技术栈成本。Almirant 的费用模块可让你记录、分类和分析与项目相关的所有成本：从 SaaS 订阅和托管服务，到 AI API 成本和供应商账单。
为什么要在项目管理工具中管理费用
技术团队需要处理会直接影响项目的多项成本：
- AI 成本：OpenAI API、Anthropic API、生产环境 ML 模型
- 基础设施：AWS、GCP、Vercel、托管、托管数据库
- SaaS 订阅：GitHub、Figma、Slack、开发工具
- 外部服务：CDN、电子邮件服务、分析工具
- 供应商：自由职业者、顾问、专业服务
将这些成本与团队工作一同呈现，可帮助你作出更好的产品决策，并基于完整信息确定优先级。
什么是费用
费用是与组织或项目关联的成本记录。每项费用具有以下字段：
| 字段 | 必填 | 描述 | 示例 |
|---|---|---|---|
| 标题 | 是 | 费用的描述性名称 | “OpenAI API - 2024 年 3 月” |
| 金额 | 是 | 费用金额 | 450.00 |
| 货币 | 是 | ISO 货币代码 | EUR、USD、GBP |
| 分类 | 否 | 费用分类 | “基础设施 > 云” |
| 日期 | 是 | 费用日期 | 2024-03-15 |
| 供应商 | 否 | 供应商或服务名称 | “OpenAI” |
| 描述 | 否 | 费用的附加详情 | “功能 X 的 GPT-4 API 使用量” |
| 项目 | 否 | 费用归属的项目 | “移动应用 v2” |
| 付款人 | 否 | 完成付款的用户 | “Juan Garcia” |
费用状态
费用会根据组织的审批流程经历不同状态：
| 状态 | 描述 |
|---|---|
| draft | 待完成的草稿 |
| pending_approval | 已提交审批 |
| approved | 已批准，等待付款 |
| rejected | 被审批人拒绝 |
| paid | 已付款并完成 |
| void | 已作废（不计入统计） |
创建费用
- 从主菜单访问 费用。
- 单击 新建费用。
- 填写必填字段（标题、金额、货币、日期）。
- 可选择分类、项目并附加发票。
- 保存为草稿或提交审批。
层级分类
费用按树状结构的分类组织，可实现所需的精细程度：
费用
├── 基础设施
│ ├── 云（AWS、GCP、Azure）
│ ├── 托管（Vercel、Railway）
│ └── 数据库
├── SaaS
│ ├── 开发（GitHub、GitLab）
│ ├── 设计（Figma、Adobe）
│ └── 通信（Slack、Notion）
├── AI 和 ML
│ ├── API（OpenAI、Anthropic）
│ └── 自有模型
├── 营销
│ ├── 广告
│ └── 工具
└── 专业服务
├── 咨询
└── 自由职业者
创建分类
- 在费用设置中，访问 分类。
- 单击 新建分类。
- 输入名称、图标和颜色。
- 可选择父分类。
分类具有控制其位置的 order 字段，可通过 isActive = false 停用，而无需删除关联费用。
经常性费用
对于定期重复的成本（订阅、月度服务），可以配置经常性费用：
| 字段 | 描述 | 示例 |
|---|---|---|
| 标题 | 经常性费用名称 | “Vercel Pro” |
| 供应商 | 服务或公司 | “Vercel” |
| 金额 | 每期金额 | 20.00 |
| 货币 | 费用货币 | USD |
| 周期 | 费用频率 | monthly |
| 锚定日期 | 参考日期 | 2024-01-01 |
| 下次续订 | 自动计算 | 2024-04-01 |
| 提前提醒天数 | 提醒的提前天数 | 7 |
可用周期
| 周期 | 描述 |
|---|---|
| weekly | 每周 |
| monthly | 每月 |
| quarterly | 每季度 |
| yearly | 每年 |
活跃的经常性费用会自动显示下次续订日期，并可生成可配置的提醒。
多币种支持
Almirant 支持多种货币，并自动转换为 EUR 以进行汇总：
| 货币 | 代码 |
|---|---|
| 欧元 | EUR |
| 美元 | USD |
| 英镑 | GBP |
| 瑞士法郎 | CHF |
| 日元 | JPY |
| 加拿大元 | CAD |
| 澳大利亚元 | AUD |
| 墨西哥比索 | MXN |
| 巴西雷亚尔 | BRL |
| 智利比索 | CLP |
| 哥伦比亚比索 | COP |
| 阿根廷比索 | ARS |
每项费用存储：
amount：原始货币金额currency：ISO 货币代码amountEur：转换为 EUR 的金额exchangeRate：应用的汇率
汇总和报告基于 amountEur 计算，以比较不同货币的费用。
发票和附件
每项费用都可以附加发票。Almirant 存储：
| 字段 | 描述 |
|---|---|
invoiceFileName | 文件名称 |
invoiceUrl | 文档在 S3 中的 URL |
invoiceFileSize | 字节大小 |
invoiceMimeType | MIME 类型（application/pdf、image/png 等） |
invoiceProcessingStatus | 处理状态 |
发票处理状态
| 状态 | 描述 |
|---|---|
| pending | 等待处理 |
| processing | 正在处理（OCR/AI） |
| processed | 处理成功 |
| failed | 处理出错 |
自动处理可通过 OCR 从发票中提取数据，以自动填充费用字段。
仪表板和汇总
费用主视图包含带有关键指标的仪表板：
可用指标
| 指标 | 描述 |
|---|---|
| 总计 | 费用总和（以 EUR 计） |
| 按人员 | 按付款用户细分 |
| 按分类 | 按分类分布 |
| 按月 | 时间变化趋势 |
| 最近 | 最新记录的费用 |
筛选器
可按以下条件筛选费用：
- 日期范围
- 分类（包括子分类）
- 项目
- 状态
- 供应商
- 付款用户
开发者指南
开发者指南
MCP 工具
| 工具 | 描述 | 主要参数 |
|---|---|---|
create_expense | 创建新费用 | title, amount, currency, expenseDate, categoryId, projectId |
get_expense | 按 ID 获取费用 | expenseId |
list_expenses | 列出带筛选条件的费用 | projectId, categoryId, status, dateFrom, dateTo |
get_expense_summary | 获取汇总 | projectId, dateFrom, dateTo |
list_expense_categories | 列出分类 | includeInactive |
list_recurring_expenses | 列出经常性费用 | isActive |
示例：创建费用
Tool: create_expense
Parametros:
title: "AWS EC2 - Marzo 2024"
amount: 234.50
currency: "USD"
expenseDate: "2024-03-31"
categoryId: "uuid-categoria-cloud"
projectId: "uuid-proyecto"
vendor: "Amazon Web Services"
示例：获取费用汇总
Tool: get_expense_summary
Parametros:
projectId: "uuid-proyecto"
dateFrom: "2024-01-01"
dateTo: "2024-03-31"
返回：
- 该期间的费用总额（以 EUR 计）
- 按分类细分
- 按人员细分
- 月度趋势
- 最近费用