このプロジェクトについて
LicitariumはWindows向けのコンピュータプログラムであり、自治体がPNCP(Portal Nacional de Contratações Públicas)で公開する内容を機関のマシン上にミラーリングする。調達(入札公告および notices)、契約、価格記録表(atas de registro de preços)、年次調達計画(PCA)、各購入の品目、単価、落札事業者を一元的に収集する。アーカイブは検索可能でオフラインかつ永続的に保管され、ポータルでプロセスごとの履歴を参照する必要性を解決する——同ポータルは検索不可であり、インターネット接続なしでは利用できない。パイロット版はOrindiúva-SPで稼働しており、コード上に自治体に依存した固定項は一切ない。
アーカイブとインターフェース
インターフェースは検索、年度・modalidade・状況・organで絞り込み、クリックで並べ替え、列の幅調整、.xlsx形式でのエクスポートを備えた5つのタブを持つ。タブは「Contratações」(Lei 14.133に基づくmodalidadesの入札公告および notices)、「Contratos」(業者・合計金額・存続期間・状態バッジ:存続中/60日以内期限/終了)、「Atas」(対象・存続期間、同バッジ)、「PCA」(各機関の計画品目)、「Preços」(品目で検索、中央値・四分位・外れ値アラートなど統計要約、選択・理由付き削除、参考自治体)である。行をクリックするとPNCP記載のJSON統合データと公式手続きへの直接リンクを含む詳細が開く。メイン画面には3つのクリック可能な指標(調達総数・当年の承認金額・存続契約)と、60日以内の期限切れ・オープンな提案に対するアラートが表示される。
PCAの組み立て
PCAモジュールは既に調達済みの品目の履歴を用いて翌年分の計画を提案する。説明の接尾辞を除去して類似品目をラディカル(語根)で分類し、異なるラディカルでも説明が大幅に重複するグループを統合する。試算前にBanco CentralのIPCA系列で値を補正し、数量は平均・最終年・最大値・合計・線形回帰によるトレンドで投影する。価格は中央値・平均・直近値・最低値から推定し、各品目で編集可能な標準の安全マージン10%を適用する。ABC分類を行いファミリーでグループ化する。また、偏った単位・単発発生・価格分散・存続中の ata で既にカバーされている品目・前年計画からの変化を警告する。グループの結合・分割が可能で、価格は量加重され、手動調整は新規生成時に保持される。納品物は人的レビュー向けの草案であり、インポート用ファイルではない。
レポート
HTML刷込(PDF印刷準備完了)および必要に応じて.xlsxの8種類のレポートが用意される:調達一覧、契約一覧、記録表一覧、年次エグゼクティブサマリー、Fracionamento アラート(対象の類似性で無制限調達をグループ化し art. 75 の限界を追跡する自己統制モジュールで、年度または移動期間窓を持つ)、PCA草案、以及 Pesquisa de Preços(art. 23 への支持資料)。印刷は画面で選択されたテーマに関わらず常に明瞭に出力される。
同期と運用
初回実行時にユーザーが自治体を選択する(5,571のmunicípioを内包するIBGEテーブルにより)。プログラムは2021年以降に公開された履歴をダウンロードする。毎回放開時は最後に10分間の間隔を置き、変更分のみ同期し、[Sincronizar] ボタンは常時収集を行う。自治体の organ は調達から自動的に検出され、CNPJ で追加できる。データは %LOCALAPPDATA%\Licitarium 内のローカルSQLiteデータベースに保存され、再構築可能なキャッシュとして扱う。インターネットなしでもローカルデータで起動し、更新されていないことを警告する。README によれば、パイロット版アーカイブの同期は33秒・69回のポータル照会・並列3フェーズ・変更された品目のみ再照会で完了した。ポータル故障時、クライアントは30〜90秒の増加間隔で5回まで試行し、試行間隔をランダム化し、過負荷時に同時接続を削減する。失敗は記録され次回収集で再現される。
ダッシュボード
メイン画面はExecução・Análise・Vigilância・Economia の4つの視点で年度をまとめ、その上部のアラートが既に絞り込まれたリストへ誘導する。グラフはSVG で本プログラム自身によって描画され、外部ライブラリやネットワークを使用せず、色覚多様性・コントラストで検証済みとされるパレットを採用し、A3横印刷も可能。README によれば4つの視点を支える照会は114 MB(3,360 調達・25,000 品目)アーカイブで約120 msを要し、ウィンドウサイズ変化時にグラフは再描画される。
プライバシー
プログラムはPNCP の公開データを読み取るのみで、コンピュータのデータを一切送信せず、テレメトリやユーザーアカウントも存在しない。ネットワークの出口敞口を開かない。 outbound 接続は pncp.gov.br および新バージョンを確認するためのGitHub公開APIのみ。
インストールとアーキテクチャ
推奨経路は releases ページの.exe で、インストーラ不要・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 を真のソースとして保存し、DB の列はその投影である。リポジトリには licitarium.py・pncp.py・pca_builder.py・relatorios.py、ui/ ディレクトリ内の4テーマ(data-theme 対応・ベンダーフォント付き)のインターフェースファイル、pytest と HTTP mock を用いた tests/、Playwright による tests-e2e/、DESIGN.md・design/IDENTIDADE.md・design/DASHBOARD.md が含まれる。CI は push 毎にWindows 上でPythonテストとインターフェーステストを実行し、v* タグ付け時に PyInstaller で実行可能ファイルをビルドして release に添付する。設定画面の[Salvar cópia...]・[Restaurar cópia...]でアーカイブ全体を.zip にバックアップ・復元でき、ファイル整合性を確認して既存DBを保持する。
著作者とライセンス
ライセンスは MIT(© 2026 Túlio Ribeiro de Moura e Silva)。各バージョンはZenodo で DOI を取得し、README によりまする引用が推奨される。表示データは Lei 14.133/2021 および Lei de Acesso à Informação に基づくPNCP 由来の公開データであり、本プロジェクトがPNCP または Governo Federal の公式産物ではないことを宣言する。
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.