feat: add FastAPI backend with PostgreSQL and start script fixes
- Add server/ directory with FastAPI backend - Fix server/start.sh to properly handle venv on Windows/Git Bash - Add alembic migrations and pyproject.toml - Add server tests Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
92
server/src/x_financial_server.egg-info/PKG-INFO
Normal file
92
server/src/x_financial_server.egg-info/PKG-INFO
Normal file
@@ -0,0 +1,92 @@
|
||||
Metadata-Version: 2.4
|
||||
Name: x-financial-server
|
||||
Version: 0.1.0
|
||||
Summary: Backend service for X-Financial reimbursement and approval platform.
|
||||
Requires-Python: >=3.11
|
||||
Description-Content-Type: text/markdown
|
||||
Requires-Dist: fastapi<1.0.0,>=0.115.0
|
||||
Requires-Dist: uvicorn[standard]<1.0.0,>=0.30.0
|
||||
Requires-Dist: sqlalchemy<3.0.0,>=2.0.36
|
||||
Requires-Dist: alembic<2.0.0,>=1.14.0
|
||||
Requires-Dist: psycopg[binary]<4.0.0,>=3.2.0
|
||||
Requires-Dist: pydantic-settings<3.0.0,>=2.6.0
|
||||
Requires-Dist: python-dotenv<2.0.0,>=1.0.1
|
||||
Requires-Dist: email-validator<3.0.0,>=2.2.0
|
||||
Provides-Extra: dev
|
||||
Requires-Dist: pytest<9.0.0,>=8.3.0; extra == "dev"
|
||||
Requires-Dist: httpx<1.0.0,>=0.28.0; extra == "dev"
|
||||
Requires-Dist: ruff<1.0.0,>=0.8.0; extra == "dev"
|
||||
Provides-Extra: redis
|
||||
Requires-Dist: redis<6.0.0,>=5.2.0; extra == "redis"
|
||||
|
||||
# Server
|
||||
|
||||
后端已按 `FastAPI + PostgreSQL + SQLAlchemy + Alembic` 起好基础工程。
|
||||
|
||||
## 为什么先选 PostgreSQL
|
||||
|
||||
这个项目是报销、审批、员工、流程、审计记录为主,核心特点是:
|
||||
|
||||
- 强事务
|
||||
- 多表关联明显
|
||||
- 审批流和审计日志需要一致性
|
||||
- 后续大概率要做复杂查询、统计和条件筛选
|
||||
|
||||
这类系统优先选关系型数据库更合适,`PostgreSQL` 是当前默认推荐。
|
||||
|
||||
## Redis 要不要现在上
|
||||
|
||||
现在 **不是必须**。
|
||||
|
||||
先不把 Redis 作为启动前置,原因很直接:
|
||||
|
||||
- 当前第一阶段先把核心业务表、接口、权限、审批流跑通
|
||||
- 如果一开始就把 Redis 绑死,会增加部署和排障复杂度
|
||||
|
||||
Redis 更适合后面这些场景:
|
||||
|
||||
- 登录态 / token 黑名单
|
||||
- 热点数据缓存
|
||||
- 限流
|
||||
- 分布式锁
|
||||
- 消息队列 / 后台任务
|
||||
|
||||
所以现在的策略是:
|
||||
|
||||
- 主数据库:`PostgreSQL`
|
||||
- Redis:`可选能力`,配置已预留,但不是必需依赖
|
||||
|
||||
## 目录
|
||||
|
||||
- `src/app/`:应用代码
|
||||
- `alembic/`:数据库迁移
|
||||
- `tests/`:测试
|
||||
|
||||
## 启动
|
||||
|
||||
1. 创建虚拟环境并安装依赖
|
||||
|
||||
```bash
|
||||
cd server
|
||||
python -m venv .venv
|
||||
.venv\\Scripts\\activate
|
||||
pip install -e .[dev]
|
||||
```
|
||||
|
||||
2. 在项目根目录准备环境变量
|
||||
|
||||
```bash
|
||||
copy ..\\.env.example ..\\.env
|
||||
```
|
||||
|
||||
3. 启动服务
|
||||
|
||||
```bash
|
||||
uvicorn app.main:app --reload --app-dir src
|
||||
```
|
||||
|
||||
## 迁移
|
||||
|
||||
```bash
|
||||
alembic upgrade head
|
||||
```
|
||||
41
server/src/x_financial_server.egg-info/SOURCES.txt
Normal file
41
server/src/x_financial_server.egg-info/SOURCES.txt
Normal file
@@ -0,0 +1,41 @@
|
||||
README.md
|
||||
pyproject.toml
|
||||
src/app/__init__.py
|
||||
src/app/main.py
|
||||
src/app/api/__init__.py
|
||||
src/app/api/deps.py
|
||||
src/app/api/router.py
|
||||
src/app/api/v1/__init__.py
|
||||
src/app/api/v1/router.py
|
||||
src/app/api/v1/endpoints/__init__.py
|
||||
src/app/api/v1/endpoints/bootstrap.py
|
||||
src/app/api/v1/endpoints/employees.py
|
||||
src/app/api/v1/endpoints/health.py
|
||||
src/app/api/v1/endpoints/reimbursements.py
|
||||
src/app/core/__init__.py
|
||||
src/app/core/bootstrap.py
|
||||
src/app/core/config.py
|
||||
src/app/db/__init__.py
|
||||
src/app/db/base.py
|
||||
src/app/db/base_class.py
|
||||
src/app/db/session.py
|
||||
src/app/models/__init__.py
|
||||
src/app/models/approval.py
|
||||
src/app/models/employee.py
|
||||
src/app/models/reimbursement.py
|
||||
src/app/repositories/__init__.py
|
||||
src/app/repositories/employee.py
|
||||
src/app/repositories/reimbursement.py
|
||||
src/app/schemas/__init__.py
|
||||
src/app/schemas/bootstrap.py
|
||||
src/app/schemas/employee.py
|
||||
src/app/schemas/reimbursement.py
|
||||
src/app/services/__init__.py
|
||||
src/app/services/employee.py
|
||||
src/app/services/reimbursement.py
|
||||
src/x_financial_server.egg-info/PKG-INFO
|
||||
src/x_financial_server.egg-info/SOURCES.txt
|
||||
src/x_financial_server.egg-info/dependency_links.txt
|
||||
src/x_financial_server.egg-info/requires.txt
|
||||
src/x_financial_server.egg-info/top_level.txt
|
||||
tests/test_imports.py
|
||||
@@ -0,0 +1 @@
|
||||
|
||||
16
server/src/x_financial_server.egg-info/requires.txt
Normal file
16
server/src/x_financial_server.egg-info/requires.txt
Normal file
@@ -0,0 +1,16 @@
|
||||
fastapi<1.0.0,>=0.115.0
|
||||
uvicorn[standard]<1.0.0,>=0.30.0
|
||||
sqlalchemy<3.0.0,>=2.0.36
|
||||
alembic<2.0.0,>=1.14.0
|
||||
psycopg[binary]<4.0.0,>=3.2.0
|
||||
pydantic-settings<3.0.0,>=2.6.0
|
||||
python-dotenv<2.0.0,>=1.0.1
|
||||
email-validator<3.0.0,>=2.2.0
|
||||
|
||||
[dev]
|
||||
pytest<9.0.0,>=8.3.0
|
||||
httpx<1.0.0,>=0.28.0
|
||||
ruff<1.0.0,>=0.8.0
|
||||
|
||||
[redis]
|
||||
redis<6.0.0,>=5.2.0
|
||||
1
server/src/x_financial_server.egg-info/top_level.txt
Normal file
1
server/src/x_financial_server.egg-info/top_level.txt
Normal file
@@ -0,0 +1 @@
|
||||
app
|
||||
Reference in New Issue
Block a user