项目作品/Pulpulitiko

GoChiNuxt 3Vue 3PostgreSQLRedisCloudflare R2CloudflareDockerModel Context Protocol (MCP)Tailwind CSS

Pulpulitiko

live · maintained

语言版本：

面向菲律宾的高性能公民情报与政治透明平台,具备深度关系实体图谱、主权债务分析,以及原生Model Context Protocol(MCP)AI集成。

访问网站 ↗

pulpulitiko.com

1 / 8

Cover

Gallery:

Pulpulitiko是一个面向菲律宾的开放式公民情报与政治透明平台。它并非以标准新闻信息流的形式运作,而是以政治人物作为核心关系节点,串联起历届总统政府(1965年至今)与历史主权债务记录、对外贷款事件(世界银行、亚开行、JICA、中国)、年度SALN资产申报,以及机密与情报资金(CIF)。该平台整合了公民讨论区、经过核实的民意调查、社区选民教育,以及"My Representatives"地理定位查找功能。Pulpulitiko还通过内置的Model Context Protocol(MCP)服务器(采用OAuth 2.0与API密钥安全机制)作为AI就绪的公民数据库,使AI代理能够通过结构化的工具调用直接查询政治财务、法案历史与债务指标。

Featured Engineering & Architecture

How the Hardest Problems Were Solved

Key architectural decisions, concrete code implementations, and performance wins behind this project.

Interactive System Topology

Click any node below to inspect its role, tech stack, and engineering implementation.

live_architecture.map

Client / Web UINext.js App Router, Tailwind, TypeScript

Role: Presentation & SSR

Server-side rendered bilingual interface with responsive dark mode and instant navigation.

Engineering Highlights:

▹Zero-JS server components for maximum SEO and fast LCP
▹Dual-language switching (Filipino & English) without page reload
▹Client-side optimistic filtering for politicians and dossiers

Architectureapi/migrations/000024_politicians_center_rewrite.up.sql

以政治人物为中心的关系型架构与历史主权债务

The Challenge

政治报道平台通常将政治人物视为肤浅的文本标签,使当选官员与其任期内产生的系统性债务、对外贷款义务和财政记录相脱节。

The Architectural Solution

重构关系型架构,以政治人物作为核心实体锚定数据库,在主权债务偿还记录(1965年至今)、对外贷款事件和年度资产申报之间强制建立外键关系与索引。

Impact:追踪7届以上总统政府的主权债务,对政治人物状态与政府名称实现亚毫秒级索引扫描。

api/migrations/000024_politicians_center_rewrite.up.sql

-- 1. Extend politicians table

ALTER TABLE politicians

ADD COLUMN IF NOT EXISTS brand_color VARCHAR(20) DEFAULT '#6b7280',

ADD COLUMN IF NOT EXISTS admin_name VARCHAR(100),

ADD COLUMN IF NOT EXISTS legal_status VARCHAR(50) DEFAULT 'active';

CREATE INDEX IF NOT EXISTS idx_politicians_legal_status ON politicians(legal_status);

CREATE INDEX IF NOT EXISTS idx_politicians_admin_name ON politicians(admin_name);

Discuss this snippet (api/migrations/000024_politicians_center_rewrite.up.sql)

Databaseapi/migrations/000029_create_article_entity_links.up.sql

面向多实体新闻报道的多态实体链接引擎

The Challenge

调查性文章经常涉及多种公民实体的组合(政治人物、双边贷款方案、主权债务记录),但缺乏一种高效且不破坏结构的方式来建模任意关系绑定。

The Architectural Solution

构建了带有复合唯一约束和双重B-tree索引的多态关联表,使编辑内容可以动态绑定到任意实体类型,同时防止重复引用。

Impact:消除了按实体类型划分的专用连接表,实现无需架构迁移的即时双向查找。

Backendapi/internal/mcp/server.go

面向AI代理工具调用的内置Model Context Protocol(MCP)服务器

The Challenge

现代外部AI代理(如Claude或自定义研究代理)需要以编程方式、安全且结构化地实时访问平台的公民数据库,而无需抓取HTML或绕过身份验证。

The Architectural Solution

使用mark3labs/mcp-go内置了原生Go语言MCP服务器,具备19个模块化工具注册表,支持stdio与HTTP两种传输方式,并采用符合RFC规范的OAuth 2.0与API密钥安全机制。

Impact:开放涵盖政治财务、法案与民调的19个工具模块,供外部AI代理实现零延迟结构化查询。

Securityapi/internal/services/html_sanitizer.go

双层纵深防御HTML净化

The Challenge

用户生成的评论和富文本政治文章在嵌入第三方媒体或社交iframe时,可能成为XSS攻击和ReDoS漏洞利用的载体。

The Architectural Solution

实施了严格的Go Bluemonday净化策略,限制CSS类、强制长度限制以防范DoS攻击,并在写入数据库前将iframe严格限制在已批准的域名范围内。

Impact:在37项自动化OWASP十大XSS测试中通过率达100%,客户端脚本执行为零。

Seoweb/server/routes/robots.txt.ts

动态多环境robots.txt与SEO引擎

The Challenge

静态robots.txt配置存在风险,可能将非生产的预发布环境暴露给网络爬虫,或在站点地图中索引错误的localhost域名。

The Architectural Solution

构建了服务端渲染的Nuxt 3路由处理器,动态将运行时站点URL注入站点地图指令,应用24小时边缘缓存标头,并阻止爬虫访问管理与身份验证路由。

Impact:在所有部署阶段保护管理与用户身份验证界面的同时,确保100%自动化SEO爬取合规。

// community_discussion

Architecture Feedback & Questions

Have thoughts, questions, or ideas regarding this system's architecture? Leave a comment below with your GitHub account.