按照已经确认的开发规范,本阶段先完成详细设计,再创建文件和编写代码。不会一次性生成整套系统。
第一阶段:系统基础架构
当前阶段:详细设计
一、第一阶段建设目标
本阶段只建立系统运行所需的基础框架,不提前开发服务商管理、AI 调用、推荐匹配等业务功能。
需要建立以下基础能力:
-
系统统一入口。
-
系统初始化机制。
-
配置文件加载机制。
-
请求处理机制。
-
控制器调用机制。
-
统一异常处理机制。
-
基础安全机制。
二、第一阶段文件设计
计划创建以下文件:
| 文件 | 职责 |
|---|---|
public/index.php |
前台统一入口 |
admin/index.php |
后台统一入口 |
app/bootstrap.php |
系统初始化 |
app/helpers/Config.php |
配置加载 |
app/helpers/Request.php |
HTTP 请求信息处理 |
app/helpers/Response.php |
统一响应处理 |
app/helpers/Router.php |
请求路由分发 |
app/helpers/SystemLogger.php |
系统异常及运行日志 |
config/app.php |
基础系统配置 |
这些文件目前只是设计清单,尚未创建。
三、文件调用关系
四、代码设计约束
-
兼容 PHP 7.0.10。
-
使用原生 PHP,不使用 Smarty。
-
使用 PHP 类组织基础功能。
-
不依赖 Composer。
-
不引入未经确认的第三方框架。
-
配置与业务代码分离。
-
前后台入口分别管理。
-
不在入口文件中堆积业务代码。
-
错误日志写入
storage/logs/。 -
不向普通用户直接暴露服务器内部错误。
-
不在本阶段连接数据库或调用 AI API。
五、实施与验收
本阶段拆分为五个小步骤:
| 步骤 | 实施内容 | 验收标准 |
|---|---|---|
| 1 | 配置加载机制 | 能够按设计读取配置 |
| 2 | 系统初始化机制 | 初始化顺序明确 |
| 3 | 请求与响应机制 | 请求信息和响应格式统一 |
| 4 | 路由分发机制 | 能够正确分发请求 |
| 5 | 前后台入口 | 两个入口能够加载系统框架 |
每完成一个步骤,进行 PHP 语法检查,之后上传服务器进行实际验证。
六、现在需要确认一个部署结构问题
这关系到前后台入口路径和项目安全,必须先确定。
你的服务器准备采用哪种网站目录设置?
A: 将网站运行目录直接设置为:
AICommercialService/public/
B: 将网站运行目录设置为:
AICommercialService/
如果使用 B,必须额外保护 app、config、database、storage 等内部目录,避免被外部直接访问。
我倾向于 A,让 public 成为唯一公开目录,安全边界更清晰。
请确认 A 或 B。确认后就开始第一个实际开发步骤:配置加载机制。
