licitarium-free

Licitarium是一款面向Windows的计算机软件，它在机关于本地的机器上镜像巴西公共采购全国门户（PNCP）发布的市政信息，汇聚招标与公告、合同、价格登记议定书、年度采购计划（PCA）及每项采购的单价与中标供应商等数据。典藏资料可离线永久检索——这解决了在PNCP门户逐案查询历史的需求，该门户既不支持搜索也无法离线使用。试点运行于圣保罗州Orindiúva市镇，代码层面不与任何特定市镇绑定。 典藏与界面 界面包含五个带搜索功能的标签页：支持按年份、方式、状态和机关筛选，点击列头排序，列宽可调，并可导出为.xlsx格式，包括：采购（第14.133号法律项下各类方式的招标与公告）、合同（含供应商、总价值、期限及"有效/60天内到期/已结案"状态标记）、议定书（含标的与期限及相同状态标记）、PCA（各机关的计划条目）以及价格（按item搜索、含中位数/四分位数的统计摘要与异常值提醒、附理由的保留或剔除选项，以及参考市镇）。单击行可展开完整详情，含PNCP原始JSON记录与直达官方流程的链接。主屏幕显示三个可点击指标（采购总数、当年核准金额、有效合同数）以及60天内到期提醒和待处理报价提醒。 PCA拟定模块 PCA模块利用已签约条目历史为下一年度计划提供建议：按描述词根将相似条目归组（去除官僚前缀），并将词根不同但描述高度重叠的组合并；在预测前以央行IPCA指数序列校正金额；按均值、上年数值、最高值、总和或线性回归趋势预测数量；按中位数、均值、最新价或最低价估算单价；应用可逐项编辑的10%标准安全边际；进行ABC曲线分类并按族汇总；并标记分歧机关、单一出现条目、价格分散条目、已有有效议定书覆盖的条目以及与上年度计划偏差。支持合并与拆分组别，按量加权定价，并在新版本生成时保留人工修改成果。输出为供人工审阅的草案文本，而非可直接导入的文件格式。 报告 系统提供八种带信头的HTML报告（可直接打印为PDF），并在适用时同时生成.xlsx版本：采购明细、合同明细、议定书明细、年度执行摘要、拆分采购预警（自动内控，按标的相似性归组并追踪第75条限额，可按年度或滑动周期设定窗口）、PCA草案及价格调研（为第23条提供支持）。无论选择何种主题，打印输出始终清晰易读。 同步与运行 首次启动时用户选择市镇（内嵌IBGE 5,571个市镇的表格），程序自2021年起下载已发布的历史数据。每次打开时仅同步变更内容，距上次采集至少间隔10分钟；点击"同步"按钮则强制采集。市镇各机关从采购记录中自动发现，也可通过CNPJ手动添加。数据存放于本地SQLite数据库（路径为%LOCALAPPDATA%\Licitarium），作为可重建的缓存。无网络时程序以本地数据照常打开，并提示未更新。README记载，试点库的同步耗时33秒（共69次门户查询），采用三阶段并行，仅对变更条目重新请求。若门户故障，客户端最多重试五次，等待时间递增（30至90秒），随机化重试间隔，过载时减少并发连接；失败记录将在下次采集时重试。 仪表板 主屏幕以四视图（执行、分析、监督与节约）汇总当年情况，各视图上方显示可跳转至已过滤列表的警报。图表为程序自行绘制的SVG图形，无外部库依赖、无需联网，配色经确认适用于色盲与高对比度场景，支持A3横向打印。README指出，供给四视图的查询在114MB典藏（3,360笔采购、约2.5万条目）上耗时约120毫秒，窗口大小变化时图表会重绘。 隐私 程序仅读取PNCP公开数据：不上传计算机信息，无遥测，无需用户账户，不开放网络端口。唯一的出站连接对象为pncp.gov.br及用于检查新版GitHub的公开API。 安装与架构 推荐安装方式是从releases页面下载可执行文件，免安装、无需Python、无需管理员权限。README提示SmartScreen可能因文件为新签且未签名而发出警告；Windows 11的Smart App Control会拦截未签名二进制文件，此时自动更新功能被禁用。备选方案为从源码运行：pip install -r requirements.txt && python licitarium.py，要求Windows 10/11与WebView2。外部依赖仅pywebview、openpyxl和motor_pncp，其余均使用Python标准库，指定Python版本为3.12。架构为单进程模式：pywebview/WebView2窗口通过js_api桥接与Python通信，无HTTP服务器、无端口、无防火墙规则。每条记录的原始JSON作为事实来源保存，数据库列为其投影。仓库包含licitarium.py、pncp.py、pca_builder.py、relatorios.py，ui/目录下含四种data-theme主题及内置字体，tests/目录含pytest单元测试（HTTP模拟），tests-e2e/目录含Playwright接口测试，另附DESIGN.md、design/IDENTIDADE.md与design/DASHBOARD.md文档。CI在每次push时在Windows上运行Python与接口测试；标注v*标签后通过PyInstaller编译可执行文件并附加至release。在设置中，"保存副本"与"恢复副本"可将整个典藏打包为.zip并校验完整性，同时保留原数据库。 作者与许可 采用MIT许可证（© 2026 Túlio Ribeiro de Moura e Silva）。每个版本均在Zenodo获取DOI，README中附有引用建议。展示数据源自PNCP公开信息，符合第14.133/2021号法律与信息公开法规定。项目声明非PNCP或联邦政府官方产品。