pap_web/.kiro/steering/project.md

北京维康慈善基金会官网项目

项目概述

这是北京维康慈善基金会官方网站项目，基于 ThinkJS 3.x 框架开发。项目包含前台官网展示和后台管理系统两部分。

技术栈

• 后端框架：ThinkJS 3.x (Node.js)
• 模板引擎：Nunjucks
• 数据库：MySQL
• 缓存：文件缓存 (think-cache-file)
• 会话：文件会话 (think-session-file)
• 进程管理：PM2

项目结构

pap_web/
├── src/
│   ├── bootstrap/     # 启动配置 (master/worker)
│   ├── config/        # 配置文件
│   │   ├── adapter.js      # 适配器配置
│   │   ├── config.js       # 基础配置
│   │   ├── middleware.js   # 中间件配置
│   │   └── router.js       # 路由配置
│   ├── controller/    # 控制器
│   ├── logic/         # 逻辑层 (参数校验)
│   └── model/         # 数据模型
├── view/              # 视图模板 (Nunjucks)
├── www/static/        # 静态资源
└── runtime/           # 运行时文件

原型参考

项目原型位于 pap_web_pm 目录：

• pap_web_pm/web/ - 前台官网原型
• pap_web_pm/admin/ - 后台管理原型

功能模块

前台官网

栏目	子栏目
首页	Banner轮播、数据看板、药品援助公示、公益项目、新闻动态、合作伙伴
关于我们	基金会简介、组织架构、理事会&监事、资质证书、联系我们
公益项目	妇幼健康促进、“安心医"患者关爱、卫生健康促进、医疗科普公益、品牌建设与传播
党建专栏	党建规章、党建活动、党建学习
信息公示	管理制度、机构年报、审计报告、财务报告、关联方信息、项目执行报告
新闻中心	基金会动态、行业资讯、通知公告
联系我们	基本信息、关注我们、人才招聘、志愿者中心、合作申请

后台管理

• 控制台 (Dashboard)
• 内容管理 (文章、图片、文本、页面、人员)
• 数据管理 (药品援助记录、捐赠数据)
• 系统设置 (栏目管理、网站配置、用户管理、角色权限、操作日志)

内容类型映射

类型	说明	管理页面
article	文章内容	article-list.html
image	图片内容	image-list.html
text	文本/文档	text-list.html
page	单页内容	page-manage.html
person	人员信息	person-list.html
form	表单数据	form-data.html
donation	捐赠数据	donation.html
job	招聘信息	job-manage.html

开发规范

前端组件规范 (Element Plus + Vue 3)

• el-table-column 必须使用完整闭合标签，不能使用自闭合：
  • 正确：<el-table-column prop="id" label="ID" width="60"></el-table-column>
  • 错误：<el-table-column prop="id" label="ID" width="60" />
• Vue 3 使用 CDN 引入时，delimiters 设置为 ['${', '}'] 避免与 Nunjucks 冲突
• Element Plus 组件使用 ElementPlus.ElMessage 和 ElementPlus.ElMessageBox

路由规范

• 前端页面跳转 (window.location.href、<a href>) 加 .html 后缀，如 /admin/login.html、/admin/dashboard.html
• 后端 this.redirect() 也加 .html 后缀
• router.js 路由配置不加 .html
• API 接口路径不加后缀，如 /admin/auth/login

命名约定

• Controller: 小写，如 index.js
• Model: 小写，如 article.js
• View: {controller}_{action}.html，如 index_index.html
• 路由: RESTful 风格

代码风格

• 使用 ESLint 进行代码检查
• 运行 npm run lint 检查代码
• 运行 npm run lint-fix 自动修复

常用命令

# 开发环境启动
npm start

# 代码检查
npm run lint

# 生产环境部署
pm2 startOrReload pm2.json

数据库设计建议

核心表

• column - 栏目表
• article - 文章表
• image - 图片表
• page - 单页表
• person - 人员表
• donation - 捐赠记录表
• medicine_aid - 药品援助记录表
• job - 招聘信息表
• form_data - 表单提交数据表
• user - 管理员用户表
• role - 角色表
• log - 操作日志表
• config - 网站配置表

通用字段规范

• is_deleted: 软删除 (0=正常, 1=已删除)
• status: 状态 (1=启用, 0=停用)
• create_by/update_by: 创建人/修改人ID
• create_time/update_time: 创建/更新时间
• JSON字段存储多选值 (如 disease_ids, delivery_methods)
• 生成的sql文件放到sql文件夹

注意事项

1. 所有涉及金额的字段使用 DECIMAL 类型
2. 患者姓名等敏感信息需脱敏处理显示
3. 图片上传需限制大小和格式
4. 后台操作需记录日志
5. 前台页面需考虑 SEO 优化

生成说明

• 无特殊要求，请使用中文回复
• 无特殊要求，不要生成说明文档