ivan-borovets/fastapi-clean-example：用FastAPI构建的实用清洁架构后端示例

项目介绍

ivan-borovets/fastapi-clean-example 是一个托管在 GitHub 上的开源项目，主要使用 Python 编写，采用 MIT License 许可证，目前获得 598 个 Star、84 次 Fork。

仓库全名: ivan-borovets/fastapi-clean-example

README 摘要

Stay tuned. Refactor in progress, see legacy-2025 branch for architecture docs TODO: [x] Write tests [ ] Explain code and patterns in new README [ ] Make template project Prerequisites Start in Docker Start locally Full API access: create user via sign up set its role to superadmin manually in DB log in as super admin Stop Test (light paths) Test (all paths) Generate a migration See Makefile for more commands Thanks…

完整内容见 GitHub 原始 README 或本页。

常见问题

fastapi-clean-example 用什么语言开发？

主要使用 Python 编写，采用 MIT License 许可证，目前有 598 个 Star。

fastapi-clean-example 可以免费商用吗？

如何获取 fastapi-clean-example 的源码？

可以直接克隆仓库：git clone https://github.com/ivan-borovets/fastapi-clean-example.git，默认分支为 master；安装与运行步骤见仓库 README。

fastapi-clean-example 最近还在维护吗？

仓库最近一次更新为 2 周前，当前没有未关闭的 Issue；Star 数为 598，可作为社区活跃度的参考。

关于

GitHub 原始描述（英文）

Practical Clean Architecture backend example built with FastAPI. No stateful globals (DI), low coupling (DIP), tactical DDD, CQRS, proper UoW usage. REST API, per-route error handling, session-based auth, contextual RBAC. Bundled with extensive docs and modern tooling

MIT License
598 Stars
84 Forks
6 Watching

描述取自 GitHub 官方 API，保持仓库作者书写的原文。

简要分析

热度分

772

价值分

384

活跃状态

活跃

GitHub

语言占比

Dockerfile

Makefile

Mako

Python

Shell

贡献者

ivan-borovets

Stay tuned. Refactor in progress, see legacy-2025 branch for architecture docs

TODO:

Write tests
Explain code and patterns in new README
Make template project

Prerequisites

uv sync
source .venv/bin/activate
prek install --overwrite --hook-type pre-commit --hook-type pre-push

Start in Docker

make upd

Start locally

make upd-local
alembic upgrade head
uvicorn app.main.run:make_app --factory --host 0.0.0.0 --port 8000 --reload
# or `src/app/main/run.py` in IDE

Full API access:

create user via sign up
set its role to super_admin manually in DB
log in as super admin

Stop

make down

Test (light paths)

make check

Test (all paths)

make test-docker

Generate a migration

make migration msg=<msg>

See Makefile for more commands

Thanks for your patience and support

Acknowledgements

暂无评论

fastapi-clean-example

项目介绍

README 摘要

常见问题

相关仓库

关于

简要分析

语言占比

贡献者

评论