-
Clean Architecture 与 Hexagonal 的差异与实践指南
Clean Architecture 和 Hexagonal Architecture 常常被放在一起讨论,结果很多人看完文档还是面对同样的问题: 概念都懂了,可是实战里到底有什么差异?我这个项目应该按哪一套来拆? 如果你已经用 FastAPI 搭过一圈服务,现在开始认真思考 目录如何分层、Use Case 怎么落... Read More
-
Geoserver 单点登录配置
GeoServer 自带的账号体系在小规模使用场景下其实已经够用,但一旦进入生产环境,账号分散、权限分散就会带来数据安全和审计上的风险。 如果你的系统里已经有了 Keycloak 这类统一身份认证平台,把 GeoServer 納入同一套认证与授权体系,会更利于集中管理访问权限、降低泄露风险、做好安全审计。 这篇教程... Read More
-
Nextcloud OSS 存储配置指南
这篇文档带你一步步把阿里云 OSS 接入到 Nextcloud,覆盖三种常见方式: 通过 External Storage 插件,把 OSS Bucket 挂成一个目录 把 OSS 配置成主存储(Primary Storage) 用 ossfs 挂载到本地,再由 Nextcloud 访问(不推荐,只做补... Read More
-
Clean Architecture 在 FastAPI 中的实践指南
在写后台项目的时候,你可能会发现一个规律:业务量越做越大,代码越写越乱。 尤其当用户模块、商品模块、评价模块扯在一起,各自都要查彼此的数据,没几个月整个项目就会变成“互相 import 大乱炖”。 Clean Architecture 正好帮我们解决这个困局。它把业务逻辑和技术细节严格隔开,让项目越做越大,但不会越做越乱。... Read More
-
陌生代码快速上手指南
大部分时候,我们接手的都不是“从零开始写”的项目,而是别人已经折腾了好几年的代码库:README 半旧不新,目录层层嵌套,类名函数名一个比一个抽象。 这个时候,如果只是本能地打开 src/ 乱点一通,很容易一下午过去,只留下一个模糊印象——“好复杂”“以后再看”。 下面这篇小册子,想做的就是给这种场景准备一... Read More
-
在 Starlette / FastAPI 集成 APScheduler
在 Web 服务里跑一些定时任务(比如每分钟拉一次数据、定时清理缓存),又不想单独开一个脚本, 就可以把 APScheduler 嵌进 Starlette / FastAPI 里,随应用一起启动和停止。 核心思路 用 AsyncIOScheduler 管理任务(和 Starlette/FastAPI 的 asyncio 世界... Read More
-
Python 多线程并行下载代码模板
这个脚本是一个方便复用的并行下载模板,适合从目录页里批量把文件拉到本地。 以下是完整的代码: import os import queue import requests import threading from bs4 import BeautifulSoup def parse_html(html): datas = {} soup = Beaut... Read More
-
风光新能源项目规划流程技术说明
本文梳理了风电和光伏(下称“风光”)项目在不同行政层级(省、市、县)的规划思路和基本流程, 并结合资源工程师的实际工作方式,对规划口径、用地优先级、关键指标定义以及收资要点进行说明。 规划层级与总体思路 风光规划一般分为省级、市级、县级三个层次,整体思路是: 省级做战略盘子 ... Read More