Odoo Reporting

核心用法

Odoo Skill 是一款面向企业财务团队的 ERP 数据智能分析工具，通过只读方式连接 Odoo 实例，生成销售人员绩效、客户分析、订单发票、CRM、会计、VAT、库存、应收应付等多维度报告。支持 WhatsApp 卡片、PDF、Excel 三种输出格式，内置自动可视化图表。

显著优点

安全架构领先：实现四层防御机制——①用户显式调用要求（AI 无法自主触发）②客户端只读强制执行（代码层面阻断 create/write/unlink）③凭据隔离（本地 .env 文件存储）④网络边界控制（仅连接用户指定 Odoo URL）。

财务专业深度：采用总账基础（Chart of Accounts + account.move.line）而非表面发票汇总，正确处理 Odoo 特有的 equity_unaffected 暂记账户，实时计算本年利润，确保资产负债表平衡。

智能标准适配：自动检测企业所在司法管辖区（IFRS/US GAAP/Ind-AS/中国准则等 10+ 标准），自动匹配数字格式、负数显示、日期格式和报表术语。

输出体验优化：默认自动包含可视化图表（从不要求"是否加图"），提供"Midnight Ledger"深色 WhatsApp 卡片主题和简洁 PDF 专业布局。

潜在缺点与局限性

配置门槛：必须预先配置 ODOO_URL/DB/USER/PASSWORD 四个环境变量，无 UI 向导，对非技术用户不够友好。

功能边界：严格只读设计意味着无法执行任何 ERP 操作（确认订单、过账凭证、审批等），纯粹是分析与报告工具。

单实例限制：每次调用仅能连接一个 Odoo 实例，跨公司集团分析需手动切换。

维护者风险：T3 级个人开发者来源，虽代码质量良好且有完整安全文档，但缺乏知名企业/组织的长期维护承诺。

适合人群

• 使用 Odoo ERP 的中小企业财务经理、CFO、会计团队
• 需要快速生成投资人/董事会汇报材料的企业管理者
• 销售团队负责人（分析销售人员绩效与客户数据）
• 有基础技术能力配置环境变量的用户

常规风险

1. SSL 验证可选禁用：存在 --insecure 标志可绕过证书验证，内部测试环境可能误用于生产
2. 本地敏感文件：财务报告 PDF/Excel 输出到本地目录，需自行管理文件权限
3. API 凭据暴露：环境变量方式在进程内可见，多用户服务器场景存在横向风险
4. Odoo 版本兼容性：XML-RPC 通用但 JSON-RPC 后端仅支持 Odoo 19+

核心功能

Odoo Financial Intelligence 是一款专为Odoo ERP系统设计的只读财务分析Skill，支持 salesperson 绩效追踪、客户分析、订单发票管理、CRM数据、会计总账、增值税、库存及应收应付账款等多维度查询。可自动生成WhatsApp卡片、PDF报告和Excel表格，适配IFRS、US GAAP、Ind-AS等全球主要会计准则。

显著优点

1. 深度安全架构：实施defense-in-depth安全模型，在代码层面强制只读访问——完全阻断create/write/unlink/action_post等数据修改方法，仅允许search/search_read/read等安全查询操作。AI模型无法自主调用，必须用户显式触发。

2. 零数据外泄设计：所有凭证存储于本地.env文件，从不记录或传输密码；报告生成于本地目录（output/pdf_reports/、output/whatsapp_cards/等），无云上传、无遥测、无外部服务器通信，仅连接用户指定的Odoo实例。

3. 多格式智能输出：自动根据报告类型生成适配可视化图表——WhatsApp卡片采用"Midnight Ledger"暗夜铜色主题，PDF采用专业简洁布局，无需用户额外确认即可输出完整可视化报告。

4. 会计准则自动识别：基于公司所在国家自动检测并应用对应会计准则（IFRS/US GAAP/Ind-AS/UK GAAP等），包括数字格式、负数显示、日期格式及报表标题本地化。

潜在局限

1. 依赖预配置环境：必须预先设置Python虚拟环境及.env凭证文件，安装脚本需手动执行，对非技术用户有一定门槛。

2. 个人开发者维护：来源可信度T3级别，由GitHub个人账号维护，非企业级支持，需关注长期维护活跃度。

3. 审计日志待完善：当前缺乏操作审计日志功能，对合规要求严格的场景需额外开发。

4. SSL验证选项风险：提供--insecure选项用于内部环境调试，存在潜在误用风险。

适合人群

• 使用Odoo ERP的中小企业财务团队
• 需要快速生成投资者/管理层报告的高管
• 销售管理者需追踪团队绩效
• 注重数据隐私、要求本地化处理的企业

常规风险

• 需确保.env文件权限安全，避免凭证泄露
• 建议生产环境使用API Key而非主密码
• 多公司场景需人工确认目标公司，避免数据混淆
• 定期审查依赖库CVE漏洞