# acs

**Repository Path**: john-code/acs

## Basic Information

- **Project Name**: acs
- **Description**: 访问控制系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-07
- **Last Updated**: 2025-11-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ACS 项目文档

## 项目简介

ACS 项目是一个基于 Spring Boot 和 Dubbo 的微服务架构系统，包含多个模块，实现了用户服务、权限服务、角色管理等功能。该项目适用于需要分布式服务架构的企业级应用开发。

## 模块介绍

- **acs-core**: 主模块，包含启动类和核心控制逻辑。
- **common-api**: 提供公共模型和接口定义，如用户模型、权限模型、角色模型等。
- **common-tool**: 工具类模块，包含结果封装类和错误码定义。
- **permissionservice**: 权限服务模块，提供基于 Redis 的缓存操作。
- **userserivce**: 用户服务模块，实现用户信息查询功能。

## 功能特性

- 基于 Dubbo 的服务注册与发现
- RESTful API 设计
- 用户、权限、角色模型定义
- Redis 缓存支持
- 统一的结果返回格式和错误码处理

## 安装指南

### 环境要求

- Java 8 或以上版本
- Maven 3.x
- Redis（用于权限服务）

### 构建步骤

1. 克隆项目：
   ```bash
   git clone https://gitee.com/john-code/acs.git
   ```

2. 进入项目目录：
   ```bash
   cd acs
   ```

3. 构建项目：
   ```bash
   mvn clean install
   ```

4. 启动各个模块：
   - `acs-core`: 启动主应用
   - `userserivce`: 启动用户服务
   - `permissionservice`: 启动权限服务

## 使用说明

### 启动服务

1. 启动用户服务：
   ```bash
   java -jar userserivce/target/userserivce-*.jar
   ```

2. 启动权限服务（可选）：
   ```bash
   java -jar permissionservice/target/permissionservice-*.jar
   ```

3. 启动主应用：
   ```bash
   java -jar acs-core/target/acs-core-*.jar
   ```

### API 示例

#### 查询用户信息

- **URL**: `/asc/user/queryByUid`
- **方法**: GET
- **参数**: `userId`（用户 ID）

#### 获取 Redis 缓存数据

- **URL**: `/redis/get`
- **方法**: GET
- **参数**: `key`（缓存键）

#### 设置 Redis 缓存数据

- **URL**: `/redis/set`
- **方法**: GET
- **参数**: 
  - `key`（缓存键）
  - `value`（缓存值）

## 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 项目
2. 创建新分支 (`git checkout -b feature/your-feature`)
3. 提交更改 (`git commit -am 'Add some feature'`)
4. 推送分支 (`git push origin feature/your-feature`)
5. 创建 Pull Request

## 许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。