PINF_MANAGEMENT/docs/PROJECT_OVERVIEW.md

项目说明（当前仓库）

项目定位

• 本仓库提供 App 端后端 API 与 RN 客户端基础工程。
• 后台管理系统将单独开发，不在本仓库实现前端。

仓库结构

• backend/：Flask API 服务
• WA/：React Native Expo 客户端工程
• wechat_end/：已弃用小程序代码，仅存档
• app_end/、web_end/：当前为空壳或未启用
• docx/：产品与开发文档

后端概览

技术栈

• Flask 2.3.x
• Flask-JWT-Extended
• Flask-SQLAlchemy
• Flask-CORS

入口与路由

• 入口：backend/app.py
• 路由：backend/routes/*
• 模型：backend/models/*
• 工具：backend/utils/*

主要模块

• 认证：手机验证码登录、密码登录、设置密码、更新昵称
• 宝宝：CRUD
• 成长记录：CRUD
• 预约：CRUD
• 内容：视频/文章列表与详情（只读）
• 聊天：转发 n8n，历史记录管理

前端概览（WA）

• React Native Expo + TypeScript
• 已落地通用 UI 组件、主题体系、Axios 封装、导航与状态管理
• 详细进度参见 docx/REFACTOR_PLAN.md 与 docx/FRAMEWORK_SETUP.md

环境变量

后端必要配置：

• DATABASE_URL
• SECRET_KEY
• JWT_SECRET_KEY 可选配置：
• N8N_WEBHOOK_URL
• WECHAT_APP_ID
• WECHAT_APP_SECRET
• CONTENT_SEED（设置为 1 时注入本地示例内容）

本地运行

后端

cd backend
python app.py

默认端口：http://localhost:5010

客户端（WA）

cd WA
npm install
npm start

约束与限制

• 当前无管理员权限与跨用户管理接口。
• 内容模块仅支持读取，不支持新增/编辑/删除。
• 未配置软删除与审计日志。
• 聊天模块依赖 n8n webhook，未配置时会返回错误。